@jonit-dev/night-watch-cli 1.8.14-beta.6 → 1.8.15

package/dist/cli.js

@@ -379,6 +379,42 @@ var init_job_registry = __esm({
           targetColumn: "Draft"
         }
       },
+      {
+        id: "ux",
+        name: "UX",
+        description: "Inspects user flows with browser automation and drafts prioritized UX reports",
+        cliCommand: "ux",
+        logName: "ux",
+        lockSuffix: "-ux.lock",
+        queuePriority: 10,
+        envPrefix: "NW_UX",
+        extraFields: [
+          {
+            name: "targetColumn",
+            type: "enum",
+            enumValues: [...BOARD_COLUMNS],
+            defaultValue: "Draft"
+          },
+          { name: "baseUrl", type: "string", defaultValue: "" },
+          { name: "startUrl", type: "string", defaultValue: "" },
+          { name: "flows", type: "string[]", defaultValue: [] },
+          { name: "autoInstallPlaywright", type: "boolean", defaultValue: true },
+          { name: "maxIssues", type: "number", defaultValue: 10 },
+          { name: "reportPrompt", type: "string", defaultValue: "" }
+        ],
+        defaultConfig: {
+          enabled: false,
+          schedule: "0 7 * * 1",
+          maxRuntime: 0,
+          targetColumn: "Draft",
+          baseUrl: "",
+          startUrl: "",
+          flows: [],
+          autoInstallPlaywright: true,
+          maxIssues: 10,
+          reportPrompt: ""
+        }
+      },
       {
         id: "analytics",
         name: "Analytics",
@@ -471,7 +507,7 @@ function resolveProviderBucketKey(provider, providerEnv) {
     return `claude-proxy:${baseUrl}`;
   }
 }
-var DEFAULT_DEFAULT_BRANCH, DEFAULT_PRD_DIR, DEFAULT_SUMMARY_WINDOW_HOURS, DEFAULT_MAX_RUNTIME, DEFAULT_REVIEWER_MAX_RUNTIME, DEFAULT_CRON_SCHEDULE, DEFAULT_REVIEWER_SCHEDULE, DEFAULT_CRON_SCHEDULE_OFFSET, DEFAULT_MAX_RETRIES, DEFAULT_REVIEWER_MAX_RETRIES, DEFAULT_REVIEWER_RETRY_DELAY, DEFAULT_REVIEWER_MAX_PRS_PER_RUN, DEFAULT_FEEDBACK, DEFAULT_BRANCH_PREFIX, DEFAULT_BRANCH_PATTERNS, DEFAULT_MIN_REVIEW_SCORE, DEFAULT_MAX_LOG_SIZE, DEFAULT_PROVIDER, DEFAULT_EXECUTOR_ENABLED, DEFAULT_REVIEWER_ENABLED, DEFAULT_PROVIDER_ENV, DEFAULT_FALLBACK_ON_RATE_LIMIT, DEFAULT_CLAUDE_MODEL, DEFAULT_PRIMARY_FALLBACK_MODEL, DEFAULT_SECONDARY_FALLBACK_MODEL, VALID_CLAUDE_MODELS, CLAUDE_MODEL_IDS, DEFAULT_NOTIFICATIONS, DEFAULT_PRD_PRIORITY, DEFAULT_SLICER_SCHEDULE, DEFAULT_SLICER_MAX_RUNTIME, DEFAULT_ROADMAP_SCANNER, DEFAULT_TEMPLATES_DIR, DEFAULT_BOARD_PROVIDER, DEFAULT_LOCAL_BOARD_INFO, DEFAULT_AUTO_MERGE, DEFAULT_AUTO_MERGE_METHOD, VALID_MERGE_METHODS, DEFAULT_QA_ENABLED, DEFAULT_QA_SCHEDULE, DEFAULT_QA_MAX_RUNTIME, DEFAULT_QA_ARTIFACTS, DEFAULT_QA_SKIP_LABEL, DEFAULT_QA_AUTO_INSTALL_PLAYWRIGHT, DEFAULT_QA_VALIDATED_LABEL, DEFAULT_QA, QA_LOG_NAME, DEFAULT_AUDIT_ENABLED, DEFAULT_AUDIT_SCHEDULE, DEFAULT_AUDIT_MAX_RUNTIME, DEFAULT_AUDIT_CREATE_ISSUES, DEFAULT_AUDIT_TARGET_COLUMN, DEFAULT_AUDIT, DEFAULT_ANALYTICS_ENABLED, DEFAULT_ANALYTICS_SCHEDULE, DEFAULT_ANALYTICS_MAX_RUNTIME, DEFAULT_ANALYTICS_LOOKBACK_DAYS, DEFAULT_ANALYTICS_TARGET_COLUMN, DEFAULT_ANALYTICS_PROMPT, DEFAULT_ANALYTICS, DEFAULT_MANAGER_ENABLED, DEFAULT_MANAGER_SCHEDULE, DEFAULT_MANAGER_MAX_RUNTIME, DEFAULT_MANAGER_AUTHORITY, DEFAULT_MANAGER_OUTPUT_MODE, DEFAULT_MANAGER_TARGET_COLUMN, DEFAULT_MANAGER_MEMORY_PATH, DEFAULT_MANAGER_DOCS_DIR, DEFAULT_MANAGER_WEEKLY_SUMMARY_ENABLED, DEFAULT_MANAGER_WEEKLY_SUMMARY_DAY, DEFAULT_MANAGER, DEFAULT_PR_RESOLVER_ENABLED, DEFAULT_PR_RESOLVER_SCHEDULE, DEFAULT_PR_RESOLVER_MAX_RUNTIME, DEFAULT_PR_RESOLVER_MAX_PRS_PER_RUN, DEFAULT_PR_RESOLVER_PER_PR_TIMEOUT, DEFAULT_PR_RESOLVER_AI_CONFLICT_RESOLUTION, DEFAULT_PR_RESOLVER_AI_REVIEW_RESOLUTION, DEFAULT_PR_RESOLVER_READY_LABEL, DEFAULT_PR_RESOLVER, DEFAULT_MERGER_ENABLED, DEFAULT_MERGER_SCHEDULE, DEFAULT_MERGER_MAX_RUNTIME, DEFAULT_MERGER_MERGE_METHOD, DEFAULT_MERGER_MIN_REVIEW_SCORE, DEFAULT_MERGER_REBASE_BEFORE_MERGE, DEFAULT_MERGER_MAX_PRS_PER_RUN, DEFAULT_MERGER_CI_POLICY, DEFAULT_MERGER_LOCAL_CHECK_COMMAND, DEFAULT_MERGER, MERGER_LOG_NAME, AUDIT_LOG_NAME, PLANNER_LOG_NAME, ANALYTICS_LOG_NAME, PR_RESOLVER_LOG_NAME, MANAGER_LOG_NAME, VALID_PROVIDERS, VALID_JOB_TYPES, DEFAULT_JOB_PROVIDERS, DEFAULT_PROVIDER_SCHEDULE_OVERRIDES, DEFAULT_WEBHOOK_TRIGGER_SECRET_ENV, DEFAULT_WEBHOOK_TRIGGER_MAX_SKEW_SECONDS, DEFAULT_WEBHOOK_TRIGGERS, BUILT_IN_PRESETS, BUILT_IN_PRESET_IDS, PROVIDER_COMMANDS, CONFIG_FILE_NAME, LOCK_FILE_PREFIX, LOG_DIR, CLAIM_FILE_EXTENSION, EXECUTOR_LOG_NAME, REVIEWER_LOG_NAME, EXECUTOR_LOG_FILE, REVIEWER_LOG_FILE, LOG_FILE_NAMES, GLOBAL_CONFIG_DIR, REGISTRY_FILE_NAME, HISTORY_FILE_NAME, PRD_STATES_FILE_NAME, STATE_DB_FILE_NAME, GLOBAL_NOTIFICATIONS_FILE_NAME, MAX_HISTORY_RECORDS_PER_PRD, DEFAULT_QUEUE_ENABLED, DEFAULT_QUEUE_MODE, DEFAULT_QUEUE_MAX_CONCURRENCY, DEFAULT_QUEUE_MAX_WAIT_TIME, DEFAULT_QUEUE_PRIORITY, DEFAULT_QUEUE, DEFAULT_SCHEDULING_PRIORITY;
+var DEFAULT_DEFAULT_BRANCH, DEFAULT_PRD_DIR, DEFAULT_SUMMARY_WINDOW_HOURS, DEFAULT_MAX_RUNTIME, DEFAULT_REVIEWER_MAX_RUNTIME, DEFAULT_CRON_SCHEDULE, DEFAULT_REVIEWER_SCHEDULE, DEFAULT_CRON_SCHEDULE_OFFSET, DEFAULT_MAX_RETRIES, DEFAULT_REVIEWER_MAX_RETRIES, DEFAULT_REVIEWER_RETRY_DELAY, DEFAULT_REVIEWER_MAX_PRS_PER_RUN, DEFAULT_FEEDBACK, DEFAULT_BRANCH_PREFIX, DEFAULT_BRANCH_PATTERNS, DEFAULT_MIN_REVIEW_SCORE, DEFAULT_MAX_LOG_SIZE, DEFAULT_PROVIDER, DEFAULT_EXECUTOR_ENABLED, DEFAULT_REVIEWER_ENABLED, DEFAULT_PROVIDER_ENV, DEFAULT_MODEL_ATTRIBUTION, DEFAULT_NEW_PR_LABEL, DEFAULT_FALLBACK_ON_RATE_LIMIT, DEFAULT_CLAUDE_MODEL, DEFAULT_PRIMARY_FALLBACK_MODEL, DEFAULT_SECONDARY_FALLBACK_MODEL, VALID_CLAUDE_MODELS, CLAUDE_MODEL_IDS, DEFAULT_NOTIFICATIONS, DEFAULT_PRD_PRIORITY, DEFAULT_SLICER_SCHEDULE, DEFAULT_SLICER_MAX_RUNTIME, DEFAULT_ROADMAP_SCANNER, DEFAULT_TEMPLATES_DIR, DEFAULT_BOARD_PROVIDER, DEFAULT_LOCAL_BOARD_INFO, DEFAULT_AUTO_MERGE, DEFAULT_AUTO_MERGE_METHOD, VALID_MERGE_METHODS, DEFAULT_QA_ENABLED, DEFAULT_QA_SCHEDULE, DEFAULT_QA_MAX_RUNTIME, DEFAULT_QA_ARTIFACTS, DEFAULT_QA_SKIP_LABEL, DEFAULT_QA_AUTO_INSTALL_PLAYWRIGHT, DEFAULT_QA_VALIDATED_LABEL, DEFAULT_QA, QA_LOG_NAME, DEFAULT_AUDIT_ENABLED, DEFAULT_AUDIT_SCHEDULE, DEFAULT_AUDIT_MAX_RUNTIME, DEFAULT_AUDIT_CREATE_ISSUES, DEFAULT_AUDIT_TARGET_COLUMN, DEFAULT_AUDIT, DEFAULT_UX_ENABLED, DEFAULT_UX_SCHEDULE, DEFAULT_UX_MAX_RUNTIME, DEFAULT_UX_TARGET_COLUMN, DEFAULT_UX_BASE_URL, DEFAULT_UX_START_URL, DEFAULT_UX_AUTO_INSTALL_PLAYWRIGHT, DEFAULT_UX_MAX_ISSUES, DEFAULT_UX_REPORT_PROMPT, DEFAULT_UX, DEFAULT_ANALYTICS_ENABLED, DEFAULT_ANALYTICS_SCHEDULE, DEFAULT_ANALYTICS_MAX_RUNTIME, DEFAULT_ANALYTICS_LOOKBACK_DAYS, DEFAULT_ANALYTICS_TARGET_COLUMN, DEFAULT_ANALYTICS_PROMPT, DEFAULT_ANALYTICS, DEFAULT_MANAGER_ENABLED, DEFAULT_MANAGER_SCHEDULE, DEFAULT_MANAGER_MAX_RUNTIME, DEFAULT_MANAGER_AUTHORITY, DEFAULT_MANAGER_OUTPUT_MODE, DEFAULT_MANAGER_TARGET_COLUMN, DEFAULT_MANAGER_MEMORY_PATH, DEFAULT_MANAGER_DOCS_DIR, DEFAULT_MANAGER_WEEKLY_SUMMARY_ENABLED, DEFAULT_MANAGER_WEEKLY_SUMMARY_DAY, DEFAULT_MANAGER, DEFAULT_PR_RESOLVER_ENABLED, DEFAULT_PR_RESOLVER_SCHEDULE, DEFAULT_PR_RESOLVER_MAX_RUNTIME, DEFAULT_PR_RESOLVER_MAX_PRS_PER_RUN, DEFAULT_PR_RESOLVER_PER_PR_TIMEOUT, DEFAULT_PR_RESOLVER_AI_CONFLICT_RESOLUTION, DEFAULT_PR_RESOLVER_AI_REVIEW_RESOLUTION, DEFAULT_PR_RESOLVER_READY_LABEL, DEFAULT_PR_RESOLVER, DEFAULT_MERGER_ENABLED, DEFAULT_MERGER_SCHEDULE, DEFAULT_MERGER_MAX_RUNTIME, DEFAULT_MERGER_MERGE_METHOD, DEFAULT_MERGER_MIN_REVIEW_SCORE, DEFAULT_MERGER_REBASE_BEFORE_MERGE, DEFAULT_MERGER_MAX_PRS_PER_RUN, DEFAULT_MERGER_CI_POLICY, DEFAULT_MERGER_LOCAL_CHECK_COMMAND, DEFAULT_MERGER, MERGER_LOG_NAME, AUDIT_LOG_NAME, UX_LOG_NAME, PLANNER_LOG_NAME, ANALYTICS_LOG_NAME, PR_RESOLVER_LOG_NAME, MANAGER_LOG_NAME, VALID_PROVIDERS, VALID_JOB_TYPES, DEFAULT_JOB_PROVIDERS, DEFAULT_PROVIDER_SCHEDULE_OVERRIDES, DEFAULT_WEBHOOK_TRIGGER_SECRET_ENV, DEFAULT_WEBHOOK_TRIGGER_MAX_SKEW_SECONDS, DEFAULT_WEBHOOK_TRIGGERS, BUILT_IN_PRESETS, BUILT_IN_PRESET_IDS, PROVIDER_COMMANDS, CONFIG_FILE_NAME, LOCK_FILE_PREFIX, LOG_DIR, CLAIM_FILE_EXTENSION, EXECUTOR_LOG_NAME, REVIEWER_LOG_NAME, EXECUTOR_LOG_FILE, REVIEWER_LOG_FILE, LOG_FILE_NAMES, GLOBAL_CONFIG_DIR, REGISTRY_FILE_NAME, HISTORY_FILE_NAME, PRD_STATES_FILE_NAME, STATE_DB_FILE_NAME, GLOBAL_NOTIFICATIONS_FILE_NAME, TELEMETRY_FILE_NAME, DEFAULT_AMPLITUDE_API_KEY, DEFAULT_AMPLITUDE_INGEST_ENDPOINT, MAX_HISTORY_RECORDS_PER_PRD, DEFAULT_QUEUE_ENABLED, DEFAULT_QUEUE_MODE, DEFAULT_QUEUE_MAX_CONCURRENCY, DEFAULT_QUEUE_MAX_WAIT_TIME, DEFAULT_QUEUE_PRIORITY, DEFAULT_QUEUE, DEFAULT_SCHEDULING_PRIORITY;
 var init_constants = __esm({
   "../core/dist/constants.js"() {
     "use strict";
@@ -503,6 +539,8 @@ var init_constants = __esm({
     DEFAULT_EXECUTOR_ENABLED = true;
     DEFAULT_REVIEWER_ENABLED = true;
     DEFAULT_PROVIDER_ENV = {};
+    DEFAULT_MODEL_ATTRIBUTION = false;
+    DEFAULT_NEW_PR_LABEL = "draft";
     DEFAULT_FALLBACK_ON_RATE_LIMIT = true;
     DEFAULT_CLAUDE_MODEL = void 0;
     DEFAULT_PRIMARY_FALLBACK_MODEL = void 0;
@@ -564,6 +602,27 @@ var init_constants = __esm({
       createIssues: DEFAULT_AUDIT_CREATE_ISSUES,
       targetColumn: DEFAULT_AUDIT_TARGET_COLUMN
     };
+    DEFAULT_UX_ENABLED = false;
+    DEFAULT_UX_SCHEDULE = "0 7 * * 1";
+    DEFAULT_UX_MAX_RUNTIME = 0;
+    DEFAULT_UX_TARGET_COLUMN = "Draft";
+    DEFAULT_UX_BASE_URL = "";
+    DEFAULT_UX_START_URL = "";
+    DEFAULT_UX_AUTO_INSTALL_PLAYWRIGHT = true;
+    DEFAULT_UX_MAX_ISSUES = 10;
+    DEFAULT_UX_REPORT_PROMPT = "";
+    DEFAULT_UX = {
+      enabled: DEFAULT_UX_ENABLED,
+      schedule: DEFAULT_UX_SCHEDULE,
+      maxRuntime: DEFAULT_UX_MAX_RUNTIME,
+      targetColumn: DEFAULT_UX_TARGET_COLUMN,
+      baseUrl: DEFAULT_UX_BASE_URL,
+      startUrl: DEFAULT_UX_START_URL,
+      flows: [],
+      autoInstallPlaywright: DEFAULT_UX_AUTO_INSTALL_PLAYWRIGHT,
+      maxIssues: DEFAULT_UX_MAX_ISSUES,
+      reportPrompt: DEFAULT_UX_REPORT_PROMPT
+    };
     DEFAULT_ANALYTICS_ENABLED = false;
     DEFAULT_ANALYTICS_SCHEDULE = "0 6 * * 1";
     DEFAULT_ANALYTICS_MAX_RUNTIME = 0;
@@ -646,6 +705,7 @@ If no issues are warranted, output an empty array: []`;
     };
     MERGER_LOG_NAME = "merger";
     AUDIT_LOG_NAME = "audit";
+    UX_LOG_NAME = "ux";
     PLANNER_LOG_NAME = "slicer";
     ANALYTICS_LOG_NAME = "analytics";
     PR_RESOLVER_LOG_NAME = "pr-resolver";
@@ -747,6 +807,9 @@ If no issues are warranted, output an empty array: []`;
     PRD_STATES_FILE_NAME = "prd-states.json";
     STATE_DB_FILE_NAME = "state.db";
     GLOBAL_NOTIFICATIONS_FILE_NAME = "global-notifications.json";
+    TELEMETRY_FILE_NAME = "telemetry.json";
+    DEFAULT_AMPLITUDE_API_KEY = "5289e9a61e10e059d25f8eb846bceaa8";
+    DEFAULT_AMPLITUDE_INGEST_ENDPOINT = "https://api2.amplitude.com/2/httpapi";
     MAX_HISTORY_RECORDS_PER_PRD = 10;
     DEFAULT_QUEUE_ENABLED = true;
     DEFAULT_QUEUE_MODE = "auto";
@@ -826,6 +889,11 @@ function normalizeConfig(rawConfig) {
   if (providerLabelVal) {
     normalized.providerLabel = providerLabelVal;
   }
+  normalized.modelAttribution = readBoolean(rawConfig.modelAttribution);
+  const newPrLabelVal = readString2(rawConfig.newPrLabel);
+  if (newPrLabelVal !== void 0) {
+    normalized.newPrLabel = newPrLabelVal.trim();
+  }
   const rawProviderEnv = readObject2(rawConfig.providerEnv);
   if (rawProviderEnv) {
     const env = {};
@@ -974,7 +1042,7 @@ function normalizeConfig(rawConfig) {
   if (mergeMethod && VALID_MERGE_METHODS.includes(mergeMethod)) {
     normalized.autoMergeMethod = mergeMethod;
   }
-  for (const jobId of ["qa", "audit", "analytics", "merger", "manager"]) {
+  for (const jobId of ["qa", "audit", "ux", "analytics", "merger", "manager"]) {
     const jobDef = getJobDef(jobId);
     if (!jobDef)
       continue;
@@ -1252,6 +1320,14 @@ function buildEnvOverrideConfig(fileConfig) {
     if (v !== null)
       env.executorEnabled = v;
   }
+  if (process.env.NW_MODEL_ATTRIBUTION_ENABLED !== void 0) {
+    const v = parseBoolean(process.env.NW_MODEL_ATTRIBUTION_ENABLED);
+    if (v !== null)
+      env.modelAttribution = v;
+  }
+  if (process.env.NW_NEW_PR_LABEL !== void 0) {
+    env.newPrLabel = process.env.NW_NEW_PR_LABEL.trim();
+  }
   if (process.env.NW_NOTIFICATIONS) {
     try {
       const parsed = JSON.parse(process.env.NW_NOTIFICATIONS);
@@ -1325,7 +1401,7 @@ function buildEnvOverrideConfig(fileConfig) {
       env.claudeModel = model;
     }
   }
-  for (const jobId of ["qa", "audit", "analytics", "manager"]) {
+  for (const jobId of ["qa", "audit", "ux", "analytics", "manager"]) {
     const jobDef = getJobDef(jobId);
     if (!jobDef)
       continue;
@@ -1438,6 +1514,8 @@ function getDefaultConfig() {
     executorEnabled: DEFAULT_EXECUTOR_ENABLED,
     reviewerEnabled: DEFAULT_REVIEWER_ENABLED,
     providerEnv: { ...DEFAULT_PROVIDER_ENV },
+    modelAttribution: DEFAULT_MODEL_ATTRIBUTION,
+    newPrLabel: DEFAULT_NEW_PR_LABEL,
     notifications: { ...DEFAULT_NOTIFICATIONS, webhooks: [] },
     prdPriority: [...DEFAULT_PRD_PRIORITY],
     roadmapScanner: { ...DEFAULT_ROADMAP_SCANNER },
@@ -1451,6 +1529,7 @@ function getDefaultConfig() {
     claudeModel: DEFAULT_CLAUDE_MODEL,
     qa: { ...DEFAULT_QA },
     audit: { ...DEFAULT_AUDIT },
+    ux: { ...DEFAULT_UX, flows: [...DEFAULT_UX.flows] },
     analytics: { ...DEFAULT_ANALYTICS },
     manager: { ...DEFAULT_MANAGER },
     feedback: { ...DEFAULT_FEEDBACK },
@@ -1652,7 +1731,7 @@ function mergeConfigLayer(base, layer) {
           })
         }
       };
-    } else if (_key === "providerEnv" || _key === "boardProvider" || _key === "qa" || _key === "audit" || _key === "analytics" || _key === "manager" || _key === "feedback" || _key === "prResolver" || _key === "merger") {
+    } else if (_key === "providerEnv" || _key === "boardProvider" || _key === "qa" || _key === "audit" || _key === "ux" || _key === "analytics" || _key === "manager" || _key === "feedback" || _key === "prResolver" || _key === "merger") {
       base[_key] = {
         ...base[_key],
         ...value
@@ -4549,6 +4628,9 @@ function qaLockPath(projectDir) {
 function auditLockPath(projectDir) {
   return `${LOCK_FILE_PREFIX}audit-${projectRuntimeKey(projectDir)}.lock`;
 }
+function uxLockPath(projectDir) {
+  return `${LOCK_FILE_PREFIX}ux-${projectRuntimeKey(projectDir)}.lock`;
+}
 function plannerLockPath(projectDir) {
   return `${LOCK_FILE_PREFIX}slicer-${projectRuntimeKey(projectDir)}.lock`;
 }
@@ -4951,6 +5033,7 @@ function collectLogInfo(projectDir) {
     { name: "reviewer", fileName: "reviewer.log" },
     { name: "qa", fileName: `${QA_LOG_NAME}.log` },
     { name: "audit", fileName: `${AUDIT_LOG_NAME}.log` },
+    { name: "ux", fileName: `${UX_LOG_NAME}.log` },
     { name: "planner", fileName: `${PLANNER_LOG_NAME}.log` },
     { name: "analytics", fileName: `${ANALYTICS_LOG_NAME}.log` },
     { name: "pr-resolver", fileName: `${PR_RESOLVER_LOG_NAME}.log` },
@@ -4983,6 +5066,7 @@ async function fetchStatusSnapshot(projectDir, config) {
   const reviewerLock = checkLockFile(reviewerLockPath(projectDir));
   const qaLock = checkLockFile(qaLockPath(projectDir));
   const auditLock = checkLockFile(auditLockPath(projectDir));
+  const uxLock = checkLockFile(uxLockPath(projectDir));
   const plannerLock = checkLockFile(plannerLockPath(projectDir));
   const analyticsLock = checkLockFile(analyticsLockPath(projectDir));
   const prResolverLock = checkLockFile(prResolverLockPath(projectDir));
@@ -4993,6 +5077,7 @@ async function fetchStatusSnapshot(projectDir, config) {
     { name: "reviewer", running: reviewerLock.running, pid: reviewerLock.pid },
     { name: "qa", running: qaLock.running, pid: qaLock.pid },
     { name: "audit", running: auditLock.running, pid: auditLock.pid },
+    { name: "ux", running: uxLock.running, pid: uxLock.pid },
     { name: "planner", running: plannerLock.running, pid: plannerLock.pid },
     { name: "analytics", running: analyticsLock.running, pid: analyticsLock.pid },
     { name: "pr-resolver", running: prResolverLock.running, pid: prResolverLock.pid },
@@ -7999,6 +8084,8 @@ function getLockPathForJob(projectPath, jobType) {
       return qaLockPath(projectPath);
     case "audit":
       return auditLockPath(projectPath);
+    case "ux":
+      return uxLockPath(projectPath);
     case "slicer":
     case "planner":
       return plannerLockPath(projectPath);
@@ -8866,6 +8953,351 @@ var init_analytics = __esm({
   }
 });
 
+// ../core/dist/telemetry/amplitude-ingest-client.js
+var AmplitudeIngestClient;
+var init_amplitude_ingest_client = __esm({
+  "../core/dist/telemetry/amplitude-ingest-client.js"() {
+    "use strict";
+    init_constants();
+    AmplitudeIngestClient = class {
+      apiKey;
+      endpoint;
+      fetchImpl;
+      timeoutMs;
+      constructor(options) {
+        this.apiKey = options.apiKey;
+        this.endpoint = options.endpoint ?? DEFAULT_AMPLITUDE_INGEST_ENDPOINT;
+        this.fetchImpl = options.fetchImpl ?? fetch;
+        this.timeoutMs = options.timeoutMs ?? 1500;
+      }
+      async send(event) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+          const response = await this.fetchImpl(this.endpoint, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({
+              api_key: this.apiKey,
+              events: [
+                {
+                  device_id: event.installId,
+                  event_type: event.eventName,
+                  event_properties: event.properties,
+                  time: event.time ?? Date.now()
+                }
+              ]
+            }),
+            signal: controller.signal
+          });
+          if (!response.ok) {
+            throw new Error(`Amplitude ingestion failed with ${response.status}`);
+          }
+        } finally {
+          clearTimeout(timeout);
+        }
+      }
+    };
+  }
+});
+
+// ../core/dist/telemetry/config.js
+import * as crypto2 from "crypto";
+import * as fs23 from "fs";
+import * as os9 from "os";
+import * as path22 from "path";
+function getTelemetryConfigPath(env = process.env) {
+  const base = env.NIGHT_WATCH_HOME || path22.join(os9.homedir(), GLOBAL_CONFIG_DIR);
+  return path22.join(base, TELEMETRY_FILE_NAME);
+}
+function isTelemetryEnvDisabled(env = process.env) {
+  if (env.NW_TELEMETRY_DISABLED === "1") {
+    return "env:NW_TELEMETRY_DISABLED";
+  }
+  if (env.DO_NOT_TRACK === "1") {
+    return "env:DO_NOT_TRACK";
+  }
+  return null;
+}
+function createTelemetryConfig(now) {
+  const timestamp = now.toISOString();
+  return {
+    schemaVersion: 1,
+    installId: crypto2.randomUUID(),
+    enabled: true,
+    createdAt: timestamp,
+    updatedAt: timestamp
+  };
+}
+function parseTelemetryConfig(raw) {
+  const parsed = JSON.parse(raw);
+  if (parsed.schemaVersion !== 1 || typeof parsed.installId !== "string" || parsed.installId.length === 0 || typeof parsed.enabled !== "boolean" || typeof parsed.createdAt !== "string" || typeof parsed.updatedAt !== "string") {
+    return null;
+  }
+  return {
+    schemaVersion: 1,
+    installId: parsed.installId,
+    enabled: parsed.enabled,
+    noticeShownAt: typeof parsed.noticeShownAt === "string" && parsed.noticeShownAt.length > 0 ? parsed.noticeShownAt : void 0,
+    createdAt: parsed.createdAt,
+    updatedAt: parsed.updatedAt
+  };
+}
+function saveTelemetryConfig(config, env = process.env) {
+  const filePath = getTelemetryConfigPath(env);
+  fs23.mkdirSync(path22.dirname(filePath), { recursive: true });
+  fs23.writeFileSync(filePath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+function loadOrCreateTelemetryConfig(options = {}) {
+  const env = options.env ?? process.env;
+  const now = options.now?.() ?? /* @__PURE__ */ new Date();
+  const filePath = getTelemetryConfigPath(env);
+  try {
+    if (fs23.existsSync(filePath)) {
+      const parsed = parseTelemetryConfig(fs23.readFileSync(filePath, "utf-8"));
+      if (parsed) {
+        return parsed;
+      }
+    }
+  } catch {
+  }
+  const fresh = createTelemetryConfig(now);
+  try {
+    saveTelemetryConfig(fresh, env);
+  } catch {
+  }
+  return fresh;
+}
+function getTelemetryEffectiveState(options = {}) {
+  const env = options.env ?? process.env;
+  const config = loadOrCreateTelemetryConfig(options);
+  const envDisabled = isTelemetryEnvDisabled(env);
+  const pathValue = getTelemetryConfigPath(env);
+  if (envDisabled) {
+    return { config, enabled: false, path: pathValue, reason: envDisabled };
+  }
+  if (!config.enabled) {
+    return { config, enabled: false, path: pathValue, reason: "config" };
+  }
+  if (options.apiKey !== void 0 && options.apiKey.trim().length === 0) {
+    return { config, enabled: false, path: pathValue, reason: "missing-api-key" };
+  }
+  return { config, enabled: true, path: pathValue, reason: "config" };
+}
+function setTelemetryEnabled(enabled, options = {}) {
+  const env = options.env ?? process.env;
+  const config = loadOrCreateTelemetryConfig(options);
+  const updated = {
+    ...config,
+    enabled,
+    updatedAt: (options.now?.() ?? /* @__PURE__ */ new Date()).toISOString()
+  };
+  saveTelemetryConfig(updated, env);
+  return updated;
+}
+function markTelemetryNoticeShown(options = {}) {
+  const env = options.env ?? process.env;
+  const config = loadOrCreateTelemetryConfig(options);
+  const timestamp = (options.now?.() ?? /* @__PURE__ */ new Date()).toISOString();
+  const updated = {
+    ...config,
+    noticeShownAt: config.noticeShownAt ?? timestamp,
+    updatedAt: timestamp
+  };
+  saveTelemetryConfig(updated, env);
+  return updated;
+}
+var init_config2 = __esm({
+  "../core/dist/telemetry/config.js"() {
+    "use strict";
+    init_constants();
+  }
+});
+
+// ../core/dist/telemetry/schema.js
+var TELEMETRY_EVENT_NAMES, TELEMETRY_ERROR_CATEGORIES;
+var init_schema = __esm({
+  "../core/dist/telemetry/schema.js"() {
+    "use strict";
+    TELEMETRY_EVENT_NAMES = [
+      "cli_first_run",
+      "cli_init_completed",
+      "command_started",
+      "command_completed",
+      "job_started",
+      "job_completed",
+      "job_failed",
+      "pr_opened",
+      "review_completed",
+      "auto_merge_completed",
+      "doctor_failed",
+      "telemetry_enabled",
+      "telemetry_disabled"
+    ];
+    TELEMETRY_ERROR_CATEGORIES = [
+      "config",
+      "provider",
+      "github",
+      "network",
+      "rate_limit",
+      "timeout",
+      "validation",
+      "unknown"
+    ];
+  }
+});
+
+// ../core/dist/telemetry/sanitizer.js
+function isAllowedTelemetryEventName(eventName) {
+  return TELEMETRY_EVENT_NAMES.includes(eventName);
+}
+function isSuspiciousString(value) {
+  if (!SAFE_STRING_PATTERN.test(value)) {
+    return true;
+  }
+  return value.includes("/") || value.includes("\\") || /^[a-z][a-z0-9+.-]*:/i.test(value);
+}
+function sanitizeString(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  if (trimmed.length === 0 || isSuspiciousString(trimmed)) {
+    return void 0;
+  }
+  return trimmed;
+}
+function sanitizeBoolean(value) {
+  return typeof value === "boolean" ? value : void 0;
+}
+function sanitizeInteger(value) {
+  if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) {
+    return void 0;
+  }
+  return value;
+}
+function mapTelemetryErrorCategory(value) {
+  if (typeof value === "string") {
+    const normalized = value.toLowerCase();
+    if (TELEMETRY_ERROR_CATEGORIES.includes(normalized)) {
+      return normalized;
+    }
+    if (normalized.includes("timeout") || normalized.includes("timed out"))
+      return "timeout";
+    if (normalized.includes("rate"))
+      return "rate_limit";
+    if (normalized.includes("github") || normalized.includes("gh "))
+      return "github";
+    if (normalized.includes("network") || normalized.includes("fetch"))
+      return "network";
+    if (normalized.includes("provider") || normalized.includes("claude") || normalized.includes("codex")) {
+      return "provider";
+    }
+    if (normalized.includes("config"))
+      return "config";
+    if (normalized.includes("valid"))
+      return "validation";
+  }
+  return "unknown";
+}
+function sanitizeTelemetryEvent(eventName, properties = {}) {
+  if (!isAllowedTelemetryEventName(eventName)) {
+    return null;
+  }
+  const sanitized = {};
+  for (const key of STRING_PROPERTIES) {
+    const value = sanitizeString(properties[key]);
+    if (value !== void 0) {
+      sanitized[key] = value;
+    }
+  }
+  for (const key of BOOLEAN_PROPERTIES) {
+    const value = sanitizeBoolean(properties[key]);
+    if (value !== void 0) {
+      sanitized[key] = value;
+    }
+  }
+  for (const key of INTEGER_PROPERTIES) {
+    const value = sanitizeInteger(properties[key]);
+    if (value !== void 0) {
+      sanitized[key] = value;
+    }
+  }
+  if (properties.errorCategory !== void 0) {
+    sanitized.errorCategory = mapTelemetryErrorCategory(properties.errorCategory);
+  }
+  return { eventName, properties: sanitized };
+}
+var STRING_PROPERTIES, BOOLEAN_PROPERTIES, INTEGER_PROPERTIES, SAFE_STRING_PATTERN;
+var init_sanitizer = __esm({
+  "../core/dist/telemetry/sanitizer.js"() {
+    "use strict";
+    init_schema();
+    STRING_PROPERTIES = ["cliVersion", "command", "jobType", "provider", "platform"];
+    BOOLEAN_PROPERTIES = ["success", "failure", "boardMode"];
+    INTEGER_PROPERTIES = [
+      "durationMs",
+      "exitCode",
+      "nodeMajorVersion",
+      "registeredProjectCount"
+    ];
+    SAFE_STRING_PATTERN = /^[a-zA-Z0-9_.:-]{1,80}$/;
+  }
+});
+
+// ../core/dist/telemetry/reporter.js
+function resolveAmplitudeApiKey(env, explicit) {
+  return explicit ?? env.NW_AMPLITUDE_API_KEY ?? DEFAULT_AMPLITUDE_API_KEY;
+}
+async function trackTelemetryEvent(eventName, properties = {}, options = {}) {
+  const env = options.env ?? process.env;
+  const apiKey = resolveAmplitudeApiKey(env, options.apiKey);
+  const state = getTelemetryEffectiveState({ env, apiKey, now: options.now });
+  if (!state.enabled) {
+    return { sent: false, reason: `disabled:${state.reason}` };
+  }
+  if (apiKey.trim().length === 0) {
+    return { sent: false, reason: "missing-api-key" };
+  }
+  const sanitized = sanitizeTelemetryEvent(eventName, properties);
+  if (!sanitized) {
+    return { sent: false, reason: "dropped:event-name" };
+  }
+  try {
+    const client = options.client ?? new AmplitudeIngestClient({ apiKey });
+    await client.send({
+      eventName: sanitized.eventName,
+      installId: state.config.installId,
+      properties: sanitized.properties,
+      time: options.now?.().getTime()
+    });
+    return { sent: true };
+  } catch {
+    return { sent: false, reason: "network-error" };
+  }
+}
+var init_reporter = __esm({
+  "../core/dist/telemetry/reporter.js"() {
+    "use strict";
+    init_constants();
+    init_amplitude_ingest_client();
+    init_config2();
+    init_sanitizer();
+  }
+});
+
+// ../core/dist/telemetry/index.js
+var init_telemetry = __esm({
+  "../core/dist/telemetry/index.js"() {
+    "use strict";
+    init_amplitude_ingest_client();
+    init_config2();
+    init_reporter();
+    init_sanitizer();
+    init_schema();
+  }
+});
+
 // ../core/dist/audit/board-sync.js
 function humanizeCategory(category) {
   return category.trim().replace(/[_-]+/g, " ").replace(/\s+/g, " ").trim();
@@ -9030,19 +9462,272 @@ var init_audit = __esm({
   }
 });
 
+// ../core/dist/ux/ux-runner.js
+import * as fs24 from "fs";
+import * as os10 from "os";
+import * as path23 from "path";
+function asString(value, fallback = "") {
+  return typeof value === "string" ? value.trim() : fallback;
+}
+function asStringArray(value) {
+  if (Array.isArray(value)) {
+    return value.map((item) => asString(item)).filter(Boolean);
+  }
+  const single = asString(value);
+  return single ? [single] : [];
+}
+function normalizeUxPriority(value) {
+  const raw = asString(value).toUpperCase();
+  if (raw === "P0" || raw === "CRITICAL" || raw === "BLOCKER")
+    return "P0";
+  if (raw === "P1" || raw === "HIGH" || raw === "MAJOR")
+    return "P1";
+  if (raw === "P2" || raw === "MEDIUM" || raw === "MODERATE")
+    return "P2";
+  return "P3";
+}
+function sortUxFindings(findings) {
+  return [...findings].sort((left, right) => PRIORITY_ORDER.indexOf(left.priority) - PRIORITY_ORDER.indexOf(right.priority) || left.title.localeCompare(right.title));
+}
+function rawFindingToFinding(raw) {
+  const title = asString(raw.title);
+  if (!title)
+    return null;
+  return {
+    title,
+    priority: normalizeUxPriority(raw.priority ?? raw.severity),
+    impact: asString(raw.impact, "Not specified"),
+    affectedFlows: asStringArray(raw.affectedFlows ?? raw.affectedFlow ?? raw.flows),
+    affectedPages: asStringArray(raw.affectedPages ?? raw.affectedPage ?? raw.pages),
+    evidence: asStringArray(raw.evidence),
+    reproductionSteps: asStringArray(raw.reproductionSteps ?? raw.steps),
+    recommendedFix: asString(raw.recommendedFix ?? raw.recommendation ?? raw.fix, "Investigate and improve the affected user experience.")
+  };
+}
+function extractJsonCandidate(text) {
+  const trimmed = text.trim();
+  try {
+    return JSON.parse(trimmed);
+  } catch {
+    const arrayStart = text.indexOf("[");
+    const arrayEnd = text.lastIndexOf("]");
+    if (arrayStart !== -1 && arrayEnd > arrayStart) {
+      return JSON.parse(text.slice(arrayStart, arrayEnd + 1));
+    }
+    const objectStart = text.indexOf("{");
+    const objectEnd = text.lastIndexOf("}");
+    if (objectStart !== -1 && objectEnd > objectStart) {
+      return JSON.parse(text.slice(objectStart, objectEnd + 1));
+    }
+    throw new Error("No JSON object or array found in UX provider output");
+  }
+}
+function parseUxFindings(text) {
+  let parsed;
+  try {
+    parsed = extractJsonCandidate(text);
+  } catch {
+    logger6.warn("Failed to parse UX provider output as JSON");
+    return [];
+  }
+  let rawItems = [];
+  if (Array.isArray(parsed)) {
+    rawItems = parsed;
+  } else if (Array.isArray(parsed?.findings)) {
+    rawItems = parsed.findings;
+  }
+  const findings = rawItems.filter((item) => item !== null && typeof item === "object").map(rawFindingToFinding).filter((item) => item !== null);
+  return sortUxFindings(findings);
+}
+function formatList(items, fallback = "Not specified") {
+  if (items.length === 0)
+    return fallback;
+  return items.map((item) => `- ${item}`).join("\n");
+}
+function buildUxReportBody(input) {
+  const lines = [
+    "# UX Report",
+    "",
+    `Generated by Night Watch UX agent on ${(/* @__PURE__ */ new Date()).toISOString()}.`,
+    "",
+    "## Scope",
+    "",
+    `- Base URL: ${input.baseUrl || "Not configured"}`,
+    `- Start URL: ${input.startUrl || "Not configured"}`,
+    "- Configured flows:",
+    input.flows.length > 0 ? formatList(input.flows) : "- Not configured",
+    "",
+    "## Findings"
+  ];
+  input.findings.forEach((finding, index) => {
+    lines.push("", `### ${index + 1}. [${finding.priority}] ${finding.title}`, "", "**Impact**", "", finding.impact, "", "**Affected Flows**", "", formatList(finding.affectedFlows), "", "**Affected Pages**", "", formatList(finding.affectedPages), "", "**Evidence**", "", formatList(finding.evidence), "", "**Reproduction Steps**", "", formatList(finding.reproductionSteps), "", "**Recommended Fix**", "", finding.recommendedFix);
+  });
+  return lines.join("\n");
+}
+function buildUxAuditPrompt(config, projectDir) {
+  const ux = config.ux;
+  const configuredUrl = ux.startUrl || ux.baseUrl;
+  const custom = ux.reportPrompt.trim();
+  return [
+    custom || "You are a senior UX reviewer creating an actionable UX report.",
+    "",
+    "Use Playwright/browser automation for the inspection. If Playwright is missing and auto-install is enabled, use a lightweight local check/install such as `npx playwright --version` and `npx playwright install chromium` as needed.",
+    "Inspect the configured app, traverse the listed flows, capture screenshots or other evidence when useful, and focus on issues that materially affect user comprehension, completion, accessibility, responsiveness, or trust.",
+    "",
+    "Return only JSON. Use this exact shape:",
+    '[{"title":"...","priority":"P0|P1|P2|P3","impact":"...","affectedFlows":["..."],"affectedPages":["..."],"evidence":["screenshot path or observation"],"reproductionSteps":["..."],"recommendedFix":"..."}]',
+    "If no actionable UX issues are found, return [] only.",
+    "",
+    "Priority definitions:",
+    "- P0: blocks core user flow or causes serious data/action risk",
+    "- P1: major friction, broken responsive state, or accessibility failure in a key flow",
+    "- P2: moderate confusion or inefficient interaction",
+    "- P3: polish or minor usability concern",
+    "",
+    `Project directory: ${projectDir}`,
+    `Base URL: ${ux.baseUrl || "not configured"}`,
+    `Start URL: ${configuredUrl || "not configured"}`,
+    `Auto-install Playwright: ${ux.autoInstallPlaywright ? "yes" : "no"}`,
+    `Maximum findings: ${Math.max(1, ux.maxIssues)}`,
+    "",
+    "Configured flows:",
+    ux.flows.length > 0 ? ux.flows.map((flow) => `- ${flow}`).join("\n") : "- Discover the primary user flows from the app/repo."
+  ].join("\n");
+}
+function shellQuote(value) {
+  return `'${value.replace(/'/g, `'"'"'`)}'`;
+}
+function buildPresetCommand(preset, promptFile, projectDir) {
+  const args = [preset.command];
+  if (preset.subcommand)
+    args.push(preset.subcommand);
+  if (preset.workdirFlag)
+    args.push(preset.workdirFlag, projectDir);
+  if (preset.modelFlag && preset.model)
+    args.push(preset.modelFlag, preset.model);
+  if (preset.autoApproveFlag)
+    args.push(preset.autoApproveFlag);
+  const quotedPrefix = args.map(shellQuote).join(" ");
+  const promptArg = `"$(cat ${shellQuote(promptFile)})"`;
+  if (preset.promptFlag) {
+    return `${quotedPrefix} ${shellQuote(preset.promptFlag)} ${promptArg}`;
+  }
+  return `${quotedPrefix} ${promptArg}`;
+}
+async function invokeProvider(prompt, config, projectDir) {
+  const tmpDir = fs24.mkdtempSync(path23.join(os10.tmpdir(), "nw-ux-"));
+  const promptFile = path23.join(tmpDir, "ux-prompt.md");
+  const scriptFile = path23.join(tmpDir, "run-ux.sh");
+  try {
+    fs24.writeFileSync(promptFile, prompt, "utf-8");
+    const provider = resolveJobProvider(config, "ux");
+    const preset = resolvePreset(config, provider);
+    const command = buildPresetCommand(preset, promptFile, projectDir);
+    fs24.writeFileSync(scriptFile, `#!/usr/bin/env bash
+set -euo pipefail
+${command} 2>&1
+`, {
+      mode: 493
+    });
+    const env = { ...preset.envVars ?? {}, ...config.providerEnv ?? {} };
+    const { exitCode, stdout, stderr } = await executeScriptWithOutput(scriptFile, [], env, {
+      cwd: projectDir
+    });
+    if (exitCode !== 0) {
+      throw new Error(`UX provider exited with code ${exitCode}: ${stderr || stdout}`);
+    }
+    return `${stdout}
+${stderr}`;
+  } finally {
+    try {
+      fs24.rmSync(tmpDir, { recursive: true, force: true });
+    } catch {
+    }
+  }
+}
+async function resolveBoardProvider(config, projectDir, injected) {
+  if (injected !== void 0)
+    return injected;
+  if (!config.boardProvider?.enabled)
+    return null;
+  return createBoardProvider(config.boardProvider, projectDir);
+}
+async function runUx(config, projectDir, options = {}) {
+  const prompt = buildUxAuditPrompt(config, projectDir);
+  const providerOutput = options.providerOutput ?? await (options.providerInvoker ?? invokeProvider)(prompt, config, projectDir);
+  const findings = parseUxFindings(providerOutput).slice(0, Math.max(1, config.ux.maxIssues));
+  if (findings.length === 0) {
+    return { findings, issuesCreated: 0, summary: "No actionable UX issues found" };
+  }
+  const body = buildUxReportBody({
+    findings,
+    baseUrl: config.ux.baseUrl,
+    startUrl: config.ux.startUrl,
+    flows: config.ux.flows
+  });
+  if (options.dryRun) {
+    return {
+      findings,
+      issuesCreated: 0,
+      summary: `Dry run found ${findings.length} UX finding(s); no board report created`
+    };
+  }
+  const boardProvider = await resolveBoardProvider(config, projectDir, options.boardProvider);
+  if (!boardProvider) {
+    return {
+      findings,
+      issuesCreated: 0,
+      summary: `Found ${findings.length} UX finding(s); board provider is disabled`
+    };
+  }
+  const targetColumn = config.ux.targetColumn;
+  const issue = await boardProvider.createIssue({
+    title: `UX Report: ${findings.length} prioritized finding(s)`,
+    body,
+    column: targetColumn,
+    labels: ["ux", "night-watch"]
+  });
+  return {
+    findings,
+    issuesCreated: 1,
+    reportUrl: issue.url,
+    summary: `Created UX report with ${findings.length} finding(s) in ${targetColumn}`
+  };
+}
+var logger6, PRIORITY_ORDER;
+var init_ux_runner = __esm({
+  "../core/dist/ux/ux-runner.js"() {
+    "use strict";
+    init_factory();
+    init_config();
+    init_shell();
+    init_logger();
+    logger6 = createLogger("ux");
+    PRIORITY_ORDER = ["P0", "P1", "P2", "P3"];
+  }
+});
+
+// ../core/dist/ux/index.js
+var init_ux = __esm({
+  "../core/dist/ux/index.js"() {
+    "use strict";
+    init_ux_runner();
+  }
+});
+
 // ../core/dist/manager/manager-memory.js
-import * as fs23 from "fs";
-import * as path22 from "path";
+import * as fs25 from "fs";
+import * as path24 from "path";
 import { createHash as createHash4 } from "crypto";
 function createFindingFingerprint(parts) {
   const normalized = parts.map((part) => part.toLowerCase().trim().replace(/\s+/g, " ")).join("|");
   return createHash4("sha256").update(normalized).digest("hex").slice(0, 16);
 }
 function loadManagerMemory(memoryPath) {
-  if (!fs23.existsSync(memoryPath)) {
+  if (!fs25.existsSync(memoryPath)) {
     return { fingerprints: /* @__PURE__ */ new Set(), lastWeeklySummaryAt: null, raw: "" };
   }
-  const raw = fs23.readFileSync(memoryPath, "utf-8");
+  const raw = fs25.readFileSync(memoryPath, "utf-8");
   const fingerprints = /* @__PURE__ */ new Set();
   let match;
   while ((match = FINGERPRINT_PATTERN.exec(raw)) !== null) {
@@ -9100,8 +9785,8 @@ function renderManagerMemory(result, previous) {
 `;
 }
 function writeManagerMemory(memoryPath, result, previous) {
-  fs23.mkdirSync(path22.dirname(memoryPath), { recursive: true });
-  fs23.writeFileSync(memoryPath, renderManagerMemory(result, previous), "utf-8");
+  fs25.mkdirSync(path24.dirname(memoryPath), { recursive: true });
+  fs25.writeFileSync(memoryPath, renderManagerMemory(result, previous), "utf-8");
 }
 function renderFinding(finding) {
   return [
@@ -9149,13 +9834,13 @@ var init_manager_memory = __esm({
 });
 
 // ../core/dist/manager/manager-analysis.js
-import * as fs24 from "fs";
-import * as path23 from "path";
+import * as fs26 from "fs";
+import * as path25 from "path";
 function analyzeManagerInputs(context) {
-  const roadmapPath = path23.resolve(context.projectDir, context.config.roadmapScanner?.roadmapPath || "ROADMAP.md");
-  const roadmapContent = fs24.existsSync(roadmapPath) ? fs24.readFileSync(roadmapPath, "utf-8") : "";
+  const roadmapPath = path25.resolve(context.projectDir, context.config.roadmapScanner?.roadmapPath || "ROADMAP.md");
+  const roadmapContent = fs26.existsSync(roadmapPath) ? fs26.readFileSync(roadmapPath, "utf-8") : "";
   const roadmapItems = roadmapContent ? parseRoadmap(roadmapContent) : [];
-  const prds = collectPrdFiles(path23.resolve(context.projectDir, context.config.prdDir || "docs/prds"));
+  const prds = collectPrdFiles(path25.resolve(context.projectDir, context.config.prdDir || "docs/prds"));
   const findings = [];
   const searchableWork = buildSearchableWork(context.boardIssues.map((issue) => issue.title), prds);
   for (const item of roadmapItems.filter((roadmapItem) => !roadmapItem.checked)) {
@@ -9203,7 +9888,7 @@ function analyzeManagerInputs(context) {
       labels: ["manager", "queue", "blocked"]
     });
   }
-  if (!fs24.existsSync(path23.join(context.managerConfig.docsDirectory, "overview.md"))) {
+  if (!fs26.existsSync(path25.join(context.managerConfig.docsDirectory, "overview.md"))) {
     const fingerprint = createFindingFingerprint(["missing_manager_doc", context.managerConfig.docsDirectory]);
     findings.push({
       kind: "missing_manager_doc",
@@ -9219,19 +9904,19 @@ function analyzeManagerInputs(context) {
   return { findings, roadmapItems: roadmapItems.length, prds };
 }
 function collectPrdFiles(prdDir) {
-  if (!fs24.existsSync(prdDir))
+  if (!fs26.existsSync(prdDir))
     return [];
   const files = [];
   const visit = (dir) => {
-    for (const entry of fs24.readdirSync(dir, { withFileTypes: true })) {
-      const fullPath = path23.join(dir, entry.name);
+    for (const entry of fs26.readdirSync(dir, { withFileTypes: true })) {
+      const fullPath = path25.join(dir, entry.name);
       if (entry.isDirectory()) {
         visit(fullPath);
       } else if (entry.isFile() && entry.name.endsWith(".md")) {
         files.push({
           name: entry.name.replace(/\.md$/, ""),
           path: fullPath,
-          content: fs24.readFileSync(fullPath, "utf-8")
+          content: fs26.readFileSync(fullPath, "utf-8")
         });
       }
     }
@@ -9406,14 +10091,14 @@ var init_manager_notifications = __esm({
 });
 
 // ../core/dist/manager/manager-runner.js
-import * as fs25 from "fs";
-import * as path24 from "path";
+import * as fs27 from "fs";
+import * as path26 from "path";
 async function runManager(projectDir, config, options = {}) {
   const dryRun = options.dryRun ?? false;
   const now = options.now ?? /* @__PURE__ */ new Date();
   const managerConfig = resolveManagerConfig(config, projectDir);
   const memory = loadManagerMemory(managerConfig.memoryFile);
-  const boardProvider = await resolveBoardProvider(config, projectDir, options.boardProvider);
+  const boardProvider = await resolveBoardProvider2(config, projectDir, options.boardProvider);
   const boardIssues = await readBoardIssues(boardProvider);
   const queueStatus = resolveQueueStatus(options.queueStatus);
   const statusSnapshot = await resolveStatusSnapshot(projectDir, config, options.statusSnapshot);
@@ -9490,11 +10175,11 @@ function resolveManagerConfig(config, projectDir) {
   return {
     ...merged,
     weeklySummaryDay,
-    memoryFile: path24.resolve(projectDir, merged.memoryPath),
-    docsDirectory: path24.resolve(projectDir, merged.docsDir)
+    memoryFile: path26.resolve(projectDir, merged.memoryPath),
+    docsDirectory: path26.resolve(projectDir, merged.docsDir)
   };
 }
-async function resolveBoardProvider(config, projectDir, injected) {
+async function resolveBoardProvider2(config, projectDir, injected) {
   if (injected !== void 0) {
     return injected;
   }
@@ -9533,13 +10218,13 @@ async function resolveStatusSnapshot(projectDir, config, injected) {
   }
 }
 function writeManagerDocs(docsDir, result, now) {
-  const overviewPath = path24.resolve(docsDir, "overview.md");
-  const relative3 = path24.relative(docsDir, overviewPath);
-  if (relative3.startsWith("..") || path24.isAbsolute(relative3)) {
+  const overviewPath = path26.resolve(docsDir, "overview.md");
+  const relative3 = path26.relative(docsDir, overviewPath);
+  if (relative3.startsWith("..") || path26.isAbsolute(relative3)) {
     throw new Error(`Refusing to write Manager docs outside docsDir: ${overviewPath}`);
   }
-  fs25.mkdirSync(docsDir, { recursive: true });
-  fs25.writeFileSync(overviewPath, [
+  fs27.mkdirSync(docsDir, { recursive: true });
+  fs27.writeFileSync(overviewPath, [
     "# Manager Overview",
     "",
     `Generated: ${now.toISOString()}`,
@@ -10411,6 +11096,7 @@ var dist_exports = {};
 __export(dist_exports, {
   ANALYTICS_LOG_NAME: () => ANALYTICS_LOG_NAME,
   AUDIT_LOG_NAME: () => AUDIT_LOG_NAME,
+  AmplitudeIngestClient: () => AmplitudeIngestClient,
   BOARD_COLUMNS: () => BOARD_COLUMNS,
   BUILT_IN_PRESETS: () => BUILT_IN_PRESETS,
   BUILT_IN_PRESET_IDS: () => BUILT_IN_PRESET_IDS,
@@ -10421,6 +11107,8 @@ __export(dist_exports, {
   CONFIG_FILE_NAME: () => CONFIG_FILE_NAME,
   CRONTAB_MARKER_PREFIX: () => CRONTAB_MARKER_PREFIX,
   DATABASE_TOKEN: () => DATABASE_TOKEN,
+  DEFAULT_AMPLITUDE_API_KEY: () => DEFAULT_AMPLITUDE_API_KEY,
+  DEFAULT_AMPLITUDE_INGEST_ENDPOINT: () => DEFAULT_AMPLITUDE_INGEST_ENDPOINT,
   DEFAULT_ANALYTICS: () => DEFAULT_ANALYTICS,
   DEFAULT_ANALYTICS_ENABLED: () => DEFAULT_ANALYTICS_ENABLED,
   DEFAULT_ANALYTICS_LOOKBACK_DAYS: () => DEFAULT_ANALYTICS_LOOKBACK_DAYS,
@@ -10473,6 +11161,8 @@ __export(dist_exports, {
   DEFAULT_MERGER_REBASE_BEFORE_MERGE: () => DEFAULT_MERGER_REBASE_BEFORE_MERGE,
   DEFAULT_MERGER_SCHEDULE: () => DEFAULT_MERGER_SCHEDULE,
   DEFAULT_MIN_REVIEW_SCORE: () => DEFAULT_MIN_REVIEW_SCORE,
+  DEFAULT_MODEL_ATTRIBUTION: () => DEFAULT_MODEL_ATTRIBUTION,
+  DEFAULT_NEW_PR_LABEL: () => DEFAULT_NEW_PR_LABEL,
   DEFAULT_NOTIFICATIONS: () => DEFAULT_NOTIFICATIONS,
   DEFAULT_PRD_DIR: () => DEFAULT_PRD_DIR,
   DEFAULT_PRD_PRIORITY: () => DEFAULT_PRD_PRIORITY,
@@ -10516,6 +11206,16 @@ __export(dist_exports, {
   DEFAULT_SLICER_SCHEDULE: () => DEFAULT_SLICER_SCHEDULE,
   DEFAULT_SUMMARY_WINDOW_HOURS: () => DEFAULT_SUMMARY_WINDOW_HOURS,
   DEFAULT_TEMPLATES_DIR: () => DEFAULT_TEMPLATES_DIR,
+  DEFAULT_UX: () => DEFAULT_UX,
+  DEFAULT_UX_AUTO_INSTALL_PLAYWRIGHT: () => DEFAULT_UX_AUTO_INSTALL_PLAYWRIGHT,
+  DEFAULT_UX_BASE_URL: () => DEFAULT_UX_BASE_URL,
+  DEFAULT_UX_ENABLED: () => DEFAULT_UX_ENABLED,
+  DEFAULT_UX_MAX_ISSUES: () => DEFAULT_UX_MAX_ISSUES,
+  DEFAULT_UX_MAX_RUNTIME: () => DEFAULT_UX_MAX_RUNTIME,
+  DEFAULT_UX_REPORT_PROMPT: () => DEFAULT_UX_REPORT_PROMPT,
+  DEFAULT_UX_SCHEDULE: () => DEFAULT_UX_SCHEDULE,
+  DEFAULT_UX_START_URL: () => DEFAULT_UX_START_URL,
+  DEFAULT_UX_TARGET_COLUMN: () => DEFAULT_UX_TARGET_COLUMN,
   DEFAULT_WEBHOOK_TRIGGERS: () => DEFAULT_WEBHOOK_TRIGGERS,
   DEFAULT_WEBHOOK_TRIGGER_MAX_SKEW_SECONDS: () => DEFAULT_WEBHOOK_TRIGGER_MAX_SKEW_SECONDS,
   DEFAULT_WEBHOOK_TRIGGER_SECRET_ENV: () => DEFAULT_WEBHOOK_TRIGGER_SECRET_ENV,
@@ -10556,6 +11256,10 @@ __export(dist_exports, {
   STATE_DB_FILE_NAME: () => STATE_DB_FILE_NAME,
   SqliteKanbanIssueRepository: () => SqliteKanbanIssueRepository,
   SqliteSessionOutcomeRepository: () => SqliteSessionOutcomeRepository,
+  TELEMETRY_ERROR_CATEGORIES: () => TELEMETRY_ERROR_CATEGORIES,
+  TELEMETRY_EVENT_NAMES: () => TELEMETRY_EVENT_NAMES,
+  TELEMETRY_FILE_NAME: () => TELEMETRY_FILE_NAME,
+  UX_LOG_NAME: () => UX_LOG_NAME,
   VALID_CLAUDE_MODELS: () => VALID_CLAUDE_MODELS,
   VALID_JOB_TYPES: () => VALID_JOB_TYPES,
   VALID_MERGE_METHODS: () => VALID_MERGE_METHODS,
@@ -10573,6 +11277,8 @@ __export(dist_exports, {
   buildManagerDraftTitle: () => buildManagerDraftTitle,
   buildProjectFeedbackPromptBlock: () => buildProjectFeedbackPromptBlock,
   buildSessionOutcomeInput: () => buildSessionOutcomeInput,
+  buildUxAuditPrompt: () => buildUxAuditPrompt,
+  buildUxReportBody: () => buildUxReportBody,
   calculateStringSimilarity: () => calculateStringSimilarity,
   camelToUpperSnake: () => camelToUpperSnake,
   canStartJob: () => canStartJob,
@@ -10688,6 +11394,8 @@ __export(dist_exports, {
   getStateFilePath: () => getStateFilePath,
   getStateItem: () => getStateItem,
   getSummaryData: () => getSummaryData,
+  getTelemetryConfigPath: () => getTelemetryConfigPath,
+  getTelemetryEffectiveState: () => getTelemetryEffectiveState,
   getUncheckedItems: () => getUncheckedItems,
   getValidJobTypes: () => getValidJobTypes,
   groupBySection: () => groupBySection2,
@@ -10696,6 +11404,7 @@ __export(dist_exports, {
   header: () => header,
   info: () => info,
   initContainer: () => initContainer,
+  isAllowedTelemetryEventName: () => isAllowedTelemetryEventName,
   isContainerInitialized: () => isContainerInitialized,
   isFeedbackPromptEnabled: () => isFeedbackPromptEnabled,
   isInCooldown: () => isInCooldown,
@@ -10704,6 +11413,7 @@ __export(dist_exports, {
   isKnownFinding: () => isKnownFinding,
   isProcessAliveSince: () => isProcessAliveSince,
   isProcessRunning: () => isProcessRunning,
+  isTelemetryEnvDisabled: () => isTelemetryEnvDisabled,
   isValidCategory: () => isValidCategory,
   isValidHorizon: () => isValidHorizon,
   isValidPriority: () => isValidPriority,
@@ -10715,24 +11425,29 @@ __export(dist_exports, {
   loadGlobalNotificationsConfig: () => loadGlobalNotificationsConfig,
   loadHistory: () => loadHistory,
   loadManagerMemory: () => loadManagerMemory,
+  loadOrCreateTelemetryConfig: () => loadOrCreateTelemetryConfig,
   loadRegistry: () => loadRegistry,
   loadRoadmapState: () => loadRoadmapState,
   loadSlicerTemplate: () => loadSlicerTemplate,
   managerLockPath: () => managerLockPath,
+  mapTelemetryErrorCategory: () => mapTelemetryErrorCategory,
   markItemProcessed: () => markItemProcessed,
   markJobRunning: () => markJobRunning,
   markPrdDone: () => markPrdDone,
+  markTelemetryNoticeShown: () => markTelemetryNoticeShown,
   mergerLockPath: () => mergerLockPath,
   migrateJsonToSqlite: () => migrateJsonToSqlite,
   normalizeAuditSeverity: () => normalizeAuditSeverity,
   normalizeJobConfig: () => normalizeJobConfig,
   normalizeSchedulingPriority: () => normalizeSchedulingPriority,
+  normalizeUxPriority: () => normalizeUxPriority,
   parseAuditFindings: () => parseAuditFindings,
   parseConfigValue: () => parseConfigValue,
   parsePrdDependencies: () => parsePrdDependencies,
   parseRoadmap: () => parseRoadmap,
   parseScriptResult: () => parseScriptResult,
   parseTimeToMinutes: () => parseTimeToMinutes,
+  parseUxFindings: () => parseUxFindings,
   performCancel: () => performCancel,
   plannerLockPath: () => plannerLockPath,
   prResolverLockPath: () => prResolverLockPath,
@@ -10770,6 +11485,8 @@ __export(dist_exports, {
   runAnalytics: () => runAnalytics,
   runManager: () => runManager,
   runMigrations: () => runMigrations,
+  runUx: () => runUx,
+  sanitizeTelemetryEvent: () => sanitizeTelemetryEvent,
   saveConfig: () => saveConfig,
   saveGlobalNotificationsConfig: () => saveGlobalNotificationsConfig,
   saveHistory: () => saveHistory,
@@ -10780,19 +11497,23 @@ __export(dist_exports, {
   sendNotifications: () => sendNotifications,
   sendWebhook: () => sendWebhook,
   setConfigValue: () => setConfigValue,
+  setTelemetryEnabled: () => setTelemetryEnabled,
   sleep: () => sleep,
   sliceNextItem: () => sliceNextItem,
   sliceRoadmapItem: () => sliceRoadmapItem,
   slugify: () => slugify,
   sortByPriority: () => sortByPriority,
+  sortUxFindings: () => sortUxFindings,
   step: () => step,
   success: () => success,
   summarizeCreatedDrafts: () => summarizeCreatedDrafts,
   summarizeSkippedFindings: () => summarizeSkippedFindings,
   syncAuditFindingsToBoard: () => syncAuditFindingsToBoard,
+  trackTelemetryEvent: () => trackTelemetryEvent,
   unmarkItemProcessed: () => unmarkItemProcessed,
   unregisterProject: () => unregisterProject,
   updateJobStatus: () => updateJobStatus,
+  uxLockPath: () => uxLockPath,
   validateProvider: () => validateProvider,
   validateRegistry: () => validateRegistry,
   validateWebhook: () => validateWebhook,
@@ -10848,7 +11569,9 @@ var init_dist = __esm({
     init_job_queue();
     init_summary();
     init_analytics();
+    init_telemetry();
     init_audit();
+    init_ux();
     init_manager();
     init_outcome_parser();
     init_pattern_analyzer();
@@ -10862,30 +11585,99 @@ var init_dist = __esm({
 // src/cli.ts
 import "reflect-metadata";
 import { Command as Command3 } from "commander";
-import { existsSync as existsSync36, readFileSync as readFileSync23 } from "fs";
+import { existsSync as existsSync37, readFileSync as readFileSync24 } from "fs";
 import { fileURLToPath as fileURLToPath6 } from "url";
-import { dirname as dirname13, join as join39 } from "path";
+import { dirname as dirname14, join as join41 } from "path";
 
 // src/commands/init.ts
 init_dist();
-import fs26 from "fs";
-import path25 from "path";
+import fs28 from "fs";
+import path27 from "path";
 import { execSync as execSync3 } from "child_process";
 import { fileURLToPath as fileURLToPath3 } from "url";
-import { dirname as dirname7, join as join21 } from "path";
+import { dirname as dirname8, join as join23 } from "path";
 import * as readline from "readline";
-var __filename2 = fileURLToPath3(import.meta.url);
-var __dirname2 = dirname7(__filename2);
-function findTemplatesDir(startDir) {
-  let d = startDir;
-  for (let i = 0; i < 8; i++) {
-    const candidate = join21(d, "templates");
-    if (fs26.existsSync(candidate) && fs26.statSync(candidate).isDirectory()) {
-      return candidate;
-    }
-    d = dirname7(d);
-  }
-  return join21(startDir, "templates");
+
+// src/commands/shared/telemetry.ts
+init_dist();
+var cliVersion = "unknown";
+var telemetryReporter = (eventName, properties) => trackTelemetryEvent(eventName, properties);
+function setCliTelemetryVersion(version) {
+  cliVersion = version;
+}
+function getNodeMajorVersion() {
+  const major = parseInt(process.versions.node.split(".")[0] ?? "0", 10);
+  return Number.isNaN(major) ? 0 : major;
+}
+function getRegisteredProjectCount() {
+  try {
+    return validateRegistry().valid.length;
+  } catch {
+    return 0;
+  }
+}
+function buildTelemetryBaseProperties(config) {
+  return {
+    cliVersion,
+    platform: process.platform,
+    nodeMajorVersion: getNodeMajorVersion(),
+    boardMode: config ? config.boardProvider?.enabled !== false : void 0,
+    registeredProjectCount: getRegisteredProjectCount()
+  };
+}
+function fireTelemetryEvent(eventName, properties = {}) {
+  void telemetryReporter(eventName, properties).catch(() => void 0);
+}
+async function trackCommandStarted(command, config) {
+  await telemetryReporter("command_started", {
+    ...buildTelemetryBaseProperties(config),
+    command
+  }).catch(() => void 0);
+}
+async function trackCommandCompleted(command, startedAt, exitCode, config, extraProps = {}) {
+  await telemetryReporter("command_completed", {
+    ...buildTelemetryBaseProperties(config),
+    ...extraProps,
+    command,
+    durationMs: Math.max(0, Date.now() - startedAt),
+    exitCode,
+    success: exitCode === 0,
+    failure: exitCode !== 0
+  }).catch(() => void 0);
+}
+async function trackJobStarted(jobType, provider, config) {
+  await telemetryReporter("job_started", {
+    ...buildTelemetryBaseProperties(config),
+    jobType,
+    provider
+  }).catch(() => void 0);
+}
+async function trackJobCompletedOrFailed(jobType, provider, startedAt, exitCode, config, errorCategory) {
+  await telemetryReporter(exitCode === 0 ? "job_completed" : "job_failed", {
+    ...buildTelemetryBaseProperties(config),
+    jobType,
+    provider,
+    durationMs: Math.max(0, Date.now() - startedAt),
+    exitCode,
+    success: exitCode === 0,
+    failure: exitCode !== 0,
+    errorCategory: exitCode === 0 ? void 0 : mapTelemetryErrorCategory(errorCategory)
+  }).catch(() => void 0);
+}
+
+// src/commands/init.ts
+var __filename2 = fileURLToPath3(import.meta.url);
+var __dirname2 = dirname8(__filename2);
+function findTemplatesDir(startDir) {
+  let d = startDir;
+  for (let i = 0; i < 8; i++) {
+    const candidate = join23(d, "templates");
+    if (fs28.existsSync(candidate) && fs28.statSync(candidate).isDirectory()) {
+      return candidate;
+    }
+    d = dirname8(d);
+  }
+  return join23(startDir, "templates");
 }
 var TEMPLATES_DIR = findTemplatesDir(__dirname2);
 var NW_SKILLS = [
@@ -10897,12 +11689,12 @@ var NW_SKILLS = [
   "nw-review"
 ];
 function hasPlaywrightDependency(cwd) {
-  const packageJsonPath = path25.join(cwd, "package.json");
-  if (!fs26.existsSync(packageJsonPath)) {
+  const packageJsonPath = path27.join(cwd, "package.json");
+  if (!fs28.existsSync(packageJsonPath)) {
     return false;
   }
   try {
-    const packageJson2 = JSON.parse(fs26.readFileSync(packageJsonPath, "utf-8"));
+    const packageJson2 = JSON.parse(fs28.readFileSync(packageJsonPath, "utf-8"));
     return Boolean(
       packageJson2.dependencies?.["@playwright/test"] || packageJson2.dependencies?.playwright || packageJson2.devDependencies?.["@playwright/test"] || packageJson2.devDependencies?.playwright
     );
@@ -10914,7 +11706,7 @@ function detectPlaywright(cwd) {
   if (hasPlaywrightDependency(cwd)) {
     return true;
   }
-  if (fs26.existsSync(path25.join(cwd, "node_modules", ".bin", "playwright"))) {
+  if (fs28.existsSync(path27.join(cwd, "node_modules", ".bin", "playwright"))) {
     return true;
   }
   try {
@@ -10930,10 +11722,10 @@ function detectPlaywright(cwd) {
   }
 }
 function resolvePlaywrightInstallCommand(cwd) {
-  if (fs26.existsSync(path25.join(cwd, "pnpm-lock.yaml"))) {
+  if (fs28.existsSync(path27.join(cwd, "pnpm-lock.yaml"))) {
     return "pnpm add -D @playwright/test";
   }
-  if (fs26.existsSync(path25.join(cwd, "yarn.lock"))) {
+  if (fs28.existsSync(path27.join(cwd, "yarn.lock"))) {
     return "yarn add -D @playwright/test";
   }
   return "npm install -D @playwright/test";
@@ -11079,8 +11871,8 @@ function promptProviderSelection(providers) {
   });
 }
 function ensureDir(dirPath) {
-  if (!fs26.existsSync(dirPath)) {
-    fs26.mkdirSync(dirPath, { recursive: true });
+  if (!fs28.existsSync(dirPath)) {
+    fs28.mkdirSync(dirPath, { recursive: true });
   }
 }
 function buildInitConfig(params) {
@@ -11107,6 +11899,8 @@ function buildInitConfig(params) {
     reviewerRetryDelay: defaults.reviewerRetryDelay,
     provider: params.provider,
     providerLabel: "",
+    modelAttribution: defaults.modelAttribution,
+    newPrLabel: defaults.newPrLabel,
     executorEnabled: defaults.executorEnabled ?? true,
     reviewerEnabled: params.reviewerEnabled,
     providerEnv: { ...defaults.providerEnv },
@@ -11129,6 +11923,10 @@ function buildInitConfig(params) {
       branchPatterns: [...defaults.qa.branchPatterns]
     },
     audit: { ...defaults.audit },
+    ux: {
+      ...defaults.ux,
+      flows: [...defaults.ux.flows]
+    },
     analytics: { ...defaults.analytics },
     manager: { ...defaults.manager },
     feedback: { ...defaults.feedback },
@@ -11155,30 +11953,30 @@ function buildInitConfig(params) {
 }
 function resolveTemplatePath(templateName, customTemplatesDir, bundledTemplatesDir) {
   if (customTemplatesDir !== null) {
-    const customPath = join21(customTemplatesDir, templateName);
-    if (fs26.existsSync(customPath)) {
+    const customPath = join23(customTemplatesDir, templateName);
+    if (fs28.existsSync(customPath)) {
       return { path: customPath, source: "custom" };
     }
   }
-  return { path: join21(bundledTemplatesDir, templateName), source: "bundled" };
+  return { path: join23(bundledTemplatesDir, templateName), source: "bundled" };
 }
 function processTemplate(templateName, targetPath, replacements, force, sourcePath, source) {
-  if (fs26.existsSync(targetPath) && !force) {
+  if (fs28.existsSync(targetPath) && !force) {
     console.log(`  Skipped (exists): ${targetPath}`);
     return { created: false, source: source ?? "bundled" };
   }
-  const templatePath = sourcePath ?? join21(TEMPLATES_DIR, templateName);
+  const templatePath = sourcePath ?? join23(TEMPLATES_DIR, templateName);
   const resolvedSource = source ?? "bundled";
-  let content = fs26.readFileSync(templatePath, "utf-8");
+  let content = fs28.readFileSync(templatePath, "utf-8");
   for (const [key, value] of Object.entries(replacements)) {
     content = content.replaceAll(key, value);
   }
-  fs26.writeFileSync(targetPath, content);
+  fs28.writeFileSync(targetPath, content);
   console.log(`  Created: ${targetPath} (${resolvedSource})`);
   return { created: true, source: resolvedSource };
 }
 function addToGitignore(cwd) {
-  const gitignorePath = path25.join(cwd, ".gitignore");
+  const gitignorePath = path27.join(cwd, ".gitignore");
   const entries = [
     {
       pattern: "/logs/",
@@ -11192,13 +11990,13 @@ function addToGitignore(cwd) {
     },
     { pattern: "*.claim", label: "*.claim", check: (c) => c.includes("*.claim") }
   ];
-  if (!fs26.existsSync(gitignorePath)) {
+  if (!fs28.existsSync(gitignorePath)) {
     const lines = ["# Night Watch", ...entries.map((e) => e.pattern), ""];
-    fs26.writeFileSync(gitignorePath, lines.join("\n"));
+    fs28.writeFileSync(gitignorePath, lines.join("\n"));
     console.log(`  Created: ${gitignorePath} (with Night Watch entries)`);
     return;
   }
-  const content = fs26.readFileSync(gitignorePath, "utf-8");
+  const content = fs28.readFileSync(gitignorePath, "utf-8");
   const missing = entries.filter((e) => !e.check(content));
   if (missing.length === 0) {
     console.log(`  Skipped (exists): Night Watch entries in .gitignore`);
@@ -11206,59 +12004,59 @@ function addToGitignore(cwd) {
   }
   const additions = missing.map((e) => e.pattern).join("\n");
   const newContent = content.trimEnd() + "\n\n# Night Watch\n" + additions + "\n";
-  fs26.writeFileSync(gitignorePath, newContent);
+  fs28.writeFileSync(gitignorePath, newContent);
   console.log(`  Updated: ${gitignorePath} (added ${missing.map((e) => e.label).join(", ")})`);
 }
 function installSkills(cwd, provider, force, templatesDir) {
-  const skillsTemplatesDir = path25.join(templatesDir, "skills");
-  if (!fs26.existsSync(skillsTemplatesDir)) {
+  const skillsTemplatesDir = path27.join(templatesDir, "skills");
+  if (!fs28.existsSync(skillsTemplatesDir)) {
     return { location: "", installed: 0, skipped: 0, type: "none" };
   }
   const isClaudeProvider = provider === "claude" || provider.startsWith("claude");
   const isCodexProvider = provider === "codex";
-  const claudeDir = path25.join(cwd, ".claude");
-  if (isClaudeProvider || fs26.existsSync(claudeDir)) {
+  const claudeDir = path27.join(cwd, ".claude");
+  if (isClaudeProvider || fs28.existsSync(claudeDir)) {
     ensureDir(claudeDir);
-    const skillsDir = path25.join(claudeDir, "skills");
+    const skillsDir = path27.join(claudeDir, "skills");
     ensureDir(skillsDir);
     let installed = 0;
     let skipped = 0;
     for (const skillName of NW_SKILLS) {
-      const templateFile = path25.join(skillsTemplatesDir, `${skillName}.md`);
-      if (!fs26.existsSync(templateFile)) continue;
-      const skillDir = path25.join(skillsDir, skillName);
+      const templateFile = path27.join(skillsTemplatesDir, `${skillName}.md`);
+      if (!fs28.existsSync(templateFile)) continue;
+      const skillDir = path27.join(skillsDir, skillName);
       ensureDir(skillDir);
-      const target = path25.join(skillDir, "SKILL.md");
-      if (fs26.existsSync(target) && !force) {
+      const target = path27.join(skillDir, "SKILL.md");
+      if (fs28.existsSync(target) && !force) {
         skipped++;
         continue;
       }
-      fs26.copyFileSync(templateFile, target);
+      fs28.copyFileSync(templateFile, target);
       installed++;
     }
     return { location: ".claude/skills/", installed, skipped, type: "claude" };
   }
   if (isCodexProvider) {
-    const agentsFile = path25.join(cwd, "AGENTS.md");
-    const blockFile = path25.join(skillsTemplatesDir, "_codex-block.md");
-    if (!fs26.existsSync(blockFile)) {
+    const agentsFile = path27.join(cwd, "AGENTS.md");
+    const blockFile = path27.join(skillsTemplatesDir, "_codex-block.md");
+    if (!fs28.existsSync(blockFile)) {
       return { location: "", installed: 0, skipped: 0, type: "none" };
     }
-    const block = fs26.readFileSync(blockFile, "utf-8");
+    const block = fs28.readFileSync(blockFile, "utf-8");
     const marker = "## Night Watch Skills";
-    if (!fs26.existsSync(agentsFile)) {
-      fs26.writeFileSync(agentsFile, block);
+    if (!fs28.existsSync(agentsFile)) {
+      fs28.writeFileSync(agentsFile, block);
       return { location: "AGENTS.md", installed: NW_SKILLS.length, skipped: 0, type: "codex" };
     }
-    const existing = fs26.readFileSync(agentsFile, "utf-8");
+    const existing = fs28.readFileSync(agentsFile, "utf-8");
     if (existing.includes(marker)) {
       if (!force) {
         return { location: "AGENTS.md", installed: 0, skipped: NW_SKILLS.length, type: "codex" };
       }
       const withoutSection = existing.replace(/\n\n## Night Watch Skills[\s\S]*$/, "");
-      fs26.writeFileSync(agentsFile, withoutSection + "\n\n" + block);
+      fs28.writeFileSync(agentsFile, withoutSection + "\n\n" + block);
     } else {
-      fs26.appendFileSync(agentsFile, "\n\n" + block);
+      fs28.appendFileSync(agentsFile, "\n\n" + block);
     }
     return { location: "AGENTS.md", installed: NW_SKILLS.length, skipped: 0, type: "codex" };
   }
@@ -11382,28 +12180,28 @@ function initCommand(program2) {
       "${DEFAULT_BRANCH}": defaultBranch
     };
     step(6, totalSteps, "Creating PRD directory structure...");
-    const prdDirPath = path25.join(cwd, prdDir);
-    const doneDirPath = path25.join(prdDirPath, "done");
+    const prdDirPath = path27.join(cwd, prdDir);
+    const doneDirPath = path27.join(prdDirPath, "done");
     ensureDir(doneDirPath);
     success(`Created ${prdDirPath}/`);
     success(`Created ${doneDirPath}/`);
     step(7, totalSteps, "Creating logs directory...");
-    const logsPath = path25.join(cwd, LOG_DIR);
+    const logsPath = path27.join(cwd, LOG_DIR);
     ensureDir(logsPath);
     success(`Created ${logsPath}/`);
     addToGitignore(cwd);
     step(8, totalSteps, "Creating instructions directory...");
-    const instructionsDir = path25.join(cwd, "instructions");
+    const instructionsDir = path27.join(cwd, "instructions");
     ensureDir(instructionsDir);
     success(`Created ${instructionsDir}/`);
     const existingConfig = loadConfig(cwd);
-    const customTemplatesDirPath = path25.join(cwd, existingConfig.templatesDir);
-    const customTemplatesDir = fs26.existsSync(customTemplatesDirPath) ? customTemplatesDirPath : null;
+    const customTemplatesDirPath = path27.join(cwd, existingConfig.templatesDir);
+    const customTemplatesDir = fs28.existsSync(customTemplatesDirPath) ? customTemplatesDirPath : null;
     const templateSources = [];
     const nwResolution = resolveTemplatePath("executor.md", customTemplatesDir, TEMPLATES_DIR);
     const nwResult = processTemplate(
       "executor.md",
-      path25.join(instructionsDir, "executor.md"),
+      path27.join(instructionsDir, "executor.md"),
       replacements,
       force,
       nwResolution.path,
@@ -11417,7 +12215,7 @@ function initCommand(program2) {
     );
     const peResult = processTemplate(
       "prd-executor.md",
-      path25.join(instructionsDir, "prd-executor.md"),
+      path27.join(instructionsDir, "prd-executor.md"),
       replacements,
       force,
       peResolution.path,
@@ -11427,7 +12225,7 @@ function initCommand(program2) {
     const prResolution = resolveTemplatePath("pr-reviewer.md", customTemplatesDir, TEMPLATES_DIR);
     const prResult = processTemplate(
       "pr-reviewer.md",
-      path25.join(instructionsDir, "pr-reviewer.md"),
+      path27.join(instructionsDir, "pr-reviewer.md"),
       replacements,
       force,
       prResolution.path,
@@ -11437,7 +12235,7 @@ function initCommand(program2) {
     const qaResolution = resolveTemplatePath("qa.md", customTemplatesDir, TEMPLATES_DIR);
     const qaResult = processTemplate(
       "qa.md",
-      path25.join(instructionsDir, "qa.md"),
+      path27.join(instructionsDir, "qa.md"),
       replacements,
       force,
       qaResolution.path,
@@ -11447,7 +12245,7 @@ function initCommand(program2) {
     const auditResolution = resolveTemplatePath("audit.md", customTemplatesDir, TEMPLATES_DIR);
     const auditResult = processTemplate(
       "audit.md",
-      path25.join(instructionsDir, "audit.md"),
+      path27.join(instructionsDir, "audit.md"),
       replacements,
       force,
       auditResolution.path,
@@ -11461,7 +12259,7 @@ function initCommand(program2) {
     );
     const plannerResult = processTemplate(
       "prd-creator.md",
-      path25.join(instructionsDir, "prd-creator.md"),
+      path27.join(instructionsDir, "prd-creator.md"),
       replacements,
       force,
       plannerResolution.path,
@@ -11469,8 +12267,8 @@ function initCommand(program2) {
     );
     templateSources.push({ name: "prd-creator.md", source: plannerResult.source });
     step(9, totalSteps, "Creating configuration file...");
-    const configPath = path25.join(cwd, CONFIG_FILE_NAME);
-    if (fs26.existsSync(configPath) && !force) {
+    const configPath = path27.join(cwd, CONFIG_FILE_NAME);
+    if (fs28.existsSync(configPath) && !force) {
       console.log(`  Skipped (exists): ${configPath}`);
     } else {
       const config = buildInitConfig({
@@ -11480,11 +12278,11 @@ function initCommand(program2) {
         reviewerEnabled,
         prdDir
       });
-      fs26.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+      fs28.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
       success(`Created ${configPath}`);
     }
     step(10, totalSteps, "Setting up GitHub Project board...");
-    const existingRaw = JSON.parse(fs26.readFileSync(configPath, "utf-8"));
+    const existingRaw = JSON.parse(fs28.readFileSync(configPath, "utf-8"));
     const existingBoard = existingRaw.boardProvider;
     let boardSetupStatus = "Skipped";
     if (existingBoard?.projectNumber && !force) {
@@ -11506,14 +12304,14 @@ function initCommand(program2) {
           const provider = createBoardProvider({ enabled: true, provider: "github" }, cwd);
           const boardTitle = `${projectName} Night Watch`;
           const board = await provider.setupBoard(boardTitle);
-          const rawConfig = JSON.parse(fs26.readFileSync(configPath, "utf-8"));
+          const rawConfig = JSON.parse(fs28.readFileSync(configPath, "utf-8"));
           rawConfig.boardProvider = {
             enabled: true,
             provider: "github",
             projectNumber: board.number,
             projectTitle: board.title
           };
-          fs26.writeFileSync(configPath, JSON.stringify(rawConfig, null, 2) + "\n");
+          fs28.writeFileSync(configPath, JSON.stringify(rawConfig, null, 2) + "\n");
           boardSetupStatus = `Created (#${board.number})`;
           success(`GitHub Project board "${boardTitle}" ready (#${board.number})`);
         } catch (boardErr) {
@@ -11605,6 +12403,12 @@ function initCommand(program2) {
     label("Reviewer", reviewerEnabled ? "Enabled" : "Disabled");
     label("Playwright", playwrightStatus);
     console.log();
+    fireTelemetryEvent("cli_init_completed", {
+      command: "init",
+      provider: selectedProvider,
+      boardMode: existingRaw.boardProvider?.enabled !== false,
+      success: true
+    });
     header("Next Steps");
     info(`1. Add your PRD files to ${prdDir}/`);
     info("2. Run `night-watch install` to set up cron jobs");
@@ -11739,8 +12543,8 @@ function recordJobOutcome(input) {
 }
 
 // src/commands/run.ts
-import * as fs27 from "fs";
-import * as path26 from "path";
+import * as fs29 from "fs";
+import * as path28 from "path";
 function resolveRunNotificationEvent(exitCode, scriptStatus) {
   if (exitCode === 124) {
     return "run_timeout";
@@ -11838,7 +12642,7 @@ function buildRunNotificationContext(config, projectDir, event, exitCode, script
   const checkpointStatus = checkpointValue === "created" || checkpointValue === "available" || checkpointValue === "none" ? checkpointValue : void 0;
   return {
     event,
-    projectName: path26.basename(projectDir),
+    projectName: path28.basename(projectDir),
     exitCode,
     provider: config.provider,
     prdName: scriptResult?.data.prd ?? extractResultValueFromOutput(rawOutput, "prd"),
@@ -11858,12 +12662,12 @@ function buildRunNotificationContext(config, projectDir, event, exitCode, script
   };
 }
 function getCrossProjectFallbackCandidates(currentProjectDir) {
-  const current = path26.resolve(currentProjectDir);
+  const current = path28.resolve(currentProjectDir);
   const { valid, invalid } = validateRegistry();
   for (const entry of invalid) {
     warn(`Skipping invalid registry entry: ${entry.path}`);
   }
-  return valid.filter((entry) => path26.resolve(entry.path) !== current);
+  return valid.filter((entry) => path28.resolve(entry.path) !== current);
 }
 async function sendRunCompletionNotifications(config, projectDir, options, exitCode, scriptResult, rawOutput) {
   if (isRateLimitFallbackTriggered(scriptResult?.data)) {
@@ -11873,7 +12677,7 @@ async function sendRunCompletionNotifications(config, projectDir, options, exitC
     if (nonTelegramWebhooks.length > 0) {
       const _rateLimitCtx = {
         event: "rate_limit_fallback",
-        projectName: path26.basename(projectDir),
+        projectName: path28.basename(projectDir),
         exitCode,
         provider: config.provider
       };
@@ -12033,6 +12837,8 @@ function buildEnvVars(config, options) {
   }
   env.NW_PRD_DIR = config.prdDir;
   env.NW_BRANCH_PREFIX = config.branchPrefix;
+  env.NW_MODEL_ATTRIBUTION_ENABLED = config.modelAttribution ? "1" : "0";
+  env.NW_NEW_PR_LABEL = config.newPrLabel ?? "draft";
   if (config.prdPriority && config.prdPriority.length > 0) {
     env.NW_PRD_PRIORITY = config.prdPriority.join(":");
   }
@@ -12111,20 +12917,20 @@ function applyCliOverrides(config, options) {
 }
 function scanPrdDirectory(projectDir, prdDir, maxRuntime) {
   const claimStaleAfter = maxRuntime > 0 ? maxRuntime : 14400;
-  const absolutePrdDir = path26.join(projectDir, prdDir);
-  const doneDir = path26.join(absolutePrdDir, "done");
+  const absolutePrdDir = path28.join(projectDir, prdDir);
+  const doneDir = path28.join(absolutePrdDir, "done");
   const pending = [];
   const completed = [];
-  if (fs27.existsSync(absolutePrdDir)) {
-    const entries = fs27.readdirSync(absolutePrdDir, { withFileTypes: true });
+  if (fs29.existsSync(absolutePrdDir)) {
+    const entries = fs29.readdirSync(absolutePrdDir, { withFileTypes: true });
     for (const entry of entries) {
       if (entry.isFile() && entry.name.endsWith(".md")) {
-        const claimPath = path26.join(absolutePrdDir, entry.name + CLAIM_FILE_EXTENSION);
+        const claimPath = path28.join(absolutePrdDir, entry.name + CLAIM_FILE_EXTENSION);
         let claimed = false;
         let claimInfo = null;
-        if (fs27.existsSync(claimPath)) {
+        if (fs29.existsSync(claimPath)) {
           try {
-            const content = fs27.readFileSync(claimPath, "utf-8");
+            const content = fs29.readFileSync(claimPath, "utf-8");
             const data = JSON.parse(content);
             const age = Math.floor(Date.now() / 1e3) - data.timestamp;
             if (age < claimStaleAfter) {
@@ -12138,8 +12944,8 @@ function scanPrdDirectory(projectDir, prdDir, maxRuntime) {
       }
     }
   }
-  if (fs27.existsSync(doneDir)) {
-    const entries = fs27.readdirSync(doneDir, { withFileTypes: true });
+  if (fs29.existsSync(doneDir)) {
+    const entries = fs29.readdirSync(doneDir, { withFileTypes: true });
     for (const entry of entries) {
       if (entry.isFile() && entry.name.endsWith(".md")) {
         completed.push(entry.name);
@@ -12159,8 +12965,11 @@ function runCommand(program2) {
     const projectDir = process.cwd();
     let config = loadConfig(projectDir);
     config = applyCliOverrides(config, options);
+    const commandStartedAt = Date.now();
+    await trackCommandStarted("run", config);
     if (config.executorEnabled === false && !options.dryRun) {
       info("Executor is disabled in config; skipping run.");
+      await trackCommandCompleted("run", commandStartedAt, 0, config);
       process.exit(0);
     }
     const envVars = buildEnvVars(config, options);
@@ -12252,12 +13061,15 @@ function runCommand(program2) {
       header("Command");
       dim(`  bash ${scriptPath} ${projectDir}`);
       console.log();
+      await trackCommandCompleted("run", commandStartedAt, 0, config);
       process.exit(0);
     }
     const spinner = createSpinner("Running PRD executor...");
     spinner.start();
     try {
       const startedAt = Date.now();
+      const provider = envVars.NW_PROVIDER_KEY ?? resolveJobProvider(config, "executor");
+      await trackJobStarted("executor", provider, config);
       await maybeApplyCronSchedulingDelay(config, "executor", projectDir);
       const { exitCode, stdout, stderr } = await executeScriptWithOutput(
         scriptPath,
@@ -12268,6 +13080,14 @@ function runCommand(program2) {
       const finishedAt = Date.now();
       const scriptResult = parseScriptResult(`${stdout}
 ${stderr}`);
+      await trackJobCompletedOrFailed(
+        "executor",
+        provider,
+        startedAt,
+        exitCode,
+        config,
+        scriptResult?.status
+      );
       if (exitCode === 0) {
         if (scriptResult?.status === "queued") {
           spinner.succeed("PRD executor queued \u2014 another job is currently running");
@@ -12306,16 +13126,29 @@ ${stderr}`);
 ${stderr}`
         );
       }
+      if (exitCode === 0 && (scriptResult?.status === "success_open_pr" || getRunPrMetadata(scriptResult, `${stdout}
+${stderr}`).prUrl)) {
+        fireTelemetryEvent("pr_opened", {
+          ...buildTelemetryBaseProperties(config),
+          jobType: "executor",
+          provider,
+          success: true
+        });
+      }
       if (shouldAttemptCrossProjectFallback(options, scriptResult?.status)) {
         const executedFallback = await runCrossProjectFallback(projectDir, options);
         if (!executedFallback) {
           info("Cross-project fallback: no eligible work found in other registered projects");
         }
       }
+      await trackCommandCompleted("run", commandStartedAt, exitCode, config);
       process.exit(exitCode);
     } catch (err) {
       spinner.fail("Failed to execute run command");
       error(`${err instanceof Error ? err.message : String(err)}`);
+      await trackCommandCompleted("run", commandStartedAt, 1, config, {
+        errorCategory: err instanceof Error ? err.message : String(err)
+      });
       process.exit(1);
     }
   });
@@ -12324,7 +13157,7 @@ ${stderr}`
 // src/commands/review.ts
 init_dist();
 import { execFileSync as execFileSync5 } from "child_process";
-import * as path27 from "path";
+import * as path29 from "path";
 function shouldSendReviewNotification(scriptStatus) {
   if (!scriptStatus) {
     return true;
@@ -12497,8 +13330,11 @@ function reviewCommand(program2) {
     const projectDir = process.cwd();
     let config = loadConfig(projectDir);
     config = applyCliOverrides2(config, options);
+    const commandStartedAt = Date.now();
+    await trackCommandStarted("review", config);
     if (!config.reviewerEnabled && !options.dryRun) {
       info("Reviewer is disabled in config; skipping review.");
+      await trackCommandCompleted("review", commandStartedAt, 0, config);
       process.exit(0);
     }
     const envVars = buildEnvVars2(config, options);
@@ -12547,6 +13383,7 @@ function reviewCommand(program2) {
       header("Command");
       dim(`  bash ${scriptPath} ${projectDir}`);
       console.log();
+      await trackCommandCompleted("review", commandStartedAt, 0, config);
       process.exit(0);
     }
     const preflightOpenPrs = getOpenPrsNeedingWork(config.branchPatterns);
@@ -12568,6 +13405,8 @@ function reviewCommand(program2) {
     spinner.start();
     try {
       const startedAt = Date.now();
+      const provider = envVars.NW_PROVIDER_KEY ?? resolveJobProvider(config, "reviewer");
+      await trackJobStarted("reviewer", provider, config);
       await maybeApplyCronSchedulingDelay(config, "reviewer", projectDir);
       const { exitCode, stdout, stderr } = await executeScriptWithOutput(
         scriptPath,
@@ -12577,6 +13416,14 @@ function reviewCommand(program2) {
       const finishedAt = Date.now();
       const scriptResult = parseScriptResult(`${stdout}
 ${stderr}`);
+      await trackJobCompletedOrFailed(
+        "reviewer",
+        provider,
+        startedAt,
+        exitCode,
+        config,
+        scriptResult?.status
+      );
       if (exitCode === 0) {
         if (scriptResult?.status === "queued") {
           spinner.succeed("PR reviewer queued \u2014 another job is currently running");
@@ -12620,6 +13467,13 @@ ${stderr}`);
         );
         if (!shouldNotifyCompletion) {
           info("Skipping review completion notification (review did not complete successfully)");
+        } else {
+          fireTelemetryEvent("review_completed", {
+            ...buildTelemetryBaseProperties(config),
+            jobType: "reviewer",
+            provider,
+            success: true
+          });
         }
         let fallbackPrDetails = null;
         if (shouldNotifyCompletion) {
@@ -12652,7 +13506,7 @@ ${stderr}`);
             const reviewEvent = legacyNoChangesNeeded ? "review_ready_for_human" : "review_completed";
             await sendNotifications(config, {
               event: reviewEvent,
-              projectName: path27.basename(projectDir),
+              projectName: path29.basename(projectDir),
               exitCode,
               provider: formatProviderDisplay(envVars.NW_PROVIDER_CMD, envVars.NW_PROVIDER_LABEL),
               prUrl: fallbackPrDetails?.url,
@@ -12671,7 +13525,7 @@ ${stderr}`);
               const reviewEvent = target.noChangesNeeded ? "review_ready_for_human" : "review_completed";
               await sendNotifications(config, {
                 event: reviewEvent,
-                projectName: path27.basename(projectDir),
+                projectName: path29.basename(projectDir),
                 exitCode,
                 provider: formatProviderDisplay(
                   envVars.NW_PROVIDER_CMD,
@@ -12692,11 +13546,17 @@ ${stderr}`);
         }
         const autoMergedPrNumbers = parseAutoMergedPrNumbers(scriptResult?.data.auto_merged);
         if (autoMergedPrNumbers.length > 0) {
+          fireTelemetryEvent("auto_merge_completed", {
+            ...buildTelemetryBaseProperties(config),
+            jobType: "reviewer",
+            provider,
+            success: true
+          });
           const autoMergedPrNumber = autoMergedPrNumbers[0];
           const autoMergedPrDetails = fetchPrDetailsByNumber(autoMergedPrNumber, projectDir);
           const _mergeCtx = {
             event: "pr_auto_merged",
-            projectName: path27.basename(projectDir),
+            projectName: path29.basename(projectDir),
             exitCode,
             provider: formatProviderDisplay(envVars.NW_PROVIDER_CMD, envVars.NW_PROVIDER_LABEL),
             prNumber: autoMergedPrDetails?.number ?? autoMergedPrNumber,
@@ -12710,10 +13570,14 @@ ${stderr}`);
           await sendNotifications(config, _mergeCtx);
         }
       }
+      await trackCommandCompleted("review", commandStartedAt, exitCode, config);
       process.exit(exitCode);
     } catch (err) {
       spinner.fail("Failed to execute review command");
       error(`${err instanceof Error ? err.message : String(err)}`);
+      await trackCommandCompleted("review", commandStartedAt, 1, config, {
+        errorCategory: err instanceof Error ? err.message : String(err)
+      });
       process.exit(1);
     }
   });
@@ -12721,7 +13585,7 @@ ${stderr}`);
 
 // src/commands/qa.ts
 init_dist();
-import * as path28 from "path";
+import * as path30 from "path";
 function shouldSendQaNotification(scriptStatus) {
   if (!scriptStatus) {
     return true;
@@ -12883,7 +13747,7 @@ ${stderr}`);
           const qaScreenshotUrls = primaryQaPr !== void 0 ? fetchQaScreenshotUrlsForPr(primaryQaPr, projectDir, repo) : [];
           const _qaCtx = {
             event: "qa_completed",
-            projectName: path28.basename(projectDir),
+            projectName: path30.basename(projectDir),
             exitCode,
             provider: formatProviderDisplay(envVars.NW_PROVIDER_CMD, envVars.NW_PROVIDER_LABEL),
             prNumber: prDetails?.number ?? primaryQaPr,
@@ -12909,8 +13773,8 @@ ${stderr}`);
 
 // src/commands/audit.ts
 init_dist();
-import * as fs28 from "fs";
-import * as path29 from "path";
+import * as fs30 from "fs";
+import * as path31 from "path";
 function buildEnvVars4(config, options) {
   const env = buildBaseEnvVars(config, "audit", options.dryRun);
   env.NW_AUDIT_MAX_RUNTIME = String(config.audit.maxRuntime);
@@ -12958,7 +13822,7 @@ function auditCommand(program2) {
       if (config.audit.createIssues) {
         configTable.push(["Target Column", config.audit.targetColumn]);
       }
-      configTable.push(["Report File", path29.join(projectDir, "logs", "audit-report.md")]);
+      configTable.push(["Report File", path31.join(projectDir, "logs", "audit-report.md")]);
       console.log(configTable.toString());
       header("Provider Invocation");
       const providerCmd = PROVIDER_COMMANDS[auditProvider];
@@ -13016,8 +13880,8 @@ ${stderr}`);
         } else if (scriptResult?.status?.startsWith("skip_")) {
           spinner.succeed("Code audit skipped");
         } else {
-          const reportPath = path29.join(projectDir, "logs", "audit-report.md");
-          if (!fs28.existsSync(reportPath)) {
+          const reportPath = path31.join(projectDir, "logs", "audit-report.md");
+          if (!fs30.existsSync(reportPath)) {
             spinner.fail("Code audit finished without a report file");
             process.exit(1);
           }
@@ -13034,9 +13898,9 @@ ${stderr}`);
         const providerExit = scriptResult?.data?.provider_exit;
         const exitDetail = providerExit && providerExit !== String(exitCode) ? `, provider exit ${providerExit}` : "";
         spinner.fail(`Code audit exited with code ${exitCode}${statusSuffix}${exitDetail}`);
-        const logPath = path29.join(projectDir, "logs", "audit.log");
-        if (fs28.existsSync(logPath)) {
-          const logLines = fs28.readFileSync(logPath, "utf-8").split("\n").filter((l) => l.trim()).slice(-8);
+        const logPath = path31.join(projectDir, "logs", "audit.log");
+        if (fs30.existsSync(logPath)) {
+          const logLines = fs30.readFileSync(logPath, "utf-8").split("\n").filter((l) => l.trim()).slice(-8);
           if (logLines.length > 0) {
             process.stderr.write(logLines.join("\n") + "\n");
           }
@@ -13067,6 +13931,153 @@ ${stderr}`);
   });
 }
 
+// src/commands/ux.ts
+init_dist();
+function parseTimeout(timeout) {
+  if (!timeout) return void 0;
+  const parsed = parseInt(timeout, 10);
+  return Number.isNaN(parsed) || parsed < 0 ? void 0 : parsed;
+}
+function applyUxCliOverrides(config, options) {
+  let overridden = config;
+  const timeout = parseTimeout(options.timeout);
+  if (timeout !== void 0) {
+    overridden = { ...overridden, ux: { ...overridden.ux, maxRuntime: timeout } };
+  }
+  if (options.provider) {
+    overridden = {
+      ...overridden,
+      _cliProviderOverride: options.provider
+    };
+  }
+  return overridden;
+}
+function writeJson(value) {
+  process.stdout.write(`${JSON.stringify(value, null, 2)}
+`);
+}
+function cleanupQueueEntry() {
+  const queueId = process.env.NW_QUEUE_ENTRY_ID ? parseInt(process.env.NW_QUEUE_ENTRY_ID, 10) : NaN;
+  if (Number.isNaN(queueId) || queueId < 1) return;
+  removeJob(queueId);
+}
+function printDryRun(config) {
+  header("Dry Run: UX Agent");
+  const table = createTable({ head: ["Setting", "Value"] });
+  table.push(["Provider", resolveJobProvider(config, "ux")]);
+  table.push(["Enabled", config.ux.enabled ? "yes" : "no"]);
+  table.push(["Max Runtime", `${config.ux.maxRuntime}s`]);
+  table.push(["Target Column", config.ux.targetColumn]);
+  table.push(["Base URL", config.ux.baseUrl || "(not configured)"]);
+  table.push(["Start URL", config.ux.startUrl || "(not configured)"]);
+  table.push(["Flows", config.ux.flows.length > 0 ? config.ux.flows.join(", ") : "(discover)"]);
+  table.push(["Auto-install Playwright", config.ux.autoInstallPlaywright ? "yes" : "no"]);
+  table.push(["Max Issues", String(config.ux.maxIssues)]);
+  console.log(table.toString());
+}
+function uxCommand(program2) {
+  program2.command("ux").description("Run UX agent to inspect user flows and draft a prioritized report").option("--dry-run", "Show what would be executed without running").option("--json", "Output structured JSON").option("--timeout <seconds>", "Override max runtime in seconds").option("--provider <string>", "AI provider to use").action(async (options) => {
+    const projectDir = process.cwd();
+    let config = loadConfig(projectDir);
+    config = applyUxCliOverrides(config, options);
+    if (!config.ux.enabled && !options.dryRun) {
+      cleanupQueueEntry();
+      if (options.json) {
+        writeJson({ skipped: true, reason: "ux-disabled" });
+      } else {
+        info("UX agent is disabled in config; skipping run.");
+      }
+      process.exit(0);
+    }
+    if (options.dryRun) {
+      if (options.json) {
+        writeJson({
+          dryRun: true,
+          provider: resolveJobProvider(config, "ux"),
+          config: config.ux
+        });
+      } else {
+        printDryRun(config);
+      }
+      process.exit(0);
+    }
+    const spinner = options.json ? null : createSpinner("Running UX agent...");
+    spinner?.start();
+    const startedAt = Date.now();
+    let exitCode = 0;
+    const lockPath = uxLockPath(projectDir);
+    let lockAcquired = false;
+    try {
+      await maybeApplyCronSchedulingDelay(config, "ux", projectDir);
+      lockAcquired = acquireLock(lockPath);
+      if (!lockAcquired) {
+        cleanupQueueEntry();
+        if (options.json) {
+          writeJson({ skipped: true, reason: "ux-locked" });
+        } else {
+          spinner?.succeed("UX agent skipped: already running.");
+        }
+        process.exit(0);
+      }
+      const result = await runUx(config, projectDir);
+      exitCode = result.issuesCreated >= 0 ? 0 : 1;
+      try {
+        recordJobOutcome({
+          config,
+          exitCode,
+          finishedAt: Date.now(),
+          jobType: "ux",
+          metadata: {
+            findings: result.findings.length,
+            issuesCreated: result.issuesCreated,
+            reportUrl: result.reportUrl,
+            summary: result.summary
+          },
+          projectDir,
+          providerKey: resolveJobProvider(config, "ux"),
+          startedAt,
+          stdout: result.summary
+        });
+      } catch {
+      }
+      if (options.json) {
+        writeJson(result);
+      } else {
+        spinner?.succeed(`UX agent complete \u2014 ${result.summary}`);
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      try {
+        recordJobOutcome({
+          config,
+          exitCode: 1,
+          finishedAt: Date.now(),
+          jobType: "ux",
+          metadata: { error: message },
+          projectDir,
+          providerKey: resolveJobProvider(config, "ux"),
+          startedAt,
+          stderr: message
+        });
+      } catch {
+      }
+      if (options.json) {
+        process.stderr.write(`${JSON.stringify({ ok: false, error: message }, null, 2)}
+`);
+      } else {
+        spinner?.fail(`UX agent failed: ${message}`);
+      }
+      process.exit(1);
+    } finally {
+      if (lockAcquired) {
+        releaseLock(lockPath);
+      }
+      cleanupQueueEntry();
+    }
+    process.exit(exitCode);
+  });
+}
+
 // src/commands/analytics.ts
 init_dist();
 function analyticsCommand(program2) {
@@ -13180,16 +14191,16 @@ function analyticsCommand(program2) {
 // src/commands/install.ts
 init_dist();
 import { execSync as execSync4 } from "child_process";
-import * as path30 from "path";
-import * as fs29 from "fs";
-function shellQuote(value) {
+import * as path32 from "path";
+import * as fs31 from "fs";
+function shellQuote2(value) {
   return `'${value.replace(/'/g, `'"'"'`)}'`;
 }
 function getNightWatchBinPath() {
   try {
     const npmBin = execSync4("npm bin -g", { encoding: "utf-8" }).trim();
-    const binPath = path30.join(npmBin, "night-watch");
-    if (fs29.existsSync(binPath)) {
+    const binPath = path32.join(npmBin, "night-watch");
+    if (fs31.existsSync(binPath)) {
       return binPath;
     }
   } catch {
@@ -13202,17 +14213,17 @@ function getNightWatchBinPath() {
 }
 function getNodeBinDir() {
   if (process.execPath && process.execPath !== "node") {
-    return path30.dirname(process.execPath);
+    return path32.dirname(process.execPath);
   }
   try {
     const nodePath = execSync4("which node", { encoding: "utf-8" }).trim();
-    return path30.dirname(nodePath);
+    return path32.dirname(nodePath);
   } catch {
     return "";
   }
 }
 function buildCronPathPrefix(nodeBinDir, nightWatchBin) {
-  const nightWatchBinDir = nightWatchBin.includes("/") || nightWatchBin.includes("\\") ? path30.dirname(nightWatchBin) : "";
+  const nightWatchBinDir = nightWatchBin.includes("/") || nightWatchBin.includes("\\") ? path32.dirname(nightWatchBin) : "";
   const pathParts = Array.from(
     new Set([nodeBinDir, nightWatchBinDir].filter((part) => part.length > 0))
   );
@@ -13228,12 +14239,12 @@ function performInstall(projectDir, config, options) {
     const nightWatchBin = getNightWatchBinPath();
     const projectName = getProjectName(projectDir);
     const marker = generateMarker(projectName);
-    const logDir = path30.join(projectDir, LOG_DIR);
-    if (!fs29.existsSync(logDir)) {
-      fs29.mkdirSync(logDir, { recursive: true });
+    const logDir = path32.join(projectDir, LOG_DIR);
+    if (!fs31.existsSync(logDir)) {
+      fs31.mkdirSync(logDir, { recursive: true });
     }
-    const executorLog = path30.join(logDir, "executor.log");
-    const reviewerLog = path30.join(logDir, "reviewer.log");
+    const executorLog = path32.join(logDir, "executor.log");
+    const reviewerLog = path32.join(logDir, "reviewer.log");
     if (!options?.force) {
       const existingEntries2 = Array.from(
         /* @__PURE__ */ new Set([...getEntries(marker), ...getProjectEntries(projectDir)])
@@ -13250,76 +14261,84 @@ function performInstall(projectDir, config, options) {
     const entries = [];
     const nodeBinDir = getNodeBinDir();
     const pathPrefix = buildCronPathPrefix(nodeBinDir, nightWatchBin);
-    const cliBinPrefix = `export NW_CLI_BIN=${shellQuote(nightWatchBin)} && `;
+    const cliBinPrefix = `export NW_CLI_BIN=${shellQuote2(nightWatchBin)} && `;
     const cronTriggerPrefix = "export NW_CRON_TRIGGER=1 && ";
     let providerEnvPrefix = "";
     if (config.providerEnv && Object.keys(config.providerEnv).length > 0) {
-      const exports = Object.entries(config.providerEnv).map(([key, value]) => `export ${key}=${shellQuote(value)}`).join(" && ");
+      const exports = Object.entries(config.providerEnv).map(([key, value]) => `export ${key}=${shellQuote2(value)}`).join(" && ");
       providerEnvPrefix = exports + " && ";
     }
     const installExecutor = config.executorEnabled !== false;
     if (installExecutor) {
-      const executorEntry = `${executorSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} run >> ${shellQuote(executorLog)} 2>&1  ${marker}`;
+      const executorEntry = `${executorSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} run >> ${shellQuote2(executorLog)} 2>&1  ${marker}`;
       entries.push(executorEntry);
     }
     const installReviewer = options?.noReviewer === true ? false : config.reviewerEnabled;
     if (installReviewer) {
-      const reviewerEntry = `${reviewerSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} review >> ${shellQuote(reviewerLog)} 2>&1  ${marker}`;
+      const reviewerEntry = `${reviewerSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} review >> ${shellQuote2(reviewerLog)} 2>&1  ${marker}`;
       entries.push(reviewerEntry);
     }
     const installSlicer = options?.noSlicer === true ? false : config.roadmapScanner.enabled;
     if (installSlicer) {
       const slicerSchedule = config.roadmapScanner.slicerSchedule;
-      const slicerLog = path30.join(logDir, "slicer.log");
-      const slicerEntry = `${slicerSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} planner >> ${shellQuote(slicerLog)} 2>&1  ${marker}`;
+      const slicerLog = path32.join(logDir, "slicer.log");
+      const slicerEntry = `${slicerSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} planner >> ${shellQuote2(slicerLog)} 2>&1  ${marker}`;
       entries.push(slicerEntry);
     }
     const disableQa = options?.noQa === true || options?.qa === false;
     const installQa = disableQa ? false : config.qa.enabled;
     if (installQa) {
       const qaSchedule = config.qa.schedule;
-      const qaLog = path30.join(logDir, "qa.log");
-      const qaEntry = `${qaSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} qa >> ${shellQuote(qaLog)} 2>&1  ${marker}`;
+      const qaLog = path32.join(logDir, "qa.log");
+      const qaEntry = `${qaSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} qa >> ${shellQuote2(qaLog)} 2>&1  ${marker}`;
       entries.push(qaEntry);
     }
     const disableAudit = options?.noAudit === true || options?.audit === false;
     const installAudit = disableAudit ? false : config.audit.enabled;
     if (installAudit) {
       const auditSchedule = config.audit.schedule;
-      const auditLog = path30.join(logDir, "audit.log");
-      const auditEntry = `${auditSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} audit >> ${shellQuote(auditLog)} 2>&1  ${marker}`;
+      const auditLog = path32.join(logDir, "audit.log");
+      const auditEntry = `${auditSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} audit >> ${shellQuote2(auditLog)} 2>&1  ${marker}`;
       entries.push(auditEntry);
     }
+    const disableUx = options?.noUx === true || options?.ux === false;
+    const installUx = disableUx ? false : config.ux.enabled;
+    if (installUx) {
+      const uxSchedule = config.ux.schedule;
+      const uxLog = path32.join(logDir, "ux.log");
+      const uxEntry = `${uxSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} ux >> ${shellQuote2(uxLog)} 2>&1  ${marker}`;
+      entries.push(uxEntry);
+    }
     const disableAnalytics = options?.noAnalytics === true || options?.analytics === false;
     const installAnalytics = disableAnalytics ? false : config.analytics.enabled;
     if (installAnalytics) {
       const analyticsSchedule = config.analytics.schedule;
-      const analyticsLog = path30.join(logDir, "analytics.log");
-      const analyticsEntry = `${analyticsSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} analytics >> ${shellQuote(analyticsLog)} 2>&1  ${marker}`;
+      const analyticsLog = path32.join(logDir, "analytics.log");
+      const analyticsEntry = `${analyticsSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} analytics >> ${shellQuote2(analyticsLog)} 2>&1  ${marker}`;
       entries.push(analyticsEntry);
     }
     const disablePrResolver = options?.noPrResolver === true || options?.prResolver === false;
     const installPrResolver = disablePrResolver ? false : config.prResolver.enabled;
     if (installPrResolver) {
       const prResolverSchedule = config.prResolver.schedule;
-      const prResolverLog = path30.join(logDir, "pr-resolver.log");
-      const prResolverEntry = `${prResolverSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} resolve >> ${shellQuote(prResolverLog)} 2>&1  ${marker}`;
+      const prResolverLog = path32.join(logDir, "pr-resolver.log");
+      const prResolverEntry = `${prResolverSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} resolve >> ${shellQuote2(prResolverLog)} 2>&1  ${marker}`;
       entries.push(prResolverEntry);
     }
     const disableMerger = options?.noMerger === true || options?.merger === false;
     const installMerger = disableMerger ? false : config.merger?.enabled ?? false;
     if (installMerger) {
       const mergerSchedule = config.merger.schedule;
-      const mergerLog = path30.join(logDir, "merger.log");
-      const mergerEntry = `${mergerSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} merge >> ${shellQuote(mergerLog)} 2>&1  ${marker}`;
+      const mergerLog = path32.join(logDir, "merger.log");
+      const mergerEntry = `${mergerSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} merge >> ${shellQuote2(mergerLog)} 2>&1  ${marker}`;
       entries.push(mergerEntry);
     }
     const disableManager = options?.noManager === true || options?.manager === false;
     const installManager = disableManager ? false : config.manager?.enabled ?? false;
     if (installManager) {
       const managerSchedule = config.manager.schedule;
-      const managerLog = path30.join(logDir, `${MANAGER_LOG_NAME}.log`);
-      const managerEntry = `${managerSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} manager >> ${shellQuote(managerLog)} 2>&1  ${marker}`;
+      const managerLog = path32.join(logDir, `${MANAGER_LOG_NAME}.log`);
+      const managerEntry = `${managerSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} manager >> ${shellQuote2(managerLog)} 2>&1  ${marker}`;
       entries.push(managerEntry);
     }
     const existingEntries = new Set(
@@ -13340,7 +14359,7 @@ function performInstall(projectDir, config, options) {
   }
 }
 function installCommand(program2) {
-  program2.command("install").description("Add crontab entries for automated execution").option("-s, --schedule <cron>", "Cron schedule for PRD executor").option("--reviewer-schedule <cron>", "Cron schedule for reviewer").option("--no-reviewer", "Skip installing reviewer cron").option("--no-slicer", "Skip installing slicer cron").option("--no-qa", "Skip installing QA cron").option("--no-audit", "Skip installing audit cron").option("--no-analytics", "Skip installing analytics cron").option("--no-pr-resolver", "Skip installing PR resolver cron").option("--no-merger", "Skip installing merger cron").option("--no-manager", "Skip installing manager cron").option("-f, --force", "Replace existing cron entries for this project").action(async (options) => {
+  program2.command("install").description("Add crontab entries for automated execution").option("-s, --schedule <cron>", "Cron schedule for PRD executor").option("--reviewer-schedule <cron>", "Cron schedule for reviewer").option("--no-reviewer", "Skip installing reviewer cron").option("--no-slicer", "Skip installing slicer cron").option("--no-qa", "Skip installing QA cron").option("--no-audit", "Skip installing audit cron").option("--no-ux", "Skip installing UX cron").option("--no-analytics", "Skip installing analytics cron").option("--no-pr-resolver", "Skip installing PR resolver cron").option("--no-merger", "Skip installing merger cron").option("--no-manager", "Skip installing manager cron").option("-f, --force", "Replace existing cron entries for this project").action(async (options) => {
     try {
       const projectDir = process.cwd();
       const config = loadConfig(projectDir);
@@ -13349,12 +14368,12 @@ function installCommand(program2) {
       const nightWatchBin = getNightWatchBinPath();
       const projectName = getProjectName(projectDir);
       const marker = generateMarker(projectName);
-      const logDir = path30.join(projectDir, LOG_DIR);
-      if (!fs29.existsSync(logDir)) {
-        fs29.mkdirSync(logDir, { recursive: true });
+      const logDir = path32.join(projectDir, LOG_DIR);
+      if (!fs31.existsSync(logDir)) {
+        fs31.mkdirSync(logDir, { recursive: true });
       }
-      const executorLog = path30.join(logDir, "executor.log");
-      const reviewerLog = path30.join(logDir, "reviewer.log");
+      const executorLog = path32.join(logDir, "executor.log");
+      const reviewerLog = path32.join(logDir, "reviewer.log");
       const existingEntries = Array.from(
         /* @__PURE__ */ new Set([...getEntries(marker), ...getProjectEntries(projectDir)])
       );
@@ -13370,83 +14389,92 @@ function installCommand(program2) {
       const entries = [];
       const nodeBinDir = getNodeBinDir();
       const pathPrefix = buildCronPathPrefix(nodeBinDir, nightWatchBin);
-      const cliBinPrefix = `export NW_CLI_BIN=${shellQuote(nightWatchBin)} && `;
+      const cliBinPrefix = `export NW_CLI_BIN=${shellQuote2(nightWatchBin)} && `;
       const cronTriggerPrefix = "export NW_CRON_TRIGGER=1 && ";
       let providerEnvPrefix = "";
       if (config.providerEnv && Object.keys(config.providerEnv).length > 0) {
-        const exports = Object.entries(config.providerEnv).map(([key, value]) => `export ${key}=${shellQuote(value)}`).join(" && ");
+        const exports = Object.entries(config.providerEnv).map(([key, value]) => `export ${key}=${shellQuote2(value)}`).join(" && ");
         providerEnvPrefix = exports + " && ";
       }
       const installExecutor = config.executorEnabled !== false;
       if (installExecutor) {
-        const executorEntry = `${executorSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} run >> ${shellQuote(executorLog)} 2>&1  ${marker}`;
+        const executorEntry = `${executorSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} run >> ${shellQuote2(executorLog)} 2>&1  ${marker}`;
         entries.push(executorEntry);
       }
       const installReviewer = options.noReviewer === true ? false : config.reviewerEnabled;
       if (installReviewer) {
-        const reviewerEntry = `${reviewerSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} review >> ${shellQuote(reviewerLog)} 2>&1  ${marker}`;
+        const reviewerEntry = `${reviewerSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} review >> ${shellQuote2(reviewerLog)} 2>&1  ${marker}`;
         entries.push(reviewerEntry);
       }
       const installSlicer = options.noSlicer === true ? false : config.roadmapScanner.enabled;
       let slicerLog;
       if (installSlicer) {
-        slicerLog = path30.join(logDir, "slicer.log");
+        slicerLog = path32.join(logDir, "slicer.log");
         const slicerSchedule = config.roadmapScanner.slicerSchedule;
-        const slicerEntry = `${slicerSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} planner >> ${shellQuote(slicerLog)} 2>&1  ${marker}`;
+        const slicerEntry = `${slicerSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} planner >> ${shellQuote2(slicerLog)} 2>&1  ${marker}`;
         entries.push(slicerEntry);
       }
       const disableQa = options.noQa === true || options.qa === false;
       const installQa = disableQa ? false : config.qa.enabled;
       let qaLog;
       if (installQa) {
-        qaLog = path30.join(logDir, "qa.log");
+        qaLog = path32.join(logDir, "qa.log");
         const qaSchedule = config.qa.schedule;
-        const qaEntry = `${qaSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} qa >> ${shellQuote(qaLog)} 2>&1  ${marker}`;
+        const qaEntry = `${qaSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} qa >> ${shellQuote2(qaLog)} 2>&1  ${marker}`;
         entries.push(qaEntry);
       }
       const disableAudit = options.noAudit === true || options.audit === false;
       const installAudit = disableAudit ? false : config.audit.enabled;
       let auditLog;
       if (installAudit) {
-        auditLog = path30.join(logDir, "audit.log");
+        auditLog = path32.join(logDir, "audit.log");
         const auditSchedule = config.audit.schedule;
-        const auditEntry = `${auditSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} audit >> ${shellQuote(auditLog)} 2>&1  ${marker}`;
+        const auditEntry = `${auditSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} audit >> ${shellQuote2(auditLog)} 2>&1  ${marker}`;
         entries.push(auditEntry);
       }
+      const disableUx = options.noUx === true || options.ux === false;
+      const installUx = disableUx ? false : config.ux.enabled;
+      let uxLog;
+      if (installUx) {
+        uxLog = path32.join(logDir, "ux.log");
+        const uxSchedule = config.ux.schedule;
+        const uxEntry = `${uxSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} ux >> ${shellQuote2(uxLog)} 2>&1  ${marker}`;
+        entries.push(uxEntry);
+      }
       const disableAnalytics = options.noAnalytics === true || options.analytics === false;
       const installAnalytics = disableAnalytics ? false : config.analytics.enabled;
       let analyticsLog;
       if (installAnalytics) {
-        analyticsLog = path30.join(logDir, "analytics.log");
+        analyticsLog = path32.join(logDir, "analytics.log");
         const analyticsSchedule = config.analytics.schedule;
-        const analyticsEntry = `${analyticsSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} analytics >> ${shellQuote(analyticsLog)} 2>&1  ${marker}`;
+        const analyticsEntry = `${analyticsSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} analytics >> ${shellQuote2(analyticsLog)} 2>&1  ${marker}`;
         entries.push(analyticsEntry);
       }
       const disablePrResolver = options.noPrResolver === true || options.prResolver === false;
       const installPrResolver = disablePrResolver ? false : config.prResolver.enabled;
       let prResolverLog;
       if (installPrResolver) {
-        prResolverLog = path30.join(logDir, "pr-resolver.log");
+        prResolverLog = path32.join(logDir, "pr-resolver.log");
         const prResolverSchedule = config.prResolver.schedule;
-        const prResolverEntry = `${prResolverSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} resolve >> ${shellQuote(prResolverLog)} 2>&1  ${marker}`;
+        const prResolverEntry = `${prResolverSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} resolve >> ${shellQuote2(prResolverLog)} 2>&1  ${marker}`;
         entries.push(prResolverEntry);
       }
       const disableMerger = options.noMerger === true || options.merger === false;
       const installMerger = disableMerger ? false : config.merger?.enabled ?? false;
       let mergerLog;
       if (installMerger) {
-        mergerLog = path30.join(logDir, "merger.log");
+        mergerLog = path32.join(logDir, "merger.log");
         const mergerSchedule = config.merger.schedule;
-        const mergerEntry = `${mergerSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} merge >> ${shellQuote(mergerLog)} 2>&1  ${marker}`;
+        const mergerEntry = `${mergerSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} merge >> ${shellQuote2(mergerLog)} 2>&1  ${marker}`;
         entries.push(mergerEntry);
       }
       const disableManager = options.noManager === true || options.manager === false;
       const installManager = disableManager ? false : config.manager?.enabled ?? false;
       let managerLog;
       if (installManager) {
-        managerLog = path30.join(logDir, `${MANAGER_LOG_NAME}.log`);
+        managerLog = path32.join(logDir, `${MANAGER_LOG_NAME}.log`);
         const managerSchedule = config.manager.schedule;
-        const managerEntry = `${managerSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote(projectDir)} && ${shellQuote(nightWatchBin)} manager >> ${shellQuote(managerLog)} 2>&1  ${marker}`;
+        const managerEntry = `${managerSchedule} ${pathPrefix}${providerEnvPrefix}${cliBinPrefix}${cronTriggerPrefix}cd ${shellQuote2(projectDir)} && ${shellQuote2(nightWatchBin)} manager >> ${shellQuote2(managerLog)} 2>&1  ${marker}`;
         entries.push(managerEntry);
       }
       const existingEntrySet = new Set(existingEntries);
@@ -13475,6 +14503,9 @@ function installCommand(program2) {
       if (installAudit && auditLog) {
         dim(`  Audit: ${auditLog}`);
       }
+      if (installUx && uxLog) {
+        dim(`  UX: ${uxLog}`);
+      }
       if (installAnalytics && analyticsLog) {
         dim(`  Analytics: ${analyticsLog}`);
       }
@@ -13501,8 +14532,8 @@ function installCommand(program2) {
 
 // src/commands/uninstall.ts
 init_dist();
-import * as path31 from "path";
-import * as fs30 from "fs";
+import * as path33 from "path";
+import * as fs32 from "fs";
 function performUninstall(projectDir, options) {
   try {
     const projectName = getProjectName(projectDir);
@@ -13517,8 +14548,8 @@ function performUninstall(projectDir, options) {
     const removedCount = removeEntriesForProject(projectDir, marker);
     unregisterProject(projectDir);
     if (!options?.keepLogs) {
-      const logDir = path31.join(projectDir, "logs");
-      if (fs30.existsSync(logDir)) {
+      const logDir = path33.join(projectDir, "logs");
+      if (fs32.existsSync(logDir)) {
         const logFiles = [
           "executor.log",
           "reviewer.log",
@@ -13528,15 +14559,15 @@ function performUninstall(projectDir, options) {
           "manager.log"
         ];
         logFiles.forEach((logFile) => {
-          const logPath = path31.join(logDir, logFile);
-          if (fs30.existsSync(logPath)) {
-            fs30.unlinkSync(logPath);
+          const logPath = path33.join(logDir, logFile);
+          if (fs32.existsSync(logPath)) {
+            fs32.unlinkSync(logPath);
           }
         });
         try {
-          const remainingFiles = fs30.readdirSync(logDir);
+          const remainingFiles = fs32.readdirSync(logDir);
           if (remainingFiles.length === 0) {
-            fs30.rmdirSync(logDir);
+            fs32.rmdirSync(logDir);
           }
         } catch {
         }
@@ -13569,8 +14600,8 @@ function uninstallCommand(program2) {
       existingEntries.forEach((entry) => dim(`  ${entry}`));
       const removedCount = removeEntriesForProject(projectDir, marker);
       if (!options.keepLogs) {
-        const logDir = path31.join(projectDir, "logs");
-        if (fs30.existsSync(logDir)) {
+        const logDir = path33.join(projectDir, "logs");
+        if (fs32.existsSync(logDir)) {
           const logFiles = [
             "executor.log",
             "reviewer.log",
@@ -13581,16 +14612,16 @@ function uninstallCommand(program2) {
           ];
           let logsRemoved = 0;
           logFiles.forEach((logFile) => {
-            const logPath = path31.join(logDir, logFile);
-            if (fs30.existsSync(logPath)) {
-              fs30.unlinkSync(logPath);
+            const logPath = path33.join(logDir, logFile);
+            if (fs32.existsSync(logPath)) {
+              fs32.unlinkSync(logPath);
               logsRemoved++;
             }
           });
           try {
-            const remainingFiles = fs30.readdirSync(logDir);
+            const remainingFiles = fs32.readdirSync(logDir);
             if (remainingFiles.length === 0) {
-              fs30.rmdirSync(logDir);
+              fs32.rmdirSync(logDir);
             }
           } catch {
           }
@@ -13633,6 +14664,7 @@ function statusCommand(program2) {
       const reviewerProc = snapshot.processes.find((p) => p.name === "reviewer");
       const qaProc = snapshot.processes.find((p) => p.name === "qa");
       const auditProc = snapshot.processes.find((p) => p.name === "audit");
+      const uxProc = snapshot.processes.find((p) => p.name === "ux");
       const plannerProc = snapshot.processes.find((p) => p.name === "planner");
       const analyticsProc = snapshot.processes.find((p) => p.name === "analytics");
       const mergerProc = snapshot.processes.find((p) => p.name === "merger");
@@ -13640,6 +14672,7 @@ function statusCommand(program2) {
       const reviewerLog = snapshot.logs.find((l) => l.name === "reviewer");
       const qaLog = snapshot.logs.find((l) => l.name === "qa");
       const auditLog = snapshot.logs.find((l) => l.name === "audit");
+      const uxLog = snapshot.logs.find((l) => l.name === "ux");
       const plannerLog = snapshot.logs.find((l) => l.name === "planner");
       const analyticsLog = snapshot.logs.find((l) => l.name === "analytics");
       const mergerLog = snapshot.logs.find((l) => l.name === "merger");
@@ -13659,6 +14692,7 @@ function statusCommand(program2) {
         reviewer: { running: reviewerProc?.running ?? false, pid: reviewerProc?.pid ?? null },
         qa: { running: qaProc?.running ?? false, pid: qaProc?.pid ?? null },
         audit: { running: auditProc?.running ?? false, pid: auditProc?.pid ?? null },
+        ux: { running: uxProc?.running ?? false, pid: uxProc?.pid ?? null },
         planner: { running: plannerProc?.running ?? false, pid: plannerProc?.pid ?? null },
         analytics: { running: analyticsProc?.running ?? false, pid: analyticsProc?.pid ?? null },
         merger: { running: mergerProc?.running ?? false, pid: mergerProc?.pid ?? null },
@@ -13690,6 +14724,12 @@ function statusCommand(program2) {
             exists: auditLog.exists,
             size: auditLog.size
           } : void 0,
+          ux: uxLog ? {
+            path: uxLog.path,
+            lastLines: uxLog.lastLines,
+            exists: uxLog.exists,
+            size: uxLog.size
+          } : void 0,
           planner: plannerLog ? {
             path: plannerLog.path,
             lastLines: plannerLog.lastLines,
@@ -13740,6 +14780,7 @@ function statusCommand(program2) {
       ]);
       processTable.push(["QA", formatRunningStatus(status.qa.running, status.qa.pid)]);
       processTable.push(["Audit", formatRunningStatus(status.audit.running, status.audit.pid)]);
+      processTable.push(["UX", formatRunningStatus(status.ux.running, status.ux.pid)]);
       processTable.push([
         "Planner",
         formatRunningStatus(status.planner.running, status.planner.pid)
@@ -13801,6 +14842,13 @@ function statusCommand(program2) {
           status.logs.audit.exists ? "Exists" : "Not found"
         ]);
       }
+      if (status.logs.ux) {
+        logTable.push([
+          "UX",
+          status.logs.ux.exists ? formatBytes(status.logs.ux.size) : "-",
+          status.logs.ux.exists ? "Exists" : "Not found"
+        ]);
+      }
       if (status.logs.planner) {
         logTable.push([
           "Planner",
@@ -13840,6 +14888,10 @@ function statusCommand(program2) {
           dim("  Audit last 5 lines:");
           status.logs.audit.lastLines.forEach((line) => dim(`    ${line}`));
         }
+        if (status.logs.ux?.exists && status.logs.ux.lastLines.length > 0) {
+          dim("  UX last 5 lines:");
+          status.logs.ux.lastLines.forEach((line) => dim(`    ${line}`));
+        }
         if (status.logs.planner?.exists && status.logs.planner.lastLines.length > 0) {
           dim("  Planner last 5 lines:");
           status.logs.planner.lastLines.forEach((line) => dim(`    ${line}`));
@@ -13860,6 +14912,7 @@ function statusCommand(program2) {
       dim("  night-watch review   - Run reviewer now");
       dim("  night-watch qa       - Run QA now");
       dim("  night-watch audit    - Run audit now");
+      dim("  night-watch ux       - Run UX agent now");
       dim("  night-watch planner  - Run planner now");
       dim("  night-watch analytics - Run analytics now");
       dim("  night-watch merge     - Run merger now");
@@ -13876,14 +14929,14 @@ function statusCommand(program2) {
 // src/commands/logs.ts
 init_dist();
 import { spawn as spawn3 } from "child_process";
-import * as path32 from "path";
-import * as fs31 from "fs";
+import * as path34 from "path";
+import * as fs33 from "fs";
 function getLastLines(filePath, lineCount) {
-  if (!fs31.existsSync(filePath)) {
+  if (!fs33.existsSync(filePath)) {
     return `Log file not found: ${filePath}`;
   }
   try {
-    const content = fs31.readFileSync(filePath, "utf-8");
+    const content = fs33.readFileSync(filePath, "utf-8");
     const lines = content.trim().split("\n");
     return lines.slice(-lineCount).join("\n");
   } catch (error2) {
@@ -13891,7 +14944,7 @@ function getLastLines(filePath, lineCount) {
   }
 }
 function followLog(filePath) {
-  if (!fs31.existsSync(filePath)) {
+  if (!fs33.existsSync(filePath)) {
     console.log(`Log file not found: ${filePath}`);
     console.log("The log file will be created when the first execution runs.");
     return;
@@ -13910,26 +14963,28 @@ function followLog(filePath) {
 function logsCommand(program2) {
   program2.command("logs").description("View night-watch log output").option("-n, --lines <count>", "Number of lines to show", "50").option("-f, --follow", "Follow log output (tail -f)").option(
     "-t, --type <type>",
-    "Log type to view (executor|reviewer|qa|audit|planner|analytics|merger|manager|all)",
+    "Log type to view (executor|reviewer|qa|audit|ux|planner|analytics|merger|manager|all)",
     "all"
   ).action(async (options) => {
     try {
       const projectDir = process.cwd();
-      const logDir = path32.join(projectDir, LOG_DIR);
+      const logDir = path34.join(projectDir, LOG_DIR);
       const lineCount = parseInt(options.lines || "50", 10);
-      const executorLog = path32.join(logDir, EXECUTOR_LOG_FILE);
-      const reviewerLog = path32.join(logDir, REVIEWER_LOG_FILE);
-      const qaLog = path32.join(logDir, `${QA_LOG_NAME}.log`);
-      const auditLog = path32.join(logDir, `${AUDIT_LOG_NAME}.log`);
-      const plannerLog = path32.join(logDir, `${PLANNER_LOG_NAME}.log`);
-      const analyticsLog = path32.join(logDir, `${ANALYTICS_LOG_NAME}.log`);
-      const mergerLog = path32.join(logDir, `${MERGER_LOG_NAME}.log`);
-      const managerLog = path32.join(logDir, `${MANAGER_LOG_NAME}.log`);
+      const executorLog = path34.join(logDir, EXECUTOR_LOG_FILE);
+      const reviewerLog = path34.join(logDir, REVIEWER_LOG_FILE);
+      const qaLog = path34.join(logDir, `${QA_LOG_NAME}.log`);
+      const auditLog = path34.join(logDir, `${AUDIT_LOG_NAME}.log`);
+      const uxLog = path34.join(logDir, `${UX_LOG_NAME}.log`);
+      const plannerLog = path34.join(logDir, `${PLANNER_LOG_NAME}.log`);
+      const analyticsLog = path34.join(logDir, `${ANALYTICS_LOG_NAME}.log`);
+      const mergerLog = path34.join(logDir, `${MERGER_LOG_NAME}.log`);
+      const managerLog = path34.join(logDir, `${MANAGER_LOG_NAME}.log`);
       const logType = options.type?.toLowerCase() || "all";
       const showExecutor = logType === "all" || logType === "run" || logType === "executor";
       const showReviewer = logType === "all" || logType === "review" || logType === "reviewer";
       const showQa = logType === "all" || logType === "qa";
       const showAudit = logType === "all" || logType === "audit";
+      const showUx = logType === "all" || logType === "ux";
       const showPlanner = logType === "all" || logType === "planner" || logType === "slice" || logType === "slicer";
       const showAnalytics = logType === "all" || logType === "analytics";
       const showMerger = logType === "all" || logType === "merge" || logType === "merger";
@@ -13937,12 +14992,15 @@ function logsCommand(program2) {
       if (options.follow) {
         if (logType === "all") {
           dim("Note: Following all logs is not supported. Showing executor log.");
-          dim("Use --type reviewer|qa|audit|planner|analytics|merger|manager for other logs.\n");
+          dim(
+            "Use --type reviewer|qa|audit|ux|planner|analytics|merger|manager for other logs.\n"
+          );
         }
         let targetLog = executorLog;
         if (showReviewer) targetLog = reviewerLog;
         else if (showQa) targetLog = qaLog;
         else if (showAudit) targetLog = auditLog;
+        else if (showUx) targetLog = uxLog;
         else if (showPlanner) targetLog = plannerLog;
         else if (showAnalytics) targetLog = analyticsLog;
         else if (showMerger) targetLog = mergerLog;
@@ -13975,6 +15033,12 @@ function logsCommand(program2) {
         console.log();
         console.log(getLastLines(auditLog, lineCount));
       }
+      if (showUx) {
+        header("UX Log");
+        dim(`File: ${uxLog}`);
+        console.log();
+        console.log(getLastLines(uxLog, lineCount));
+      }
       if (showPlanner) {
         header("Planner Log");
         dim(`File: ${plannerLog}`);
@@ -14003,7 +15067,7 @@ function logsCommand(program2) {
       dim("---");
       dim("Tip: Use -f to follow logs in real-time");
       dim(
-        "     Use --type executor|reviewer|qa|audit|planner|analytics|merger|manager to view specific logs"
+        "     Use --type executor|reviewer|qa|audit|ux|planner|analytics|merger|manager to view specific logs"
       );
     } catch (err) {
       console.error(`Error reading logs: ${err instanceof Error ? err.message : String(err)}`);
@@ -14015,30 +15079,30 @@ function logsCommand(program2) {
 // src/commands/prd.ts
 init_dist();
 import { execSync as execSync5, spawn as spawn4, spawnSync } from "child_process";
-import * as fs32 from "fs";
-import * as path33 from "path";
+import * as fs34 from "fs";
+import * as path35 from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
-import { dirname as dirname10 } from "path";
+import { dirname as dirname11 } from "path";
 var __filename3 = fileURLToPath4(import.meta.url);
-var __dirname3 = dirname10(__filename3);
+var __dirname3 = dirname11(__filename3);
 function findTemplatesDir2(startDir) {
   let current = startDir;
   for (let i = 0; i < 8; i++) {
-    const candidate = path33.join(current, "templates");
-    if (fs32.existsSync(candidate) && fs32.statSync(candidate).isDirectory()) {
+    const candidate = path35.join(current, "templates");
+    if (fs34.existsSync(candidate) && fs34.statSync(candidate).isDirectory()) {
       return candidate;
     }
-    current = path33.dirname(current);
+    current = path35.dirname(current);
   }
-  return path33.join(startDir, "templates");
+  return path35.join(startDir, "templates");
 }
 var TEMPLATES_DIR2 = findTemplatesDir2(__dirname3);
 function slugify2(name) {
   return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
 }
 function getNextPrdNumber2(prdDir) {
-  if (!fs32.existsSync(prdDir)) return 1;
-  const files = fs32.readdirSync(prdDir).filter((f) => f.endsWith(".md"));
+  if (!fs34.existsSync(prdDir)) return 1;
+  const files = fs34.readdirSync(prdDir).filter((f) => f.endsWith(".md"));
   const numbers = files.map((f) => {
     const match = f.match(/^(\d+)-/);
     return match ? parseInt(match[1], 10) : 0;
@@ -14119,13 +15183,13 @@ function resolveGitHubBlobUrl(projectDir, relPath) {
       return null;
     }
     const ref = branch && branch !== "HEAD" ? branch : "main";
-    return `${httpsBase}/blob/${encodeURIComponent(ref).replace(/%2F/g, "/")}/${relPath.split(path33.sep).map((segment) => encodeURIComponent(segment)).join("/")}`;
+    return `${httpsBase}/blob/${encodeURIComponent(ref).replace(/%2F/g, "/")}/${relPath.split(path35.sep).map((segment) => encodeURIComponent(segment)).join("/")}`;
   } catch {
     return null;
   }
 }
 function buildGithubIssueBody(prdPath, projectDir, prdContent) {
-  const relPath = path33.relative(projectDir, prdPath);
+  const relPath = path35.relative(projectDir, prdPath);
   const blobUrl = resolveGitHubBlobUrl(projectDir, relPath);
   const fileLine = blobUrl ? `PRD file: [\`${relPath}\`](${blobUrl})` : `PRD file: \`${relPath}\``;
   return `${fileLine}
@@ -14136,13 +15200,13 @@ ${prdContent}
 Created via \`night-watch prd create\`.`;
 }
 async function generatePrdWithClaude(description, projectDir, model) {
-  const bundledTemplatePath = path33.join(TEMPLATES_DIR2, "prd-creator.md");
-  const installedTemplatePath = path33.join(projectDir, "instructions", "prd-creator.md");
-  const templatePath = fs32.existsSync(installedTemplatePath) ? installedTemplatePath : bundledTemplatePath;
-  if (!fs32.existsSync(templatePath)) {
+  const bundledTemplatePath = path35.join(TEMPLATES_DIR2, "prd-creator.md");
+  const installedTemplatePath = path35.join(projectDir, "instructions", "prd-creator.md");
+  const templatePath = fs34.existsSync(installedTemplatePath) ? installedTemplatePath : bundledTemplatePath;
+  if (!fs34.existsSync(templatePath)) {
     return null;
   }
-  const planningPrinciples = fs32.readFileSync(templatePath, "utf-8");
+  const planningPrinciples = fs34.readFileSync(templatePath, "utf-8");
   const prompt = buildPrdPrompt(description, projectDir, planningPrinciples);
   const modelId = model ?? CLAUDE_MODEL_IDS.opus;
   const env = buildNativeClaudeEnv(process.env);
@@ -14210,17 +15274,17 @@ function runGh(args, cwd) {
   return null;
 }
 function createGithubIssue(title, prdPath, projectDir, prdContent) {
-  const tmpFile = path33.join(projectDir, `.prd-issue-body-${Date.now()}.tmp`);
+  const tmpFile = path35.join(projectDir, `.prd-issue-body-${Date.now()}.tmp`);
   try {
     const body = buildGithubIssueBody(prdPath, projectDir, prdContent);
-    fs32.writeFileSync(tmpFile, body, "utf-8");
+    fs34.writeFileSync(tmpFile, body, "utf-8");
     const baseArgs = ["issue", "create", "--title", `PRD: ${title}`, "--body-file", tmpFile];
     return runGh([...baseArgs, "--label", "prd"], projectDir) ?? runGh(baseArgs, projectDir);
   } catch {
     return null;
   } finally {
     try {
-      fs32.unlinkSync(tmpFile);
+      fs34.unlinkSync(tmpFile);
     } catch {
     }
   }
@@ -14233,10 +15297,10 @@ function parseDependencies(content) {
 function isClaimActive(claimPath, maxRuntime) {
   const claimStaleAfter = maxRuntime > 0 ? maxRuntime : 14400;
   try {
-    if (!fs32.existsSync(claimPath)) {
+    if (!fs34.existsSync(claimPath)) {
       return { active: false };
     }
-    const content = fs32.readFileSync(claimPath, "utf-8");
+    const content = fs34.readFileSync(claimPath, "utf-8");
     const claim = JSON.parse(content);
     const age = Math.floor(Date.now() / 1e3) - claim.timestamp;
     if (age < claimStaleAfter) {
@@ -14251,9 +15315,9 @@ function prdCommand(program2) {
   const prd = program2.command("prd").description("Manage PRD files");
   prd.command("create").description("Generate a new PRD markdown file using Claude").argument("<name>", "PRD description").option("--number", "Add auto-numbering prefix to the filename", false).option("--model <model>", "Claude model to use (e.g. sonnet, opus, or a full model ID)").action(async (name, options) => {
     const projectDir = process.cwd();
-    const prdDir = path33.join(projectDir, resolvePrdCreateDir());
-    if (!fs32.existsSync(prdDir)) {
-      fs32.mkdirSync(prdDir, { recursive: true });
+    const prdDir = path35.join(projectDir, resolvePrdCreateDir());
+    if (!fs34.existsSync(prdDir)) {
+      fs34.mkdirSync(prdDir, { recursive: true });
     }
     const resolvedModel = options.model ? CLAUDE_MODEL_IDS[options.model] ?? options.model : void 0;
     const modelLabel = resolvedModel ?? CLAUDE_MODEL_IDS.opus;
@@ -14269,13 +15333,13 @@ function prdCommand(program2) {
     const prdTitle = extractPrdTitle(generated) ?? name;
     const slug = slugify2(prdTitle);
     const filename = options.number ? `${String(getNextPrdNumber2(prdDir)).padStart(2, "0")}-${slug}.md` : `${slug}.md`;
-    const filePath = path33.join(prdDir, filename);
-    if (fs32.existsSync(filePath)) {
+    const filePath = path35.join(prdDir, filename);
+    if (fs34.existsSync(filePath)) {
       error(`File already exists: ${filePath}`);
       dim("Use a different name or remove the existing file.");
       process.exit(1);
     }
-    fs32.writeFileSync(filePath, generated, "utf-8");
+    fs34.writeFileSync(filePath, generated, "utf-8");
     header("PRD Created");
     success(`Created: ${filePath}`);
     const issueUrl = createGithubIssue(prdTitle, filePath, projectDir, generated);
@@ -14288,15 +15352,15 @@ function prdCommand(program2) {
   prd.command("list").description("List all PRDs with status").option("--json", "Output as JSON").action(async (options) => {
     const projectDir = process.cwd();
     const config = loadConfig(projectDir);
-    const absolutePrdDir = path33.join(projectDir, config.prdDir);
-    const doneDir = path33.join(absolutePrdDir, "done");
+    const absolutePrdDir = path35.join(projectDir, config.prdDir);
+    const doneDir = path35.join(absolutePrdDir, "done");
     const pending = [];
-    if (fs32.existsSync(absolutePrdDir)) {
-      const files = fs32.readdirSync(absolutePrdDir).filter((f) => f.endsWith(".md"));
+    if (fs34.existsSync(absolutePrdDir)) {
+      const files = fs34.readdirSync(absolutePrdDir).filter((f) => f.endsWith(".md"));
       for (const file of files) {
-        const content = fs32.readFileSync(path33.join(absolutePrdDir, file), "utf-8");
+        const content = fs34.readFileSync(path35.join(absolutePrdDir, file), "utf-8");
         const deps = parseDependencies(content);
-        const claimPath = path33.join(absolutePrdDir, file + CLAIM_FILE_EXTENSION);
+        const claimPath = path35.join(absolutePrdDir, file + CLAIM_FILE_EXTENSION);
         const claimStatus = isClaimActive(claimPath, config.maxRuntime);
         pending.push({
           name: file,
@@ -14307,10 +15371,10 @@ function prdCommand(program2) {
       }
     }
     const done = [];
-    if (fs32.existsSync(doneDir)) {
-      const files = fs32.readdirSync(doneDir).filter((f) => f.endsWith(".md"));
+    if (fs34.existsSync(doneDir)) {
+      const files = fs34.readdirSync(doneDir).filter((f) => f.endsWith(".md"));
       for (const file of files) {
-        const content = fs32.readFileSync(path33.join(doneDir, file), "utf-8");
+        const content = fs34.readFileSync(path35.join(doneDir, file), "utf-8");
         const deps = parseDependencies(content);
         done.push({ name: file, dependencies: deps });
       }
@@ -14347,7 +15411,7 @@ import blessed6 from "blessed";
 // src/commands/dashboard/tab-status.ts
 init_dist();
 import blessed from "blessed";
-import * as fs33 from "fs";
+import * as fs35 from "fs";
 function sortPrdsByPriority(prds, priority) {
   if (priority.length === 0) return prds;
   const priorityMap = /* @__PURE__ */ new Map();
@@ -14443,7 +15507,7 @@ function renderLogPane(projectDir, logs) {
   let newestMtime = 0;
   for (const log of existingLogs) {
     try {
-      const stat = fs33.statSync(log.path);
+      const stat = fs35.statSync(log.path);
       if (stat.mtimeMs > newestMtime) {
         newestMtime = stat.mtimeMs;
         newestLog = log;
@@ -16096,8 +17160,8 @@ function createActionsTab() {
 // src/commands/dashboard/tab-logs.ts
 init_dist();
 import blessed5 from "blessed";
-import * as fs34 from "fs";
-import * as path34 from "path";
+import * as fs36 from "fs";
+import * as path36 from "path";
 var LOG_NAMES = ["executor", "reviewer"];
 var LOG_LINES = 200;
 function createLogsTab() {
@@ -16138,7 +17202,7 @@ function createLogsTab() {
   let activeKeyHandlers = [];
   let activeCtx = null;
   function getLogPath(projectDir, logName) {
-    return path34.join(projectDir, "logs", `${logName}.log`);
+    return path36.join(projectDir, "logs", `${logName}.log`);
   }
   function updateSelector() {
     const tabs = LOG_NAMES.map((name, idx) => {
@@ -16152,7 +17216,7 @@ function createLogsTab() {
   function loadLog(ctx) {
     const logName = LOG_NAMES[selectedLogIndex];
     const logPath = getLogPath(ctx.projectDir, logName);
-    if (!fs34.existsSync(logPath)) {
+    if (!fs36.existsSync(logPath)) {
       logContent.setContent(
         `{yellow-fg}No ${logName}.log file found{/yellow-fg}
 
@@ -16162,7 +17226,7 @@ Log will appear here once the ${logName} runs.`
       return;
     }
     try {
-      const stat = fs34.statSync(logPath);
+      const stat = fs36.statSync(logPath);
       const sizeKB = (stat.size / 1024).toFixed(1);
       logContent.setLabel(`[ ${logName}.log - ${sizeKB} KB ]`);
     } catch {
@@ -16487,6 +17551,15 @@ function dashboardCommand(program2) {
 // src/commands/doctor.ts
 init_dist();
 init_dist();
+function resolveDoctorErrorCategory(configPassed, providerPassed) {
+  if (!configPassed) {
+    return "config";
+  }
+  if (!providerPassed) {
+    return "provider";
+  }
+  return "unknown";
+}
 function runCheck(checkNum, total, checkName, checkFn, options) {
   step(checkNum, total, `Checking ${checkName}...`);
   const result = checkFn();
@@ -16605,6 +17678,12 @@ function doctorCommand(program2) {
       success("All checks passed");
     } else {
       error("Issues found \u2014 fix errors above before running Night Watch");
+      fireTelemetryEvent("doctor_failed", {
+        command: "doctor",
+        errorCategory: resolveDoctorErrorCategory(configResult.passed, providerResult.passed),
+        success: false,
+        failure: true
+      });
       process.exit(1);
     }
   });
@@ -16612,13 +17691,13 @@ function doctorCommand(program2) {
 
 // src/commands/serve.ts
 init_dist();
-import * as fs39 from "fs";
+import * as fs41 from "fs";
 
 // ../server/dist/index.js
 init_dist();
-import * as fs38 from "fs";
-import * as path40 from "path";
-import { dirname as dirname12 } from "path";
+import * as fs40 from "fs";
+import * as path42 from "path";
+import { dirname as dirname13 } from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
 import cors from "cors";
 import express from "express";
@@ -16702,8 +17781,8 @@ function setupGracefulShutdown(server, beforeClose) {
 
 // ../server/dist/middleware/project-resolver.middleware.js
 init_dist();
-import * as fs35 from "fs";
-import * as path35 from "path";
+import * as fs37 from "fs";
+import * as path37 from "path";
 function resolveProject(req, res, next) {
   const projectId = req.params.projectId;
   const decodedId = decodeURIComponent(projectId).replace(/~/g, "/");
@@ -16713,7 +17792,7 @@ function resolveProject(req, res, next) {
     res.status(404).json({ error: `Project not found: ${decodedId}` });
     return;
   }
-  if (!fs35.existsSync(entry.path) || !fs35.existsSync(path35.join(entry.path, CONFIG_FILE_NAME))) {
+  if (!fs37.existsSync(entry.path) || !fs37.existsSync(path37.join(entry.path, CONFIG_FILE_NAME))) {
     res.status(404).json({ error: `Project path invalid or missing config: ${entry.path}` });
     return;
   }
@@ -16756,10 +17835,128 @@ function startSseStatusWatcher(clients, projectDir, getConfig) {
   }, 2e3);
 }
 
+// ../server/dist/global-startup-summary.js
+init_dist();
+var RESET = "\x1B[0m";
+var DIM = "\x1B[2m";
+var BOLD = "\x1B[1m";
+var GREEN = "\x1B[32m";
+var YELLOW = "\x1B[33m";
+var RED = "\x1B[31m";
+var CYAN = "\x1B[36m";
+var FAILURE_OUTCOME_WINDOW_MS = 7 * 24 * 60 * 60 * 1e3;
+function paint(enabled, code, value) {
+  return enabled ? `${code}${value}${RESET}` : value;
+}
+function palette(color) {
+  return {
+    bold: (value) => paint(color, BOLD, value),
+    dim: (value) => paint(color, DIM, value),
+    green: (value) => paint(color, GREEN, value),
+    yellow: (value) => paint(color, YELLOW, value),
+    red: (value) => paint(color, RED, value),
+    cyan: (value) => paint(color, CYAN, value)
+  };
+}
+function shouldUseColor() {
+  return Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
+}
+function failureRateFromSummary(summary) {
+  if (summary.totalCount === 0)
+    return null;
+  const failed = summary.failureCount + summary.timeoutCount + summary.rateLimitedCount;
+  return Math.round(failed / summary.totalCount * 100);
+}
+function getExecutorStatus(config, snapshot) {
+  if (snapshot.processes.some((processInfo) => processInfo.running)) {
+    return "running";
+  }
+  const executorActive = snapshot.crontab.installed && config.executorEnabled !== false && !config.pausedJobs?.executor;
+  return executorActive ? "active" : "paused";
+}
+function describeError(error2) {
+  const message = error2 instanceof Error ? error2.message : String(error2);
+  return message.split("\n")[0]?.trim() || "unknown error";
+}
+function formatStatusMarker(status, colors) {
+  if (status === "error")
+    return colors.red("x");
+  if (status === "paused")
+    return colors.yellow("\u25CB");
+  return colors.green("\u25CF");
+}
+function buildProjectStartupSummary(entry, config, snapshot, outcomeSummary) {
+  return {
+    name: entry.name,
+    path: entry.path,
+    status: getExecutorStatus(config, snapshot),
+    readyPrds: snapshot.prds.filter((prd) => prd.status === "ready").length,
+    openPrs: snapshot.prs.length,
+    failedPrs: snapshot.prs.filter((pr) => pr.ciStatus === "fail").length,
+    pendingPrs: snapshot.prs.filter((pr) => pr.ciStatus === "pending").length,
+    failureRate: failureRateFromSummary(outcomeSummary),
+    provider: String(config.provider),
+    cronInstalled: snapshot.crontab.installed,
+    runningProcesses: snapshot.processes.filter((processInfo) => processInfo.running).map((processInfo) => processInfo.name)
+  };
+}
+async function collectProjectStartupSummary(entry) {
+  try {
+    const config = loadConfig(entry.path);
+    const snapshot = await fetchStatusSnapshot(entry.path, config);
+    const fromFinishedAt = Date.now() - FAILURE_OUTCOME_WINDOW_MS;
+    const outcomeSummary = getRepositories().sessionOutcomes.querySummary({
+      projectPath: entry.path,
+      fromFinishedAt
+    });
+    return buildProjectStartupSummary(entry, config, snapshot, outcomeSummary);
+  } catch (error2) {
+    return {
+      name: entry.name,
+      path: entry.path,
+      status: "error",
+      readyPrds: 0,
+      openPrs: 0,
+      failedPrs: 0,
+      pendingPrs: 0,
+      failureRate: null,
+      provider: "n/a",
+      cronInstalled: false,
+      runningProcesses: [],
+      error: describeError(error2)
+    };
+  }
+}
+function formatProjectStartupSummaryLine(summary, options = {}) {
+  const color = options.color ?? shouldUseColor();
+  const c = palette(color);
+  const statusColor = summary.status === "active" || summary.status === "running" ? c.green : c.yellow;
+  const statusText = summary.status === "error" ? c.red("error") : statusColor(summary.status.padEnd(7, " "));
+  const marker = formatStatusMarker(summary.status, c);
+  if (summary.status === "error") {
+    return `  ${marker} ${statusText} ${c.bold(summary.name)} ${c.red(summary.error ?? "unknown error")} ${c.dim(summary.path)}`;
+  }
+  const prStatus = summary.failedPrs > 0 || summary.pendingPrs > 0 ? ` (${summary.failedPrs} fail, ${summary.pendingPrs} pending)` : "";
+  const failureText = summary.failureRate === null ? c.dim("fail n/a") : `fail ${c.cyan(`${summary.failureRate}%`)}`;
+  const cronText = summary.cronInstalled ? c.green("cron on") : c.dim("cron off");
+  const runningText = summary.runningProcesses.length > 0 ? ` ${c.dim(`run ${summary.runningProcesses.join(",")}`)}` : "";
+  return [
+    `  ${marker}`,
+    statusText,
+    c.bold(summary.name),
+    `ready ${c.cyan(String(summary.readyPrds))}`,
+    `PRs ${c.cyan(String(summary.openPrs))}${prStatus}`,
+    failureText,
+    `provider ${c.cyan(summary.provider)}`,
+    cronText,
+    `${c.dim(summary.path)}${runningText}`
+  ].join(" ");
+}
+
 // ../server/dist/routes/action.routes.js
 init_dist();
-import * as fs36 from "fs";
-import * as path36 from "path";
+import * as fs38 from "fs";
+import * as path38 from "path";
 import { execSync as execSync6, spawn as spawn6 } from "child_process";
 import { Router } from "express";
 
@@ -16797,17 +17994,17 @@ function getBoardProvider(config, projectDir) {
 function cleanOrphanedClaims(dir) {
   let entries;
   try {
-    entries = fs36.readdirSync(dir, { withFileTypes: true });
+    entries = fs38.readdirSync(dir, { withFileTypes: true });
   } catch {
     return;
   }
   for (const entry of entries) {
-    const fullPath = path36.join(dir, entry.name);
+    const fullPath = path38.join(dir, entry.name);
     if (entry.isDirectory() && entry.name !== "done") {
       cleanOrphanedClaims(fullPath);
     } else if (entry.name.endsWith(CLAIM_FILE_EXTENSION)) {
       try {
-        fs36.unlinkSync(fullPath);
+        fs38.unlinkSync(fullPath);
       } catch {
       }
     }
@@ -16962,19 +18159,19 @@ function createActionRouteHandlers(ctx) {
         res.status(400).json({ error: "Invalid PRD name" });
         return;
       }
-      const prdDir = path36.join(projectDir, config.prdDir);
+      const prdDir = path38.join(projectDir, config.prdDir);
       const normalized = prdName.endsWith(".md") ? prdName : `${prdName}.md`;
-      const pendingPath = path36.join(prdDir, normalized);
-      const donePath = path36.join(prdDir, "done", normalized);
-      if (fs36.existsSync(pendingPath)) {
+      const pendingPath = path38.join(prdDir, normalized);
+      const donePath = path38.join(prdDir, "done", normalized);
+      if (fs38.existsSync(pendingPath)) {
         res.json({ message: `"${normalized}" is already pending` });
         return;
       }
-      if (!fs36.existsSync(donePath)) {
+      if (!fs38.existsSync(donePath)) {
         res.status(404).json({ error: `PRD "${normalized}" not found in done/` });
         return;
       }
-      fs36.renameSync(donePath, pendingPath);
+      fs38.renameSync(donePath, pendingPath);
       res.json({ message: `Moved "${normalized}" back to pending` });
     } catch (error2) {
       res.status(500).json({
@@ -16992,11 +18189,11 @@ function createActionRouteHandlers(ctx) {
         res.status(409).json({ error: "Executor is actively running \u2014 use Stop instead" });
         return;
       }
-      if (fs36.existsSync(lockPath)) {
-        fs36.unlinkSync(lockPath);
+      if (fs38.existsSync(lockPath)) {
+        fs38.unlinkSync(lockPath);
       }
-      const prdDir = path36.join(projectDir, config.prdDir);
-      if (fs36.existsSync(prdDir)) {
+      const prdDir = path38.join(projectDir, config.prdDir);
+      if (fs38.existsSync(prdDir)) {
         cleanOrphanedClaims(prdDir);
       }
       broadcastSSE(ctx.getSseClients(req), "status_changed", await fetchStatusSnapshot(projectDir, config));
@@ -17367,6 +18564,12 @@ function validateConfigChanges(changes, currentConfig) {
   if (changes.autoMerge !== void 0 && typeof changes.autoMerge !== "boolean") {
     return "autoMerge must be a boolean";
   }
+  if (changes.modelAttribution !== void 0 && typeof changes.modelAttribution !== "boolean") {
+    return "modelAttribution must be a boolean";
+  }
+  if (changes.newPrLabel !== void 0 && typeof changes.newPrLabel !== "string") {
+    return "newPrLabel must be a string";
+  }
   if (changes.autoMergeMethod !== void 0) {
     const validMethods = ["squash", "merge", "rebase"];
     if (!validMethods.includes(changes.autoMergeMethod)) {
@@ -17764,8 +18967,8 @@ function createProjectConfigRoutes() {
 
 // ../server/dist/routes/doctor.routes.js
 init_dist();
-import * as fs37 from "fs";
-import * as path37 from "path";
+import * as fs39 from "fs";
+import * as path39 from "path";
 import { execSync as execSync7 } from "child_process";
 import { Router as Router4 } from "express";
 function runDoctorChecks(projectDir, config) {
@@ -17798,7 +19001,7 @@ function runDoctorChecks(projectDir, config) {
     });
   }
   try {
-    const projectName = path37.basename(projectDir);
+    const projectName = path39.basename(projectDir);
     const marker = generateMarker(projectName);
     const crontabEntries = [...getEntries(marker), ...getProjectEntries(projectDir)];
     if (crontabEntries.length > 0) {
@@ -17821,8 +19024,8 @@ function runDoctorChecks(projectDir, config) {
       detail: "Failed to check crontab"
     });
   }
-  const configPath = path37.join(projectDir, CONFIG_FILE_NAME);
-  if (fs37.existsSync(configPath)) {
+  const configPath = path39.join(projectDir, CONFIG_FILE_NAME);
+  if (fs39.existsSync(configPath)) {
     checks.push({ name: "config", status: "pass", detail: "Config file exists" });
   } else {
     checks.push({
@@ -17831,9 +19034,9 @@ function runDoctorChecks(projectDir, config) {
       detail: "Config file not found (using defaults)"
     });
   }
-  const prdDir = path37.join(projectDir, config.prdDir);
-  if (fs37.existsSync(prdDir)) {
-    const prds = fs37.readdirSync(prdDir).filter((f) => f.endsWith(".md"));
+  const prdDir = path39.join(projectDir, config.prdDir);
+  if (fs39.existsSync(prdDir)) {
+    const prds = fs39.readdirSync(prdDir).filter((f) => f.endsWith(".md"));
     checks.push({
       name: "prdDir",
       status: "pass",
@@ -18083,7 +19286,7 @@ function createProjectFeedbackRoutes() {
 // ../server/dist/routes/job.routes.js
 init_dist();
 import { spawn as spawn7 } from "child_process";
-import { createHmac, randomUUID, timingSafeEqual } from "crypto";
+import { createHmac, randomUUID as randomUUID2, timingSafeEqual } from "crypto";
 import { Router as Router6 } from "express";
 var SUPPORTED_GITHUB_EVENTS = [
   "workflow_run",
@@ -18265,6 +19468,8 @@ function getLockPathForJob2(projectDir, jobId) {
       return qaLockPath(projectDir);
     case "audit":
       return auditLockPath(projectDir);
+    case "ux":
+      return uxLockPath(projectDir);
     case "slicer":
     case "planner":
       return plannerLockPath(projectDir);
@@ -18353,7 +19558,7 @@ function createJobRouteHandlers(ctx) {
         });
         return;
       }
-      const dispatchId = randomUUID();
+      const dispatchId = randomUUID2();
       const child = spawn7("night-watch", [jobDef.cliCommand], {
         detached: true,
         stdio: "ignore",
@@ -18402,7 +19607,7 @@ function createProjectJobRoutes() {
 
 // ../server/dist/routes/log.routes.js
 init_dist();
-import * as path38 from "path";
+import * as path40 from "path";
 import { Router as Router7 } from "express";
 function createLogRoutes(deps) {
   const { projectDir } = deps;
@@ -18421,7 +19626,7 @@ function createLogRoutes(deps) {
       const lines = typeof linesParam === "string" ? parseInt(linesParam, 10) : 200;
       const linesToRead = isNaN(lines) || lines < 1 ? 200 : Math.min(lines, 1e4);
       const fileName = LOG_FILE_NAMES[name] || name;
-      const logPath = path38.join(projectDir, LOG_DIR, `${fileName}.log`);
+      const logPath = path40.join(projectDir, LOG_DIR, `${fileName}.log`);
       const logLines = getLastLogLines(logPath, linesToRead);
       res.json({ name, lines: logLines });
     } catch (error2) {
@@ -18447,7 +19652,7 @@ function createProjectLogRoutes() {
       const lines = typeof linesParam === "string" ? parseInt(linesParam, 10) : 200;
       const linesToRead = isNaN(lines) || lines < 1 ? 200 : Math.min(lines, 1e4);
       const fileName = LOG_FILE_NAMES[name] || name;
-      const logPath = path38.join(projectDir, LOG_DIR, `${fileName}.log`);
+      const logPath = path40.join(projectDir, LOG_DIR, `${fileName}.log`);
       const logLines = getLastLogLines(logPath, linesToRead);
       res.json({ name, lines: logLines });
     } catch (error2) {
@@ -18482,7 +19687,7 @@ function createProjectPrdRoutes() {
 
 // ../server/dist/routes/roadmap.routes.js
 init_dist();
-import * as path39 from "path";
+import * as path41 from "path";
 import { Router as Router9 } from "express";
 function createRoadmapRouteHandlers(ctx) {
   const router = Router9({ mergeParams: true });
@@ -18492,7 +19697,7 @@ function createRoadmapRouteHandlers(ctx) {
       const config = ctx.getConfig(req);
       const projectDir = ctx.getProjectDir(req);
       const status = getRoadmapStatus(projectDir, config);
-      const prdDir = path39.join(projectDir, config.prdDir);
+      const prdDir = path41.join(projectDir, config.prdDir);
       const state = loadRoadmapState(prdDir);
       res.json({
         ...status,
@@ -18615,6 +19820,7 @@ function buildScheduleInfoResponse(projectDir, config, entries, installed) {
   const reviewerPlan = getSchedulingPlan(projectDir, config, "reviewer");
   const qaPlan = getSchedulingPlan(projectDir, config, "qa");
   const auditPlan = getSchedulingPlan(projectDir, config, "audit");
+  const uxPlan = getSchedulingPlan(projectDir, config, "ux");
   const plannerPlan = getSchedulingPlan(projectDir, config, "slicer");
   const analyticsPlan = getSchedulingPlan(projectDir, config, "analytics");
   const prResolverPlan = getSchedulingPlan(projectDir, config, "pr-resolver");
@@ -18624,6 +19830,7 @@ function buildScheduleInfoResponse(projectDir, config, entries, installed) {
   const reviewerInstalled = installed && config.reviewerEnabled && hasScheduledCommand(entries, "review");
   const qaInstalled = installed && config.qa.enabled && hasScheduledCommand(entries, "qa");
   const auditInstalled = installed && config.audit.enabled && hasScheduledCommand(entries, "audit");
+  const uxInstalled = installed && config.ux.enabled && hasScheduledCommand(entries, "ux");
   const plannerInstalled = installed && config.roadmapScanner.enabled && (hasScheduledCommand(entries, "planner") || hasScheduledCommand(entries, "slice"));
   const analyticsInstalled = installed && config.analytics.enabled && hasScheduledCommand(entries, "analytics");
   const prResolverInstalled = installed && (config.prResolver?.enabled ?? true) && hasScheduledCommand(entries, "resolve");
@@ -18662,6 +19869,14 @@ function buildScheduleInfoResponse(projectDir, config, entries, installed) {
       manualDelayMinutes: auditPlan.manualDelayMinutes,
       balancedDelayMinutes: auditPlan.balancedDelayMinutes
     },
+    ux: {
+      schedule: config.ux.schedule,
+      installed: uxInstalled,
+      nextRun: uxInstalled ? addDelayToIsoString(computeNextRun(config.ux.schedule), uxPlan.totalDelayMinutes) : null,
+      delayMinutes: uxPlan.totalDelayMinutes,
+      manualDelayMinutes: uxPlan.manualDelayMinutes,
+      balancedDelayMinutes: uxPlan.balancedDelayMinutes
+    },
     planner: {
       schedule: config.roadmapScanner.slicerSchedule,
       installed: plannerInstalled,
@@ -18854,31 +20069,31 @@ function createQueueRoutes(deps) {
 
 // ../server/dist/index.js
 var __filename4 = fileURLToPath5(import.meta.url);
-var __dirname4 = dirname12(__filename4);
+var __dirname4 = dirname13(__filename4);
 var JOB_RAW_BODY_LIMIT = "1mb";
 function setupJobRawBodyParsing(app) {
   app.use("/api/jobs", express.raw({ type: "*/*", limit: JOB_RAW_BODY_LIMIT }));
   app.use("/api/projects/:projectId/jobs", express.raw({ type: "*/*", limit: JOB_RAW_BODY_LIMIT }));
 }
 function resolveWebDistPath() {
-  const bundled = path40.join(__dirname4, "web");
-  if (fs38.existsSync(path40.join(bundled, "index.html")))
+  const bundled = path42.join(__dirname4, "web");
+  if (fs40.existsSync(path42.join(bundled, "index.html")))
     return bundled;
   let d = __dirname4;
   for (let i = 0; i < 8; i++) {
-    if (fs38.existsSync(path40.join(d, "turbo.json"))) {
-      const dev = path40.join(d, "web/dist");
-      if (fs38.existsSync(path40.join(dev, "index.html")))
+    if (fs40.existsSync(path42.join(d, "turbo.json"))) {
+      const dev = path42.join(d, "web/dist");
+      if (fs40.existsSync(path42.join(dev, "index.html")))
         return dev;
       break;
     }
-    d = dirname12(d);
+    d = dirname13(d);
   }
   return bundled;
 }
 function setupStaticFiles(app) {
   const webDistPath = resolveWebDistPath();
-  if (fs38.existsSync(webDistPath)) {
+  if (fs40.existsSync(webDistPath)) {
     app.use(express.static(webDistPath));
   }
   app.use((req, res, next) => {
@@ -18886,8 +20101,8 @@ function setupStaticFiles(app) {
       next();
       return;
     }
-    const indexPath = path40.resolve(webDistPath, "index.html");
-    if (fs38.existsSync(indexPath)) {
+    const indexPath = path42.resolve(webDistPath, "index.html");
+    if (fs40.existsSync(indexPath)) {
       res.sendFile(indexPath, (err) => {
         if (err)
           next();
@@ -19026,7 +20241,7 @@ function createGlobalApp() {
   return app;
 }
 function bootContainer() {
-  initContainer(path40.dirname(getDbPath()));
+  initContainer(path42.dirname(getDbPath()));
 }
 function startServer(projectDir, port) {
   bootContainer();
@@ -19041,7 +20256,7 @@ Night Watch UI  http://localhost:${port}`);
   });
   setupGracefulShutdown(server);
 }
-function startGlobalServer(port) {
+async function startGlobalServer(port) {
   bootContainer();
   const entries = loadRegistry();
   if (entries.length === 0) {
@@ -19052,12 +20267,14 @@ function startGlobalServer(port) {
   if (invalid.length > 0) {
     console.warn(`Warning: ${invalid.length} registered project(s) have invalid paths and will be skipped.`);
   }
+  const summaries = await Promise.all(valid.map((entry) => collectProjectStartupSummary(entry)));
   console.log(`
 Night Watch Global UI`);
   console.log(`Managing ${valid.length} project(s):`);
-  for (const p of valid) {
-    console.log(`  - ${p.name} (${p.path})`);
+  for (const summary of summaries) {
+    console.log(formatProjectStartupSummaryLine(summary));
   }
+  console.log("");
   const app = createGlobalApp();
   const server = app.listen(port, () => {
     console.log(`Night Watch Global UI running at http://localhost:${port}`);
@@ -19079,8 +20296,8 @@ function isProcessRunning2(pid) {
 }
 function readPid(lockPath) {
   try {
-    if (!fs39.existsSync(lockPath)) return null;
-    const raw = fs39.readFileSync(lockPath, "utf-8").trim();
+    if (!fs41.existsSync(lockPath)) return null;
+    const raw = fs41.readFileSync(lockPath, "utf-8").trim();
     const pid = parseInt(raw, 10);
     return Number.isFinite(pid) ? pid : null;
   } catch {
@@ -19092,10 +20309,10 @@ function acquireServeLock(mode, port) {
   let stalePidCleaned;
   for (let attempt = 0; attempt < 2; attempt++) {
     try {
-      const fd = fs39.openSync(lockPath, "wx");
-      fs39.writeFileSync(fd, `${process.pid}
+      const fd = fs41.openSync(lockPath, "wx");
+      fs41.writeFileSync(fd, `${process.pid}
 `);
-      fs39.closeSync(fd);
+      fs41.closeSync(fd);
       return { acquired: true, lockPath, stalePidCleaned };
     } catch (error2) {
       const err = error2;
@@ -19116,7 +20333,7 @@ function acquireServeLock(mode, port) {
         };
       }
       try {
-        fs39.unlinkSync(lockPath);
+        fs41.unlinkSync(lockPath);
         if (existingPid) {
           stalePidCleaned = existingPid;
         }
@@ -19139,15 +20356,18 @@ function acquireServeLock(mode, port) {
 }
 function releaseServeLock(lockPath) {
   try {
-    if (!fs39.existsSync(lockPath)) return;
+    if (!fs41.existsSync(lockPath)) return;
     const lockPid = readPid(lockPath);
     if (lockPid !== null && lockPid !== process.pid) return;
-    fs39.unlinkSync(lockPath);
+    fs41.unlinkSync(lockPath);
   } catch {
   }
 }
+function isServeDebugEnabled() {
+  return process.env.NIGHT_WATCH_DEBUG_SERVE === "1";
+}
 function serveCommand(program2) {
-  program2.command("serve").description("Start the Night Watch web UI server").option("-p, --port <number>", "Port to run the server on", "7575").option("-g, --global", "Start in global mode (manage all registered projects)").action((options) => {
+  program2.command("serve").description("Start the Night Watch web UI server").option("-p, --port <number>", "Port to run the server on", "7575").option("-g, --global", "Start in global mode (manage all registered projects)").action(async (options) => {
     const port = parseInt(options.port, 10);
     if (isNaN(port) || port < 1 || port > 65535) {
       console.error(`Invalid port: ${options.port}. Port must be between 1 and 65535.`);
@@ -19171,11 +20391,14 @@ function serveCommand(program2) {
         `[serve] cleaned stale lock from PID ${lock.stalePidCleaned} (${lock.lockPath})`
       );
     }
-    console.log(`[serve] lock acquired ${lock.lockPath} pid=${process.pid}`);
+    const debugServe = isServeDebugEnabled();
+    if (debugServe) {
+      console.log(`[serve] lock acquired ${lock.lockPath} pid=${process.pid}`);
+    }
     process.on("exit", () => {
       releaseServeLock(lock.lockPath);
     });
-    if (options.global) {
+    if (debugServe && options.global) {
       const execArgv = process.execArgv.length > 0 ? process.execArgv.join(" ") : "(none)";
       console.log(`[serve] mode=global port=${port} pid=${process.pid} node=${process.version}`);
       console.log(`[serve] execPath=${process.execPath}`);
@@ -19183,7 +20406,7 @@ function serveCommand(program2) {
       console.log(`[serve] argv=${process.argv.join(" ")}`);
     }
     if (options.global) {
-      startGlobalServer(port);
+      await startGlobalServer(port);
     } else {
       const projectDir = process.cwd();
       startServer(projectDir, port);
@@ -19238,14 +20461,14 @@ function historyCommand(program2) {
 // src/commands/update.ts
 init_dist();
 import { spawnSync as spawnSync2 } from "child_process";
-import * as fs40 from "fs";
-import * as path41 from "path";
+import * as fs42 from "fs";
+import * as path43 from "path";
 var DEFAULT_GLOBAL_SPEC = "@jonit-dev/night-watch-cli@latest";
 function parseProjectDirs(projects, cwd) {
   if (!projects || projects.trim().length === 0) {
     return [cwd];
   }
-  const dirs = projects.split(",").map((entry) => entry.trim()).filter((entry) => entry.length > 0).map((entry) => path41.resolve(cwd, entry));
+  const dirs = projects.split(",").map((entry) => entry.trim()).filter((entry) => entry.length > 0).map((entry) => path43.resolve(cwd, entry));
   return Array.from(new Set(dirs));
 }
 function shouldInstallGlobal(options) {
@@ -19287,7 +20510,7 @@ function updateCommand(program2) {
       }
       const nightWatchBin = resolveNightWatchBin();
       for (const projectDir of projectDirs) {
-        if (!fs40.existsSync(projectDir) || !fs40.statSync(projectDir).isDirectory()) {
+        if (!fs42.existsSync(projectDir) || !fs42.statSync(projectDir).isDirectory()) {
           warn(`Skipping invalid project directory: ${projectDir}`);
           continue;
         }
@@ -19331,8 +20554,8 @@ function prdStateCommand(program2) {
 
 // src/commands/retry.ts
 init_dist();
-import * as fs41 from "fs";
-import * as path42 from "path";
+import * as fs43 from "fs";
+import * as path44 from "path";
 function normalizePrdName(name) {
   if (!name.endsWith(".md")) {
     return `${name}.md`;
@@ -19340,26 +20563,26 @@ function normalizePrdName(name) {
   return name;
 }
 function getDonePrds(doneDir) {
-  if (!fs41.existsSync(doneDir)) {
+  if (!fs43.existsSync(doneDir)) {
     return [];
   }
-  return fs41.readdirSync(doneDir).filter((f) => f.endsWith(".md"));
+  return fs43.readdirSync(doneDir).filter((f) => f.endsWith(".md"));
 }
 function retryCommand(program2) {
   program2.command("retry <prdName>").description("Move a completed PRD from done/ back to pending").action((prdName) => {
     const projectDir = process.cwd();
     const config = loadConfig(projectDir);
-    const prdDir = path42.join(projectDir, config.prdDir);
-    const doneDir = path42.join(prdDir, "done");
+    const prdDir = path44.join(projectDir, config.prdDir);
+    const doneDir = path44.join(prdDir, "done");
     const normalizedPrdName = normalizePrdName(prdName);
-    const pendingPath = path42.join(prdDir, normalizedPrdName);
-    if (fs41.existsSync(pendingPath)) {
+    const pendingPath = path44.join(prdDir, normalizedPrdName);
+    if (fs43.existsSync(pendingPath)) {
       info(`"${normalizedPrdName}" is already pending, nothing to retry.`);
       return;
     }
-    const donePath = path42.join(doneDir, normalizedPrdName);
-    if (fs41.existsSync(donePath)) {
-      fs41.renameSync(donePath, pendingPath);
+    const donePath = path44.join(doneDir, normalizedPrdName);
+    if (fs43.existsSync(donePath)) {
+      fs43.renameSync(donePath, pendingPath);
       success(`Moved "${normalizedPrdName}" back to pending.`);
       dim(`From: ${donePath}`);
       dim(`To:   ${pendingPath}`);
@@ -19611,7 +20834,7 @@ function prdsCommand(program2) {
 
 // src/commands/cancel.ts
 init_dist();
-import * as fs42 from "fs";
+import * as fs44 from "fs";
 import * as readline2 from "readline";
 function getLockFilePaths2(projectDir) {
   const runtimeKey = projectRuntimeKey(projectDir);
@@ -19658,7 +20881,7 @@ async function cancelProcess2(processType, lockPath, force = false) {
   const pid = lockStatus.pid;
   if (!lockStatus.running) {
     try {
-      fs42.unlinkSync(lockPath);
+      fs44.unlinkSync(lockPath);
       return {
         success: true,
         message: `${processType} is not running (cleaned up stale lock file for PID ${pid})`,
@@ -19696,7 +20919,7 @@ async function cancelProcess2(processType, lockPath, force = false) {
   await sleep2(3e3);
   if (!isProcessRunning3(pid)) {
     try {
-      fs42.unlinkSync(lockPath);
+      fs44.unlinkSync(lockPath);
     } catch {
     }
     return {
@@ -19731,7 +20954,7 @@ async function cancelProcess2(processType, lockPath, force = false) {
   await sleep2(500);
   if (!isProcessRunning3(pid)) {
     try {
-      fs42.unlinkSync(lockPath);
+      fs44.unlinkSync(lockPath);
     } catch {
     }
     return {
@@ -19792,31 +21015,31 @@ function cancelCommand(program2) {
 
 // src/commands/slice.ts
 init_dist();
-import * as fs43 from "fs";
-import * as path43 from "path";
+import * as fs45 from "fs";
+import * as path45 from "path";
 function plannerLockPath2(projectDir) {
   return `${LOCK_FILE_PREFIX}slicer-${projectRuntimeKey(projectDir)}.lock`;
 }
 function acquirePlannerLock(projectDir) {
   const lockFile = plannerLockPath2(projectDir);
-  if (fs43.existsSync(lockFile)) {
-    const pidRaw = fs43.readFileSync(lockFile, "utf-8").trim();
+  if (fs45.existsSync(lockFile)) {
+    const pidRaw = fs45.readFileSync(lockFile, "utf-8").trim();
     const pid = parseInt(pidRaw, 10);
     if (!Number.isNaN(pid) && isProcessRunning(pid)) {
       return { acquired: false, lockFile, pid };
     }
     try {
-      fs43.unlinkSync(lockFile);
+      fs45.unlinkSync(lockFile);
     } catch {
     }
   }
-  fs43.writeFileSync(lockFile, String(process.pid));
+  fs45.writeFileSync(lockFile, String(process.pid));
   return { acquired: true, lockFile };
 }
 function releasePlannerLock(lockFile) {
   try {
-    if (fs43.existsSync(lockFile)) {
-      fs43.unlinkSync(lockFile);
+    if (fs45.existsSync(lockFile)) {
+      fs45.unlinkSync(lockFile);
     }
   } catch {
   }
@@ -19825,12 +21048,12 @@ function resolvePlannerIssueColumn(config) {
   return config.roadmapScanner.issueColumn === "Draft" ? "Draft" : "Ready";
 }
 function buildPlannerIssueBody(projectDir, config, result) {
-  const relativePrdPath = path43.join(config.prdDir, result.file ?? "").replace(/\\/g, "/");
-  const absolutePrdPath = path43.join(projectDir, config.prdDir, result.file ?? "");
+  const relativePrdPath = path45.join(config.prdDir, result.file ?? "").replace(/\\/g, "/");
+  const absolutePrdPath = path45.join(projectDir, config.prdDir, result.file ?? "");
   const sourceItem = result.item;
   let prdContent;
   try {
-    prdContent = fs43.readFileSync(absolutePrdPath, "utf-8");
+    prdContent = fs45.readFileSync(absolutePrdPath, "utf-8");
   } catch {
     prdContent = `Unable to read generated PRD file at \`${relativePrdPath}\`.`;
   }
@@ -20060,7 +21283,7 @@ function sliceCommand(program2) {
       if (!options.dryRun && result.sliced) {
         await sendNotifications(config, {
           event: "run_succeeded",
-          projectName: path43.basename(projectDir),
+          projectName: path45.basename(projectDir),
           exitCode,
           provider: config.provider,
           prTitle: result.item?.title
@@ -20068,7 +21291,7 @@ function sliceCommand(program2) {
       } else if (!options.dryRun && !nothingPending) {
         await sendNotifications(config, {
           event: "run_failed",
-          projectName: path43.basename(projectDir),
+          projectName: path45.basename(projectDir),
           exitCode,
           provider: config.provider
         });
@@ -20100,21 +21323,21 @@ function sliceCommand(program2) {
 
 // src/commands/state.ts
 init_dist();
-import * as os9 from "os";
-import * as path44 from "path";
+import * as os11 from "os";
+import * as path46 from "path";
 import chalk5 from "chalk";
 import { Command } from "commander";
 function createStateCommand() {
   const state = new Command("state");
   state.description("Manage Night Watch state");
   state.command("migrate").description("Migrate legacy JSON state files to SQLite").option("--dry-run", "Show what would be migrated without making changes").action((opts) => {
-    const nightWatchHome = process.env.NIGHT_WATCH_HOME || path44.join(os9.homedir(), GLOBAL_CONFIG_DIR);
+    const nightWatchHome = process.env.NIGHT_WATCH_HOME || path46.join(os11.homedir(), GLOBAL_CONFIG_DIR);
     if (opts.dryRun) {
       console.log(chalk5.cyan("Dry-run mode: no changes will be made.\n"));
       console.log(`Legacy JSON files that would be migrated from: ${chalk5.bold(nightWatchHome)}`);
-      console.log(`  ${path44.join(nightWatchHome, "projects.json")}`);
-      console.log(`  ${path44.join(nightWatchHome, "history.json")}`);
-      console.log(`  ${path44.join(nightWatchHome, "prd-states.json")}`);
+      console.log(`  ${path46.join(nightWatchHome, "projects.json")}`);
+      console.log(`  ${path46.join(nightWatchHome, "history.json")}`);
+      console.log(`  ${path46.join(nightWatchHome, "prd-states.json")}`);
       console.log(`  <project>/<prdDir>/.roadmap-state.json (per project)`);
       console.log(chalk5.dim("\nRun without --dry-run to apply the migration."));
       return;
@@ -20152,8 +21375,8 @@ function createStateCommand() {
 init_dist();
 init_dist();
 import { execFileSync as execFileSync6 } from "child_process";
-import * as fs44 from "fs";
-import * as path45 from "path";
+import * as fs46 from "fs";
+import * as path47 from "path";
 import * as readline3 from "readline";
 import chalk6 from "chalk";
 async function run(fn) {
@@ -20175,7 +21398,7 @@ function getProvider(config, cwd) {
   return createBoardProvider(bp, cwd);
 }
 function defaultBoardTitle(cwd) {
-  return `${path45.basename(cwd)} Night Watch`;
+  return `${path47.basename(cwd)} Night Watch`;
 }
 async function ensureBoardConfigured(config, cwd, provider, options) {
   if (config.boardProvider?.projectNumber) {
@@ -20376,11 +21599,11 @@ function boardCommand(program2) {
       let body = options.body ?? "";
       if (options.bodyFile) {
         const filePath = options.bodyFile;
-        if (!fs44.existsSync(filePath)) {
+        if (!fs46.existsSync(filePath)) {
           console.error(`File not found: ${filePath}`);
           process.exit(1);
         }
-        body = fs44.readFileSync(filePath, "utf-8");
+        body = fs46.readFileSync(filePath, "utf-8");
       }
       const labels = [];
       if (options.label) {
@@ -20621,12 +21844,12 @@ function boardCommand(program2) {
       const config = loadConfig(cwd);
       const provider = getProvider(config, cwd);
       await ensureBoardConfigured(config, cwd, provider);
-      const roadmapPath = options.roadmap ?? path45.join(cwd, "ROADMAP.md");
-      if (!fs44.existsSync(roadmapPath)) {
+      const roadmapPath = options.roadmap ?? path47.join(cwd, "ROADMAP.md");
+      if (!fs46.existsSync(roadmapPath)) {
         console.error(`Roadmap file not found: ${roadmapPath}`);
         process.exit(1);
       }
-      const roadmapContent = fs44.readFileSync(roadmapPath, "utf-8");
+      const roadmapContent = fs46.readFileSync(roadmapPath, "utf-8");
       const items = parseRoadmap(roadmapContent);
       const uncheckedItems = getUncheckedItems(items);
       if (uncheckedItems.length === 0) {
@@ -20750,16 +21973,17 @@ function boardCommand(program2) {
 // src/commands/queue.ts
 init_dist();
 init_dist();
-import * as path46 from "path";
+import * as path48 from "path";
 import { spawn as spawn8 } from "child_process";
 import chalk7 from "chalk";
 import { Command as Command2 } from "commander";
-var logger6 = createLogger("queue");
+var logger7 = createLogger("queue");
 var VALID_JOB_TYPES2 = [
   "executor",
   "reviewer",
   "qa",
   "audit",
+  "ux",
   "slicer",
   "planner",
   "pr-resolver",
@@ -20887,10 +22111,10 @@ function createQueueCommand() {
         process.exit(1);
       }
     }
-    const projectName = path46.basename(projectDir);
+    const projectName = path48.basename(projectDir);
     const queueConfig = loadConfig(projectDir).queue;
     if (isJobPaused(projectDir, jobType)) {
-      logger6.info(`Skipping enqueue for paused job: ${jobType}`);
+      logger7.info(`Skipping enqueue for paused job: ${jobType}`);
       return;
     }
     const id = enqueueJob(
@@ -20905,7 +22129,7 @@ function createQueueCommand() {
   });
   queue.command("resolve-key").description("Resolve the provider bucket key for a given project and job type").requiredOption("--project <dir>", "Project directory").requiredOption(
     "--job-type <type>",
-    "Job type (executor, reviewer, qa, audit, slicer, planner, pr-resolver, merger, manager)"
+    "Job type (executor, reviewer, qa, audit, ux, slicer, planner, pr-resolver, merger, manager)"
   ).action((opts) => {
     try {
       const config = loadConfig(opts.project);
@@ -20927,18 +22151,19 @@ function createQueueCommand() {
     const configDir = _opts.projectDir ?? process.cwd();
     const entry = dispatchNextJob(loadConfig(configDir).queue);
     if (!entry) {
-      logger6.info("No pending jobs to dispatch");
+      logger7.info("No pending jobs to dispatch");
       return;
     }
     if (isJobPaused(entry.projectPath, entry.jobType)) {
-      logger6.info(`Skipping paused queued job: ${entry.jobType} for ${entry.projectName}`);
+      logger7.info(`Skipping paused queued job: ${entry.jobType} for ${entry.projectName}`);
       removeJob(entry.id);
       return;
     }
-    logger6.info(`Dispatching ${entry.jobType} for ${entry.projectName} (ID: ${entry.id})`);
+    logger7.info(`Dispatching ${entry.jobType} for ${entry.projectName} (ID: ${entry.id})`);
     const scriptName = getScriptNameForJobType(entry.jobType);
-    if (!scriptName) {
-      logger6.error(`Unknown job type: ${entry.jobType}`);
+    const jobDef = getJobDef(entry.jobType);
+    if (!scriptName && (!jobDef || entry.jobType !== "ux")) {
+      logger7.error(`Unknown job type: ${entry.jobType}`);
       return;
     }
     let projectEnv;
@@ -20956,21 +22181,22 @@ function createQueueCommand() {
       NW_QUEUE_DISPATCHED: "1",
       NW_QUEUE_ENTRY_ID: String(entry.id)
     };
-    const scriptPath = getScriptPath(scriptName);
-    logger6.info(`Spawning: ${scriptPath} ${entry.projectPath}`);
     try {
-      const child = spawn8("bash", [scriptPath, entry.projectPath], {
+      const command = scriptName ? "bash" : "night-watch";
+      const args = scriptName ? [getScriptPath(scriptName), entry.projectPath] : [jobDef.cliCommand];
+      logger7.info(`Spawning: ${command} ${args.join(" ")}`);
+      const child = spawn8(command, args, {
         detached: true,
         stdio: "ignore",
         env,
         cwd: entry.projectPath
       });
       child.unref();
-      logger6.info(`Spawned PID: ${child.pid}`);
+      logger7.info(`Spawned PID: ${child.pid}`);
       markJobRunning(entry.id, child.pid ?? void 0);
     } catch (error2) {
       updateJobStatus(entry.id, "pending");
-      logger6.error(
+      logger7.error(
         `Failed to dispatch ${entry.jobType} for ${entry.projectName}: ${error2 instanceof Error ? error2.message : String(error2)}`
       );
       process.exit(1);
@@ -20988,7 +22214,7 @@ function createQueueCommand() {
     if (isJobPaused(projectDir, jobType)) {
       process.exit(2);
     }
-    const projectName = path46.basename(projectDir);
+    const projectName = path48.basename(projectDir);
     const callerPid = opts.pid ? parseInt(opts.pid, 10) : void 0;
     const result = claimJobSlot(
       projectDir,
@@ -21124,7 +22350,7 @@ function notifyCommand(program2) {
 
 // src/commands/summary.ts
 init_dist();
-import path47 from "path";
+import path49 from "path";
 import chalk8 from "chalk";
 function formatDuration2(seconds) {
   if (seconds === null) return "-";
@@ -21154,7 +22380,7 @@ function formatJobStatus(status) {
   return chalk8.dim(status);
 }
 function getProjectName2(projectPath) {
-  return path47.basename(projectPath) || projectPath;
+  return path49.basename(projectPath) || projectPath;
 }
 function formatProvider(providerKey) {
   return providerKey.split(":")[0] || providerKey;
@@ -21273,7 +22499,7 @@ function summaryCommand(program2) {
 // src/commands/resolve.ts
 init_dist();
 import { execFileSync as execFileSync7 } from "child_process";
-import * as path48 from "path";
+import * as path50 from "path";
 function buildEnvVars6(config, options) {
   const env = buildBaseEnvVars(config, "pr-resolver", options.dryRun);
   env.NW_PR_RESOLVER_MAX_RUNTIME = String(config.prResolver.maxRuntime);
@@ -21426,7 +22652,7 @@ ${stderr}`);
       }
       await sendNotifications(config, {
         event: notificationEvent,
-        projectName: path48.basename(projectDir),
+        projectName: path50.basename(projectDir),
         exitCode,
         provider: formatProviderDisplay(envVars.NW_PROVIDER_CMD, envVars.NW_PROVIDER_LABEL)
       });
@@ -21441,7 +22667,7 @@ ${stderr}`);
 
 // src/commands/merge.ts
 init_dist();
-import * as path49 from "path";
+import * as path51 from "path";
 function buildEnvVars7(config, options) {
   const env = buildBaseEnvVars(config, "merger", options.dryRun);
   env.NW_MERGER_MAX_RUNTIME = String(config.merger.maxRuntime);
@@ -21476,7 +22702,7 @@ function resolveMergeNotificationEvent(exitCode, mergedCount, failedCount) {
   }
   return null;
 }
-function printDryRun(config, envVars, scriptPath, projectDir) {
+function printDryRun2(config, envVars, scriptPath, projectDir) {
   header("Dry Run: Merge Orchestrator");
   const mergerProvider = resolveJobProvider(config, "merger");
   header("Configuration");
@@ -21513,20 +22739,26 @@ function mergeCommand(program2) {
     const projectDir = process.cwd();
     let config = loadConfig(projectDir);
     config = applyCliOverrides6(config, options);
+    const commandStartedAt = Date.now();
+    await trackCommandStarted("merge", config);
     if (!config.merger.enabled && !options.dryRun) {
       info("Merge orchestrator is disabled in config; skipping.");
+      await trackCommandCompleted("merge", commandStartedAt, 0, config);
       process.exit(0);
     }
     const envVars = buildEnvVars7(config, options);
     const scriptPath = getScriptPath("night-watch-merger-cron.sh");
     if (options.dryRun) {
-      printDryRun(config, envVars, scriptPath, projectDir);
+      printDryRun2(config, envVars, scriptPath, projectDir);
+      await trackCommandCompleted("merge", commandStartedAt, 0, config);
       process.exit(0);
     }
     const spinner = createSpinner("Running merge orchestrator...");
     spinner.start();
     try {
       const startedAt = Date.now();
+      const provider = envVars.NW_PROVIDER_KEY ?? resolveJobProvider(config, "merger");
+      await trackJobStarted("merger", provider, config);
       await maybeApplyCronSchedulingDelay(config, "merger", projectDir);
       const { exitCode, stdout, stderr } = await executeScriptWithOutput(
         scriptPath,
@@ -21536,6 +22768,14 @@ function mergeCommand(program2) {
       const finishedAt = Date.now();
       const scriptResult = parseScriptResult(`${stdout}
 ${stderr}`);
+      await trackJobCompletedOrFailed(
+        "merger",
+        provider,
+        startedAt,
+        exitCode,
+        config,
+        scriptResult?.status
+      );
       if (exitCode === 0) {
         if (scriptResult?.status === "queued") {
           spinner.succeed("Merge orchestrator queued \u2014 another job is currently running");
@@ -21550,6 +22790,14 @@ ${stderr}`);
       const mergedCount = parseInt(scriptResult?.data?.merged ?? "0", 10);
       const failedCount = parseInt(scriptResult?.data?.failed ?? "0", 10);
       const notificationEvent = resolveMergeNotificationEvent(exitCode, mergedCount, failedCount);
+      if (mergedCount > 0 && exitCode === 0) {
+        fireTelemetryEvent("auto_merge_completed", {
+          ...buildTelemetryBaseProperties(config),
+          jobType: "merger",
+          provider,
+          success: true
+        });
+      }
       if (!options.dryRun) {
         try {
           recordJobOutcome({
@@ -21577,15 +22825,19 @@ ${stderr}`);
       if (notificationEvent) {
         await sendNotifications(config, {
           event: notificationEvent,
-          projectName: path49.basename(projectDir),
+          projectName: path51.basename(projectDir),
           exitCode,
           provider: formatProviderDisplay(envVars.NW_PROVIDER_CMD, envVars.NW_PROVIDER_LABEL)
         });
       }
+      await trackCommandCompleted("merge", commandStartedAt, exitCode, config);
       process.exit(exitCode);
     } catch (err) {
       spinner.fail("Failed to execute merge command");
       error(`${err instanceof Error ? err.message : String(err)}`);
+      await trackCommandCompleted("merge", commandStartedAt, 1, config, {
+        errorCategory: err instanceof Error ? err.message : String(err)
+      });
       process.exit(1);
     }
   });
@@ -21593,7 +22845,7 @@ ${stderr}`);
 
 // src/commands/manager.ts
 init_dist();
-import * as path50 from "path";
+import * as path52 from "path";
 function resolveRunManager() {
   const runManager2 = runManager;
   if (typeof runManager2 !== "function") {
@@ -21603,17 +22855,17 @@ function resolveRunManager() {
   }
   return runManager2;
 }
-function writeJson(value) {
+function writeJson2(value) {
   process.stdout.write(`${JSON.stringify(value, null, 2)}
 `);
 }
-function parseTimeout(timeout) {
+function parseTimeout2(timeout) {
   if (!timeout) return void 0;
   const parsed = parseInt(timeout, 10);
   return Number.isNaN(parsed) || parsed < 0 ? void 0 : parsed;
 }
 function buildManagerRunOptions(options) {
-  const timeout = parseTimeout(options.timeout);
+  const timeout = parseTimeout2(options.timeout);
   return {
     dryRun: options.dryRun === true,
     ...timeout !== void 0 ? { timeout } : {},
@@ -21621,7 +22873,7 @@ function buildManagerRunOptions(options) {
   };
 }
 function applyManagerCliOverrides(config, options) {
-  const timeout = parseTimeout(options.timeout);
+  const timeout = parseTimeout2(options.timeout);
   let overridden = config;
   if (timeout !== void 0) {
     overridden = {
@@ -21673,7 +22925,7 @@ async function sendManagerNotifications(config, projectDir, result) {
     if (!item.shouldNotify || !item.event) continue;
     await sendNotifications(config, {
       event: item.event,
-      projectName: path50.basename(projectDir),
+      projectName: path52.basename(projectDir),
       provider: resolveJobProvider(config, "manager"),
       exitCode: 0,
       failureReason: item.title,
@@ -21708,7 +22960,7 @@ function managerCommand(program2) {
     const runOptions = buildManagerRunOptions(options);
     if (!managerConfig.enabled && !runOptions.dryRun) {
       if (options.json) {
-        writeJson({ dryRun: false, skipped: true, reason: "manager-disabled" });
+        writeJson2({ dryRun: false, skipped: true, reason: "manager-disabled" });
       } else {
         info("Manager is disabled in config; skipping run.");
       }
@@ -21746,7 +22998,7 @@ function managerCommand(program2) {
         }
       }
       if (options.json) {
-        writeJson(buildJsonResult(result, runOptions));
+        writeJson2(buildJsonResult(result, runOptions));
       } else {
         if (exitCode === 0) {
           spinner?.succeed("Manager completed successfully");
@@ -21787,12 +23039,55 @@ function managerCommand(program2) {
   });
 }
 
+// src/commands/telemetry.ts
+init_dist();
+function formatInstallId(installId) {
+  return installId.slice(0, 8);
+}
+function printStatus() {
+  const state = getTelemetryEffectiveState();
+  const status = state.enabled ? "enabled" : "disabled";
+  console.log(`Telemetry: ${status}`);
+  console.log(`Reason: ${state.reason}`);
+  console.log(`Config path: ${state.path}`);
+  console.log(`Install ID: ${formatInstallId(state.config.installId)}`);
+  console.log("Privacy docs: docs/privacy.md");
+  console.log("Disable: night-watch telemetry disable");
+  console.log("Env opt-outs: NW_TELEMETRY_DISABLED=1 or DO_NOT_TRACK=1");
+}
+function telemetryCommand(program2) {
+  const command = program2.command("telemetry").description("Manage anonymous product telemetry");
+  command.command("status").description("Show telemetry status and opt-out information").action(() => {
+    printStatus();
+  });
+  command.command("disable").description("Disable anonymous product telemetry").action(async () => {
+    const state = getTelemetryEffectiveState();
+    if (state.enabled) {
+      fireTelemetryEvent("telemetry_disabled");
+    }
+    setTelemetryEnabled(false);
+    console.log("Telemetry disabled.");
+    console.log("You can also set NW_TELEMETRY_DISABLED=1 or DO_NOT_TRACK=1.");
+  });
+  command.command("enable").description("Enable anonymous product telemetry").action(() => {
+    setTelemetryEnabled(true);
+    const envDisabled = isTelemetryEnvDisabled();
+    if (!envDisabled) {
+      fireTelemetryEvent("telemetry_enabled");
+    }
+    console.log("Telemetry enabled.");
+    if (envDisabled) {
+      console.log(`Currently overridden by ${envDisabled}.`);
+    }
+  });
+}
+
 // src/commands/agent.ts
 init_dist();
 var SCHEMA_VERSION2 = 1;
 var JSON_OPTION = "--json";
 var JSON_OPTION_DESCRIPTION = "Output as JSON";
-function writeJson2(value) {
+function writeJson3(value) {
   process.stdout.write(`${JSON.stringify(value, null, 2)}
 `);
 }
@@ -21949,7 +23244,7 @@ function normalizeJobType(job) {
 function agentCommand(program2) {
   const agent = program2.command("agent").description("Machine-readable agent operations");
   agent.command("status").description("Print a stable machine-readable project snapshot").requiredOption(JSON_OPTION, "Output status as JSON").action(async () => {
-    writeJson2(await buildAgentStatus(process.cwd()));
+    writeJson3(await buildAgentStatus(process.cwd()));
   });
 }
 function configCommand(program2) {
@@ -21957,18 +23252,18 @@ function configCommand(program2) {
   config.command("list").description("Print resolved config").option(JSON_OPTION, JSON_OPTION_DESCRIPTION).action((options) => {
     const value = loadConfig(process.cwd());
     if (options.json) {
-      writeJson2({ schemaVersion: SCHEMA_VERSION2, config: value });
+      writeJson3({ schemaVersion: SCHEMA_VERSION2, config: value });
     } else {
-      writeJson2(value);
+      writeJson3(value);
     }
   });
   config.command("get <path>").description("Read a resolved config value by dot path").option(JSON_OPTION, JSON_OPTION_DESCRIPTION).action((dotPath, options) => {
     try {
       const result = getConfigValue(process.cwd(), dotPath);
       if (options.json) {
-        writeJson2({ schemaVersion: SCHEMA_VERSION2, ...result });
+        writeJson3({ schemaVersion: SCHEMA_VERSION2, ...result });
       } else {
-        writeJson2(result.value);
+        writeJson3(result.value);
       }
     } catch (error2) {
       fail(error2 instanceof Error ? error2.message : String(error2), options);
@@ -21978,7 +23273,7 @@ function configCommand(program2) {
     try {
       const result = setConfigValue(process.cwd(), dotPath, parseConfigValue(rawValue));
       if (options.json) {
-        writeJson2({ schemaVersion: SCHEMA_VERSION2, ok: true, ...result });
+        writeJson3({ schemaVersion: SCHEMA_VERSION2, ok: true, ...result });
       } else {
         process.stdout.write(`Updated ${result.path}
 `);
@@ -21994,7 +23289,7 @@ function healthCommand(program2) {
     const snapshot = await fetchStatusSnapshot(process.cwd(), config);
     const health = buildHealth(snapshot, config);
     if (options.json) {
-      writeJson2(health);
+      writeJson3(health);
     } else {
       for (const check of health.checks) {
         process.stdout.write(`${check.ok ? "ok" : "fail"} ${check.name}: ${check.message}
@@ -22013,7 +23308,7 @@ function jobCommand(program2) {
       const jobType = normalizeJobType(jobName);
       const result = setConfigValue(process.cwd(), `pausedJobs.${jobType}`, true);
       if (options.json) {
-        writeJson2({
+        writeJson3({
           schemaVersion: SCHEMA_VERSION2,
           ok: true,
           job: jobType,
@@ -22032,7 +23327,7 @@ function jobCommand(program2) {
       const jobType = normalizeJobType(jobName);
       const result = setConfigValue(process.cwd(), `pausedJobs.${jobType}`, false);
       if (options.json) {
-        writeJson2({
+        writeJson3({
           schemaVersion: SCHEMA_VERSION2,
           ok: true,
           job: jobType,
@@ -22057,26 +23352,58 @@ function jobCommand(program2) {
   });
 }
 
+// src/telemetry-bootstrap.ts
+init_dist();
+var NOTICE_LINES = [
+  "Night Watch collects anonymous product telemetry to understand usage and improve the CLI.",
+  "Telemetry is enabled by default.",
+  "Disable anytime with `night-watch telemetry disable`, `NW_TELEMETRY_DISABLED=1`, or `DO_NOT_TRACK=1`.",
+  "Collected: CLI version, command/job type, provider, success/failure, duration, exit code, platform, Node major version, board mode, registered project count, and error category.",
+  "Never collected: repo names, paths, remotes, branches, PR/issue titles/bodies/URLs/numbers, prompts, provider output, diffs, file paths, usernames/emails, hostnames, env vars, tokens/secrets, or raw stack traces.",
+  "Privacy details: docs/privacy.md"
+];
+function shouldSuppressNotice(argv) {
+  return argv.includes("--json") || argv.includes("-h") || argv.includes("--help");
+}
+function bootstrapTelemetry(cliVersion2, argv = process.argv) {
+  setCliTelemetryVersion(cliVersion2);
+  if (isTelemetryEnvDisabled() || shouldSuppressNotice(argv)) {
+    return;
+  }
+  try {
+    const state = getTelemetryEffectiveState();
+    if (!state.enabled || state.config.noticeShownAt) {
+      return;
+    }
+    console.error(NOTICE_LINES.join("\n"));
+    markTelemetryNoticeShown();
+    fireTelemetryEvent("cli_first_run");
+  } catch {
+  }
+}
+
 // src/cli.ts
 var __filename5 = fileURLToPath6(import.meta.url);
-var __dirname5 = dirname13(__filename5);
+var __dirname5 = dirname14(__filename5);
 function findPackageRoot(dir) {
   let d = dir;
   for (let i = 0; i < 5; i++) {
-    if (existsSync36(join39(d, "package.json"))) return d;
-    d = dirname13(d);
+    if (existsSync37(join41(d, "package.json"))) return d;
+    d = dirname14(d);
   }
   return dir;
 }
 var packageRoot = findPackageRoot(__dirname5);
-var packageJson = JSON.parse(readFileSync23(join39(packageRoot, "package.json"), "utf-8"));
+var packageJson = JSON.parse(readFileSync24(join41(packageRoot, "package.json"), "utf-8"));
 var program = new Command3();
 program.name("night-watch").description("Autonomous PRD execution using Claude CLI + cron").version(packageJson.version);
+bootstrapTelemetry(packageJson.version);
 initCommand(program);
 runCommand(program);
 reviewCommand(program);
 qaCommand(program);
 auditCommand(program);
+uxCommand(program);
 analyticsCommand(program);
 installCommand(program);
 uninstallCommand(program);
@@ -22102,6 +23429,7 @@ summaryCommand(program);
 resolveCommand(program);
 mergeCommand(program);
 managerCommand(program);
+telemetryCommand(program);
 agentCommand(program);
 configCommand(program);
 healthCommand(program);