azure-pipelines-tui 0.5.1 → 0.5.3

package/README.md

@@ -1,6 +1,10 @@
 # Azure Pipelines TUI
 
-A terminal UI for live-following Azure DevOps pipeline runs, with streaming logs via SignalR.
+A terminal UI for Azure DevOps pipelines. Two standout features:
+
+### Live pipeline run viewer
+
+Follow a running or completed pipeline build in real time. A stage/job tree on the left streams log output on the right via SignalR — no browser required.
 
 ```
 ┌ Pipeline ──────────────┐┌ Logs — Initialize job ───────────────────────────────┐
@@ -12,6 +16,24 @@ A terminal UI for live-following Azure DevOps pipeline runs, with streaming logs
 └────────────────────────┘└──────────────────────────────────────────────────────┘
 ```
 
+### Stages dashboard for GitOps
+
+Per-branch overview of Plan/Apply stage pairs across recent runs. Shows the current deployment state for every branch at a glance — and when a run failed, also shows the last successful result alongside it.
+
+```
+  Stage / Branch                Plan                  Apply
+┌ Stages: Deploy-to-prod (48 runs) ────────────────────────────────────────────┐
+│  Deploy                                                                       │
+│    main                        ✓ 5m                  ✓ 2h                    │
+│    feature/PLAT-123            ✗ 30m (✓2d)           -                       │
+│    release/v1.2                ✓ 1h                  ✓ 3h                    │
+│                                                                               │
+│  Infra                                                                        │
+│    main                        ✓ 1h                  ✗ 3h (✓1d)             │
+│    feature/PLAT-456            ○ wait                -                       │
+└───────────────────────────────────────────────────────────────────────────────┘
+```
+
 ## Requirements
 
 - Node.js 18+
@@ -40,6 +62,37 @@ npx azure-pipelines-tui <build-url>                   # Single pipeline run (ful
 | `r` | Retry/restart selected stage |
 | `q` `Ctrl+C` | Quit |
 
+## Stages dashboard
+
+Status icons:
+
+| Icon | Meaning |
+|------|---------|
+| `✓ 5m` | Succeeded, finished 5 minutes ago |
+| `✗ 30m (✓2d)` | Failed, last success was 2 days ago |
+| `▶ –` | In progress |
+| `⚠ 5m` | Succeeded with warnings |
+| `⊘ –` | Skipped / canceled, no prior run |
+| `○ –` | Pending |
+| `-` | Stage did not run |
+
+The `*` suffix (e.g. `✓ 2d *`) means the most recent run was skipped or canceled — the cell shows the last active run instead.
+
+### Key bindings
+
+| Key | Action |
+|-----|--------|
+| `↑` `↓` | Navigate rows |
+| `Enter` | Open the run in the browser |
+| `r` | Refresh data |
+| `b` | Open pipeline summary in browser |
+| `p` | Go to pipelines list |
+| `e` | Go to environments overview |
+| `Esc` | Back |
+| `q` | Quit |
+
+See [docs/stages-dashboard-design.md](docs/stages-dashboard-design.md) for the full design.
+
 ## How to run locally
 
 ```bash

package/dist/debug/debugOrgs.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const api_js_1 = require("../lib/api.js");
+async function main() {
+    const token = await (0, api_js_1.getToken)();
+    console.log("Token OK\n");
+    console.log("Fetching orgs…");
+    const orgs = await (0, api_js_1.fetchOrgs)(token);
+    console.log("Orgs:", orgs.map(o => o.accountName));
+    if (orgs.length > 0) {
+        const first = orgs[0].accountName;
+        console.log(`\nFetching projects for ${first}…`);
+        const projects = await (0, api_js_1.fetchProjects)(first, token);
+        console.log("Projects:", projects.map(p => p.name));
+    }
+}
+main().catch(e => { console.error("ERROR:", e.message); process.exit(1); });

package/dist/debug/debugRetry.js

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * debugRetry.ts — standalone debug script for stage retry
+ *
+ * Usage:
+ *   npx tsx debugRetry.ts <org>/<project> <buildId> [stageRef]
+ *   npx tsx debugRetry.ts IGH-Solution/IGH-Platform-Azure 12345
+ *   npx tsx debugRetry.ts IGH-Solution/IGH-Platform-Azure 12345 MyStage
+ *
+ * Without stageRef: lists all stages with state/result.
+ * With stageRef: tries all state values (1 and 2) and forceRetryAllJobs combos.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const https_1 = __importDefault(require("https"));
+const child_process_1 = require("child_process");
+const ADO_RESOURCE = "499b84ac-1321-427f-aa17-267ca6975798";
+const API_VER = "api-version=7.1";
+const [orgProject, buildId, stageRef] = process.argv.slice(2);
+if (!orgProject || !buildId) {
+    console.error("Usage: npx tsx debugRetry.ts <org>/<project> <buildId> [stageRef]");
+    process.exit(1);
+}
+const [org, ...rest] = orgProject.split("/");
+const project = rest.join("/");
+const ADO_BASE = `https://dev.azure.com/${encodeURIComponent(org)}/${encodeURIComponent(project)}/_apis/build/builds/${buildId}`;
+function getToken() {
+    const raw = (0, child_process_1.execSync)(`az account get-access-token --resource ${ADO_RESOURCE} --output json`, { encoding: "utf8", env: { ...process.env, AZURE_CONFIG_DIR: process.env["AZURE_CONFIG_DIR"] } });
+    return JSON.parse(raw).accessToken;
+}
+function httpGet(url, token) {
+    return new Promise((resolve, reject) => {
+        const u = new URL(url);
+        https_1.default.get({ hostname: u.hostname, path: u.pathname + u.search,
+            headers: { Authorization: `Bearer ${token}`, Accept: "application/json" } }, res => {
+            let data = "";
+            res.on("data", (c) => (data += c));
+            res.on("end", () => {
+                console.log(`  GET ${url} → ${res.statusCode}`);
+                if ((res.statusCode ?? 0) >= 400)
+                    return reject(new Error(`HTTP ${res.statusCode}: ${data}`));
+                resolve(JSON.parse(data));
+            });
+        }).on("error", reject);
+    });
+}
+function httpPatch(url, token, body) {
+    return new Promise((resolve) => {
+        const u = new URL(url);
+        const payload = JSON.stringify(body);
+        console.log(`  PATCH ${url}`);
+        console.log(`  Body: ${payload}`);
+        const req = https_1.default.request({
+            hostname: u.hostname,
+            path: u.pathname + u.search,
+            method: "PATCH",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+                "Content-Length": Buffer.byteLength(payload),
+            },
+        }, res => {
+            let data = "";
+            res.on("data", (c) => (data += c));
+            res.on("end", () => {
+                let parsed;
+                try {
+                    parsed = JSON.parse(data);
+                }
+                catch { /* raw */ }
+                resolve({ status: res.statusCode ?? 0, body: data, parsed });
+            });
+        });
+        req.on("error", (e) => resolve({ status: 0, body: String(e) }));
+        req.write(payload);
+        req.end();
+    });
+}
+async function main() {
+    console.log(`\nOrg: ${org}  Project: ${project}  BuildId: ${buildId}`);
+    console.log("Fetching token…");
+    const token = getToken();
+    console.log("Token OK\n");
+    // Fetch timeline
+    const timeline = await httpGet(`${ADO_BASE}/timeline?${API_VER}`, token);
+    const stages = timeline.records
+        .filter(r => r.type === "Stage")
+        .sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
+    console.log("\n── Stages ────────────────────────────────────────────────────────");
+    for (const s of stages) {
+        const ref = s.identifier ?? s.name;
+        console.log(`  [order=${s.order ?? "?"}] ${s.name.padEnd(40)} state=${s.state.padEnd(12)} result=${s.result ?? "(none)".padEnd(20)} ref="${ref}"`);
+    }
+    console.log("");
+    if (!stageRef) {
+        console.log("Pass a stageRef as third argument to test retry.");
+        return;
+    }
+    const target = stages.find(s => (s.identifier ?? s.name) === stageRef);
+    if (!target) {
+        console.warn(`Stage "${stageRef}" not found. Check spelling against the list above.`);
+        return;
+    }
+    console.log(`\n── Testing retry on stage "${target.name}" (ref: ${stageRef}) ────`);
+    console.log(`   Current state: ${target.state}, result: ${target.result ?? "(none)"}\n`);
+    const url = `${ADO_BASE}/stages/${encodeURIComponent(stageRef)}?${API_VER}`;
+    const combos = [
+        { state: 1, forceRetryAllJobs: true, retryDependencies: true },
+        { state: 1, forceRetryAllJobs: true, retryDependencies: false },
+        { state: 1, forceRetryAllJobs: false, retryDependencies: true },
+        { state: 1, forceRetryAllJobs: false, retryDependencies: false },
+        { state: 2, forceRetryAllJobs: true, retryDependencies: true },
+        { state: 2, forceRetryAllJobs: true, retryDependencies: false },
+        { state: 2, forceRetryAllJobs: false, retryDependencies: true },
+        { state: 2, forceRetryAllJobs: false, retryDependencies: false },
+    ];
+    for (const combo of combos) {
+        console.log(`\n[state=${combo.state}, forceRetryAllJobs=${combo.forceRetryAllJobs}, retryDependencies=${combo.retryDependencies}]`);
+        const result = await httpPatch(url, token, combo);
+        console.log(`  Response ${result.status}: ${result.body.slice(0, 300)}`);
+        if (result.status < 400) {
+            console.log("  ✓ SUCCESS — this combo works!");
+            await pollStageState(token, stageRef);
+            break;
+        }
+    }
+}
+async function pollStageState(token, ref, timeoutMs = 60_000, intervalMs = 2_000) {
+    console.log(`\n── Polling stage state (timeout ${timeoutMs / 1000}s) ────────────────`);
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const timeline = await httpGet(`${ADO_BASE}/timeline?${API_VER}`, token);
+        const stage = timeline.records.find(r => r.type === "Stage" && (r.identifier ?? r.name) === ref);
+        if (!stage) {
+            console.log("  Stage not found in timeline");
+            break;
+        }
+        const ts = new Date().toISOString().slice(11, 19);
+        console.log(`  [${ts}] state=${stage.state}  result=${stage.result ?? "(none)"}`);
+        if (stage.state === "inProgress" || stage.state === "pending") {
+            console.log("  ✓ Stage transitioned — retry confirmed working.");
+            break;
+        }
+        await new Promise(r => setTimeout(r, intervalMs));
+    }
+}
+main().catch(e => { console.error(e); process.exit(1); });

package/dist/debug/debugSignalR.js

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+"use strict";
+// Debug script: connect to Azure DevOps SignalR and dump all messages
+//
+// Usage:
+//   tsx debugSignalR.ts https://dev.azure.com/ORG/PROJECT <buildId>
+//   tsx debugSignalR.ts https://dev.azure.com/ORG/PROJECT/_build/results?buildId=<id>
+//   tsx debugSignalR.ts https://dev.azure.com/ORG PROJECT <buildId>
+//   tsx debugSignalR.ts ORG/PROJECT <buildId>
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const https_1 = __importDefault(require("https"));
+const ws_1 = __importDefault(require("ws"));
+const child_process_1 = require("child_process");
+const url_1 = require("url");
+// ── Arg parsing ───────────────────────────────────────────────────────────────
+function showUsage() {
+    console.error("Usage:\n" +
+        "  tsx debugSignalR.ts https://dev.azure.com/ORG/PROJECT <buildId>\n" +
+        "  tsx debugSignalR.ts https://dev.azure.com/ORG/PROJECT/_build/results?buildId=<id>\n" +
+        "  tsx debugSignalR.ts https://dev.azure.com/ORG PROJECT <buildId>\n" +
+        "  tsx debugSignalR.ts ORG/PROJECT <buildId>");
+    process.exit(1);
+}
+const positional = process.argv.slice(2).filter(a => !a.startsWith("--"));
+let ORG, PROJECT, BUILD_ID;
+const first = positional[0] ?? "";
+if (first.startsWith("http")) {
+    const u = new url_1.URL(first);
+    const parts = u.pathname.split("/").filter(Boolean);
+    ORG = parts[0] ?? "";
+    const bidParam = u.searchParams.get("buildId");
+    if (parts.length >= 2 && !parts[1].startsWith("_")) {
+        // https://dev.azure.com/ORG/PROJECT[/...][?buildId=N]
+        PROJECT = parts[1];
+        BUILD_ID = bidParam ? Number(bidParam) : Number(positional[1] ?? "0");
+    }
+    else {
+        // https://dev.azure.com/ORG  PROJECT  buildId
+        PROJECT = positional[1] ?? "";
+        BUILD_ID = Number(positional[2] ?? "0");
+    }
+}
+else if (first.includes("/")) {
+    // ORG/PROJECT  buildId
+    const slash = first.indexOf("/");
+    ORG = first.slice(0, slash);
+    PROJECT = first.slice(slash + 1);
+    BUILD_ID = Number(positional[1] ?? "0");
+}
+else {
+    showUsage();
+}
+if (!ORG || !PROJECT || !BUILD_ID)
+    showUsage();
+const ADO_RESOURCE = "499b84ac-1321-427f-aa17-267ca6975798";
+function getToken() {
+    const raw = (0, child_process_1.execSync)(`az account get-access-token --resource ${ADO_RESOURCE} --output json`, { encoding: "utf8" });
+    return JSON.parse(raw).accessToken;
+}
+function getProjectId(org, project) {
+    const raw = (0, child_process_1.execSync)(`az devops project show --project "${project}" --organization https://dev.azure.com/${org} --query id -o tsv`, { encoding: "utf8" });
+    return raw.trim();
+}
+function httpGet(url, token) {
+    return new Promise((resolve, reject) => {
+        const u = new url_1.URL(url);
+        const req = https_1.default.get({ hostname: u.hostname, path: u.pathname + u.search,
+            headers: { Authorization: `Bearer ${token}`, Accept: "application/json" } }, res => {
+            // Follow redirects
+            if ((res.statusCode ?? 0) >= 300 && (res.statusCode ?? 0) < 400) {
+                const loc = res.headers["location"];
+                res.resume();
+                return resolve(httpGet(loc.startsWith("http") ? loc : `https://${u.hostname}${loc}`, token));
+            }
+            let data = "";
+            res.on("data", (c) => (data += c));
+            res.on("end", () => resolve(data));
+        });
+        req.on("error", reject);
+    });
+}
+async function main() {
+    const token = getToken();
+    const projectId = getProjectId(ORG, PROJECT);
+    console.log("projectId:", projectId);
+    const orgEncoded = encodeURIComponent(ORG);
+    // 1. Get instanceId (org-level, used for negotiate)
+    const connData = JSON.parse(await httpGet(`https://dev.azure.com/${orgEncoded}/_apis/connectionData?connectOptions=0&lastChangeId=-1&lastChangeId64=-1`, token));
+    console.log("instanceId (for negotiate):", connData.instanceId);
+    // 2. Negotiate with instanceId → returns contextToken
+    const CONNECTION_DATA = encodeURIComponent(JSON.stringify([
+        { name: "builddetailhub" },
+        { name: "taskagentpoolhub" },
+    ]));
+    const negotiateUrl = `https://dev.azure.com/_signalr/${orgEncoded}/_apis/${connData.instanceId}/signalr/negotiate` +
+        `?transport=webSockets&clientProtocol=1.5&connectionData=${CONNECTION_DATA}&_=${Date.now()}`;
+    console.log("negotiate URL:", negotiateUrl);
+    const negotiated = JSON.parse(await httpGet(negotiateUrl, token));
+    console.log("negotiate response:", JSON.stringify(negotiated, null, 2));
+    // Extract contextToken from Url field
+    const contextToken = negotiated.Url?.match(/\/_apis\/([0-9a-f-]{36})\//i)?.[1];
+    console.log("contextToken:", contextToken);
+    // 3. Connect WebSocket — projectId in path, contextToken (from negotiate) as query param
+    const wsUrl = `wss://dev.azure.com/_signalr/${orgEncoded}/_apis/${projectId}/signalr/connect` +
+        `?transport=webSockets&clientProtocol=1.5` +
+        `&connectionToken=${encodeURIComponent(negotiated.ConnectionToken)}` +
+        `&connectionData=${CONNECTION_DATA}` +
+        (contextToken ? `&contextToken=${encodeURIComponent(contextToken)}` : "") +
+        `&tid=0`;
+    console.log("WebSocket URL:", wsUrl);
+    const ws = new ws_1.default(wsUrl, {
+        headers: {
+            Authorization: `Bearer ${token}`,
+            "Sec-WebSocket-Protocol": `Bearer, ${token}`,
+        },
+    });
+    ws.on("open", async () => {
+        console.log("WebSocket open");
+        // Start
+        try {
+            const startResp = await httpGet(`https://dev.azure.com/_signalr/${orgEncoded}/_apis/${connData.instanceId}/signalr/start` +
+                `?transport=webSockets&clientProtocol=1.5` +
+                `&connectionToken=${encodeURIComponent(negotiated.ConnectionToken)}` +
+                `&connectionData=${CONNECTION_DATA}&_=${Date.now()}`, token);
+            console.log("start response:", startResp);
+        }
+        catch (e) {
+            console.log("start error:", e.message);
+        }
+        // WatchBuild(projectId: Guid, buildId: Int32) — confirmed signature
+        const msg = JSON.stringify({ H: "builddetailhub", M: "WatchBuild", A: [projectId, BUILD_ID], I: "1" });
+        console.log("→ sending:", msg);
+        ws.send(msg);
+    });
+    ws.on("message", (raw) => {
+        const text = raw.toString();
+        if (text === "{}") {
+            process.stdout.write(".");
+            return;
+        }
+        console.log("\n← received:", text);
+    });
+    ws.on("close", () => { console.log("\nWebSocket closed"); process.exit(0); });
+    ws.on("error", (e) => { console.log("WebSocket error:", e.message); });
+    // Run for 2 minutes
+    setTimeout(() => { console.log("\nTimeout — closing"); ws.close(); }, 120_000);
+}
+main().catch(e => { console.error("Fatal:", e.message); process.exit(1); });

package/dist/debug/debugWarnings.js

@@ -0,0 +1,169 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * debugWarnings.ts — report warning counts per stage/job/task for a build
+ *
+ * Usage:
+ *   npx tsx debugWarnings.ts <org>/<project> <buildId> [--logs]
+ *
+ * Without --logs: prints a tree of stages/jobs/tasks with warning counts.
+ * With    --logs: also fetches log content and prints each ##[warning] line.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const https_1 = __importDefault(require("https"));
+const child_process_1 = require("child_process");
+const ADO_RESOURCE = "499b84ac-1321-427f-aa17-267ca6975798";
+const API_VER = "api-version=7.1";
+const rawArgs = process.argv.slice(2);
+const [orgProject, buildId] = rawArgs.filter(a => !a.startsWith("--"));
+const showLogs = rawArgs.includes("--logs");
+if (!orgProject || !buildId) {
+    console.error("Usage: npx tsx debugWarnings.ts <org>/<project> <buildId> [--logs]");
+    process.exit(1);
+}
+const [org, ...rest] = orgProject.split("/");
+const project = rest.join("/");
+const enc = encodeURIComponent;
+const ADO_BASE = `https://dev.azure.com/${enc(org)}/${enc(project)}/_apis/build/builds/${buildId}`;
+function getToken() {
+    const raw = (0, child_process_1.execSync)(`az account get-access-token --resource ${ADO_RESOURCE} --output json`, { encoding: "utf8", env: { ...process.env, AZURE_CONFIG_DIR: process.env["AZURE_CONFIG_DIR"] } });
+    return JSON.parse(raw).accessToken;
+}
+function httpGet(url, token) {
+    return new Promise((resolve, reject) => {
+        const u = new URL(url);
+        https_1.default.get({ hostname: u.hostname, path: u.pathname + u.search,
+            headers: { Authorization: `Bearer ${token}`, Accept: "application/json" } }, res => {
+            let data = "";
+            res.on("data", (c) => (data += c));
+            res.on("end", () => {
+                if ((res.statusCode ?? 0) >= 400)
+                    return reject(new Error(`HTTP ${res.statusCode}: ${data.slice(0, 300)}`));
+                resolve(JSON.parse(data));
+            });
+        }).on("error", reject);
+    });
+}
+function httpGetText(url, token) {
+    return new Promise((resolve, reject) => {
+        const u = new URL(url);
+        https_1.default.get({ hostname: u.hostname, path: u.pathname + u.search,
+            headers: { Authorization: `Bearer ${token}`, Accept: "text/plain" } }, res => {
+            let data = "";
+            res.on("data", (c) => (data += c));
+            res.on("end", () => {
+                if ((res.statusCode ?? 0) >= 400)
+                    return reject(new Error(`HTTP ${res.statusCode}: ${data.slice(0, 300)}`));
+                resolve(data);
+            });
+        }).on("error", reject);
+    });
+}
+function badge(warnings, errors) {
+    const parts = [];
+    if (warnings > 0)
+        parts.push(`⚠ ${warnings}w`);
+    if (errors > 0)
+        parts.push(`✗ ${errors}e`);
+    return parts.length ? `  [${parts.join("  ")}]` : "";
+}
+async function main() {
+    console.log(`\nOrg: ${org}  Project: ${project}  BuildId: ${buildId}`);
+    console.log("Fetching token…");
+    const token = getToken();
+    console.log("Token OK\n");
+    const timeline = await httpGet(`${ADO_BASE}/timeline?${API_VER}`, token);
+    const records = timeline.records ?? [];
+    // Build parent → children index
+    const children = new Map();
+    for (const r of records) {
+        const p = r.parentId ?? null;
+        if (!children.has(p))
+            children.set(p, []);
+        children.get(p).push(r);
+    }
+    // Stages = top-level records of type Stage
+    const stages = (children.get(null) ?? [])
+        .filter(r => r.type === "Stage")
+        .sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
+    // Totals from leaf records only (Tasks have no children) to avoid double-counting.
+    // Stage/Phase/Job warningCount is often 0 even when children have warnings.
+    const hasChildren = new Set(records.map(r => r.parentId).filter(Boolean));
+    let totalWarnings = 0;
+    let totalErrors = 0;
+    for (const r of records) {
+        if (!hasChildren.has(r.id)) {
+            totalWarnings += r.warningCount ?? 0;
+            totalErrors += r.errorCount ?? 0;
+        }
+    }
+    function sumDescendants(nodeId) {
+        const kids = children.get(nodeId) ?? [];
+        if (kids.length === 0)
+            return { warnings: 0, errors: 0 };
+        let w = 0, e = 0;
+        for (const kid of kids) {
+            if (!hasChildren.has(kid.id)) {
+                w += kid.warningCount ?? 0;
+                e += kid.errorCount ?? 0;
+            }
+            else {
+                const s = sumDescendants(kid.id);
+                w += s.warnings;
+                e += s.errors;
+            }
+        }
+        return { warnings: w, errors: e };
+    }
+    // Collect tasks with logs that have warnings (for --logs mode)
+    const warningTasks = [];
+    function printTree(nodes, indent) {
+        const sorted = [...nodes].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
+        for (const node of sorted) {
+            const w = node.warningCount ?? 0;
+            const e = node.errorCount ?? 0;
+            const b = badge(w, e);
+            console.log(`${indent}${node.type.padEnd(6)} ${node.name}${b}`);
+            if (showLogs && w > 0 && node.log?.url) {
+                warningTasks.push({ name: node.name, logUrl: node.log.url });
+            }
+            const kids = children.get(node.id) ?? [];
+            if (kids.length)
+                printTree(kids, indent + "  ");
+        }
+    }
+    console.log("── Warning/Error tree ────────────────────────────────────────────");
+    for (const stage of stages) {
+        const { warnings: sw, errors: se } = sumDescendants(stage.id);
+        console.log(`\nSTAGE  ${stage.name}  (state=${stage.state}  result=${stage.result ?? "—"})${badge(sw, se)}`);
+        const kids = children.get(stage.id) ?? [];
+        printTree(kids, "  ");
+    }
+    console.log(`\n── Totals ────────────────────────────────────────────────────────`);
+    console.log(`  Warnings: ${totalWarnings}`);
+    console.log(`  Errors  : ${totalErrors}`);
+    if (!showLogs || warningTasks.length === 0)
+        return;
+    console.log(`\n── Warning log lines (${warningTasks.length} tasks) ──────────────────────────`);
+    for (const task of warningTasks) {
+        console.log(`\n  [${task.name}]`);
+        try {
+            const text = await httpGetText(`${task.logUrl}?${API_VER}`, token);
+            const lines = text.split("\n").filter(l => /##\[warning\]/i.test(l));
+            if (lines.length === 0) {
+                console.log("    (no ##[warning] lines found in log)");
+            }
+            else {
+                for (const line of lines)
+                    console.log(`    ${line.trim()}`);
+            }
+        }
+        catch (e) {
+            console.log(`    Error fetching log: ${e.message}`);
+        }
+    }
+}
+main().catch(e => { console.error(e); process.exit(1); });

package/dist/lib/api.js

@@ -21,6 +21,8 @@ exports.buildBase = buildBase;
 exports.fetchBuild = fetchBuild;
 exports.fetchTimeline = fetchTimeline;
 exports.fetchLogLines = fetchLogLines;
+exports.fetchOrgs = fetchOrgs;
+exports.fetchProjects = fetchProjects;
 const https_1 = __importDefault(require("https"));
 const child_process_1 = require("child_process");
 const url_1 = require("url");
@@ -254,3 +256,13 @@ async function fetchTimeline(org, project, buildId, token) {
 async function fetchLogLines(org, project, buildId, logId, startLine, token) {
     return httpGet(`${buildBase(org, project, buildId)}/logs/${logId}?startLine=${startLine}&${exports.API_VER}`, token).catch(() => null);
 }
+async function fetchOrgs(token) {
+    const conn = await httpGet(`https://app.vssps.visualstudio.com/_apis/connectionData`, token);
+    const memberId = conn.authenticatedUser.id;
+    const data = await httpGet(`https://app.vssps.visualstudio.com/_apis/accounts?memberId=${memberId}&api-version=7.1-preview.1`, token);
+    return (data.value ?? []).sort((a, b) => a.accountName.localeCompare(b.accountName));
+}
+async function fetchProjects(org, token) {
+    const data = await httpGet(`https://dev.azure.com/${(0, exports.enc)(org)}/_apis/projects?$top=200&stateFilter=wellFormed&${exports.API_VER}`, token);
+    return (data.value ?? []).sort((a, b) => a.name.localeCompare(b.name));
+}

package/dist/lib/format.js

@@ -191,15 +191,16 @@ function formatEnvItem(item) {
         }
         let stats = "";
         if (item.ok > 0)
-            stats += ` {green-fg}${item.ok}✓{/}`;
+            stats += `{green-fg}${item.ok}✓{/} `;
         if (item.fail > 0)
-            stats += ` {red-fg}${item.fail}✗{/}`;
+            stats += `{red-fg}${item.fail}✗{/} `;
         const other = item.total - item.ok - item.fail;
         if (other > 0)
-            stats += ` {gray-fg}${other}…{/}`;
+            stats += `{gray-fg}${other}…{/}`;
         if (!stats && item.total === 0)
-            stats = ` {gray-fg}empty{/}`;
-        return `{bold}${left}{/}${stats}`;
+            stats = `{gray-fg}empty{/}`;
+        const pipeBlank = " " + " ".repeat(36);
+        return `{bold}${left}{/}${pipeBlank} ${stats.trim()}`;
     }
     const pfx = indent + (item.isLast ? "└─ " : "├─ ");
     const label = padEnd(item.label, Math.max(1, exports.LEFT_COL - 1 - pfx.length));

package/dist/screens/EnvironmentsScreen.js

@@ -47,9 +47,14 @@ class EnvironmentsScreen {
     rows = [];
     flatItems = [];
     collapsed = new Set();
+    helpVisible = false;
     get footerText() {
-        return (" {cyan-fg}↑↓{/} Navigate  {cyan-fg}Enter{/} Expand/Stages  {cyan-fg}←{/} Collapse  " +
-            "{cyan-fg}p{/} Pipelines  {cyan-fg}m{/} Mapping  {cyan-fg}r{/} Refresh  {cyan-fg}c{/} Clear  {cyan-fg}q{/} Quit");
+        if (this.helpVisible) {
+            return (" {cyan-fg}↑↓{/} Navigate  {cyan-fg}Enter{/} Run/Expand  {cyan-fg}s{/} Stages  {cyan-fg}←→{/} Collapse/Expand" +
+                "  {cyan-fg}b{/} Browser  {cyan-fg}p{/} Pipelines  {cyan-fg}m{/} Mapping" +
+                "  {cyan-fg}r{/} Refresh  {cyan-fg}c{/} Clear cache  {cyan-fg}h{/} Close help  {cyan-fg}q{/} Quit");
+        }
+        return " {cyan-fg}↑↓{/} Navigate  {cyan-fg}Enter{/} Run/Expand  {cyan-fg}s{/} Stages  {cyan-fg}p{/} Pipelines  {cyan-fg}←→{/} Collapse/Expand  {cyan-fg}b{/} Browser  {cyan-fg}h{/} Help  {cyan-fg}q{/} Quit";
     }
     constructor(screen, ctx) {
         this.screen = screen;
@@ -98,24 +103,25 @@ class EnvironmentsScreen {
         const idx = this.widget.selected ?? 0;
         return this.flatItems[idx];
     }
-    async openStagesForRow(row) {
-        if (!row.mapping) {
-            const bid = row.deploy?.owner?.id ? Number(row.deploy.owner.id) : 0;
-            if (!bid)
-                return;
-            const url = `https://dev.azure.com/${this.ctx.org}/${this.ctx.project}/_build/results?buildId=${bid}`;
-            try {
-                (0, child_process_1.spawn)("cmd", ["/c", "start", "", url], { detached: true, stdio: "ignore" }).unref();
-            }
-            catch { }
+    navigateRunForRow(row) {
+        const bid = row.deploy?.owner?.id ? Number(row.deploy.owner.id) : 0;
+        if (bid)
+            this.ctx.navigate({ view: "pipelineRun", buildId: String(bid) });
+        else
+            this.ctx.setStatus("No deployment found for this environment");
+    }
+    async navigateStagesForRow(row) {
+        const pipelineId = row.mapping?.pipelineId ?? row.deploy?.definition?.id;
+        if (!pipelineId) {
+            this.ctx.setStatus("No pipeline found for this environment");
             return;
         }
-        let pip = this.ctx.state.pipelines.find(p => p.id === row.mapping.pipelineId);
+        let pip = this.ctx.state.pipelines.find(p => p.id === pipelineId);
         if (!pip) {
             this.ctx.setStatus("Loading pipeline definitions…", 0);
             try {
                 await this.ctx.loadPipelineDefinitions();
-                pip = this.ctx.state.pipelines.find(p => p.id === row.mapping.pipelineId);
+                pip = this.ctx.state.pipelines.find(p => p.id === pipelineId);
             }
             catch (e) {
                 this.ctx.setStatus(`Error: ${e.message.slice(0, 80)}`, 5000);
@@ -125,7 +131,19 @@ class EnvironmentsScreen {
         if (pip)
             this.ctx.navigate({ view: "stages", pipeline: pip });
         else
-            this.ctx.setStatus(`Pipeline ${row.mapping.pipelineId} not found`);
+            this.ctx.setStatus(`Pipeline ${pipelineId} not found`);
+    }
+    openBrowserForRow(row) {
+        const bid = row.deploy?.owner?.id ? Number(row.deploy.owner.id) : 0;
+        if (!bid) {
+            this.ctx.setStatus("No deployment found for this environment");
+            return;
+        }
+        const url = `https://dev.azure.com/${this.ctx.org}/${this.ctx.project}/_build/results?buildId=${bid}`;
+        try {
+            (0, child_process_1.spawn)("cmd", ["/c", "start", "", url], { detached: true, stdio: "ignore" }).unref();
+        }
+        catch { }
     }
     async loadData() {
         this.ctx.setStatus("Loading environments…", 0);
@@ -181,6 +199,22 @@ class EnvironmentsScreen {
             this.loadData();
         });
         this.widget.key("c", () => { (0, cache_js_1.clearAllCache)(); this.ctx.setStatus("All caches cleared"); });
+        this.widget.key("h", () => {
+            this.helpVisible = !this.helpVisible;
+            this.ctx.setStatus("", 0);
+        });
+        this.widget.key("b", () => {
+            const item = this.selected();
+            if (!item || item.kind !== "leaf")
+                return;
+            this.openBrowserForRow(item.row);
+        });
+        this.widget.key("s", () => {
+            const item = this.selected();
+            if (!item || item.kind !== "leaf")
+                return;
+            this.navigateStagesForRow(item.row);
+        });
         this.widget.key("enter", () => {
             const item = this.selected();
             if (!item)
@@ -193,7 +227,7 @@ class EnvironmentsScreen {
                 this.refresh();
             }
             else {
-                this.openStagesForRow(item.row);
+                this.navigateRunForRow(item.row);
             }
         });
         this.widget.key("left", () => {
@@ -215,6 +249,13 @@ class EnvironmentsScreen {
                 }
             }
         });
+        this.widget.key("right", () => {
+            const item = this.selected();
+            if (!item || item.kind !== "group" || item.isExpanded)
+                return;
+            this.collapsed.delete(item.key);
+            this.refresh();
+        });
     }
 }
 exports.EnvironmentsScreen = EnvironmentsScreen;

package/dist/screens/OrgsScreen.js

@@ -0,0 +1,102 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrgsScreen = void 0;
+const blessed = __importStar(require("blessed"));
+const api_js_1 = require("../lib/api.js");
+class OrgsScreen {
+    screen;
+    ctx;
+    widget;
+    orgs = [];
+    get footerText() {
+        return " {cyan-fg}↑↓{/} Navigate  {cyan-fg}Enter{/} Select org  {cyan-fg}r{/} Refresh  {cyan-fg}q{/} Quit";
+    }
+    constructor(screen, ctx) {
+        this.screen = screen;
+        this.ctx = ctx;
+        this.widget = blessed.list({
+            parent: screen, top: 1, left: 0, width: "100%", height: "100%-3",
+            border: { type: "line" }, label: " Azure DevOps Organizations ",
+            tags: true, keys: true, vi: true, scrollable: true,
+            scrollbar: { ch: "│", style: { fg: "blue" } },
+            style: {
+                border: { fg: "cyan" }, selected: { bg: "blue", fg: "white" },
+                focus: { border: { fg: "white" } },
+            },
+            items: [], hidden: true,
+        });
+        this.registerKeys();
+    }
+    show() {
+        this.widget.show();
+        this.widget.focus();
+        if (this.orgs.length === 0)
+            this.load();
+        else
+            this.render();
+    }
+    hide() { this.widget.hide(); }
+    async load() {
+        this.ctx.setStatus("Loading organizations…", 0);
+        try {
+            const token = await this.ctx.getToken();
+            this.orgs = await (0, api_js_1.fetchOrgs)(token);
+            this.ctx.setStatus("", 0);
+            this.render();
+        }
+        catch (e) {
+            this.ctx.setStatus(`Error: ${e.message.slice(0, 80)}`, 10_000);
+        }
+    }
+    render() {
+        this.widget.setItems(this.orgs.map(o => o.accountName));
+        this.screen.render();
+    }
+    registerKeys() {
+        this.widget.key("enter", () => {
+            const idx = this.widget.selected ?? 0;
+            const org = this.orgs[idx];
+            if (!org)
+                return;
+            this.ctx.navigate({ view: "projects", org: org.accountName });
+        });
+        this.widget.key("r", () => {
+            this.orgs = [];
+            this.load();
+        });
+    }
+}
+exports.OrgsScreen = OrgsScreen;

package/dist/screens/ProjectsScreen.js

@@ -0,0 +1,112 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectsScreen = void 0;
+const blessed = __importStar(require("blessed"));
+const api_js_1 = require("../lib/api.js");
+class ProjectsScreen {
+    screen;
+    ctx;
+    widget;
+    org = "";
+    projects = [];
+    get footerText() {
+        return " {cyan-fg}↑↓{/} Navigate  {cyan-fg}Enter{/} Select project  {cyan-fg}Esc{/} Back  {cyan-fg}r{/} Refresh  {cyan-fg}q{/} Quit";
+    }
+    constructor(screen, ctx) {
+        this.screen = screen;
+        this.ctx = ctx;
+        this.widget = blessed.list({
+            parent: screen, top: 1, left: 0, width: "100%", height: "100%-3",
+            border: { type: "line" }, label: " Projects ",
+            tags: true, keys: true, vi: true, scrollable: true,
+            scrollbar: { ch: "│", style: { fg: "blue" } },
+            style: {
+                border: { fg: "cyan" }, selected: { bg: "blue", fg: "white" },
+                focus: { border: { fg: "white" } },
+            },
+            items: [], hidden: true,
+        });
+        this.registerKeys();
+    }
+    show(org) {
+        if (org !== this.org) {
+            this.org = org;
+            this.projects = [];
+        }
+        this.widget.setLabel(` Projects — ${org} `);
+        this.widget.show();
+        this.widget.focus();
+        if (this.projects.length === 0)
+            this.load();
+        else
+            this.render();
+    }
+    hide() { this.widget.hide(); }
+    async load() {
+        this.ctx.setStatus(`Loading projects for ${this.org}…`, 0);
+        try {
+            const token = await this.ctx.getToken();
+            this.projects = await (0, api_js_1.fetchProjects)(this.org, token);
+            this.ctx.setStatus("", 0);
+            this.render();
+        }
+        catch (e) {
+            this.ctx.setStatus(`Error: ${e.message.slice(0, 80)}`, 10_000);
+        }
+    }
+    render() {
+        this.widget.setItems(this.projects.map(p => p.name));
+        this.screen.render();
+    }
+    registerKeys() {
+        this.widget.key("enter", () => {
+            const idx = this.widget.selected ?? 0;
+            const project = this.projects[idx];
+            if (!project)
+                return;
+            this.ctx.setOrgProject(this.org, project.name);
+            this.ctx.navigate({ view: "pipelines" });
+        });
+        this.widget.key(["escape", "backspace"], () => {
+            this.ctx.navigate({ view: "orgs" });
+        });
+        this.widget.key("r", () => {
+            this.projects = [];
+            this.load();
+        });
+    }
+}
+exports.ProjectsScreen = ProjectsScreen;

package/dist/tui.js

@@ -48,18 +48,20 @@ const StagesScreen_js_1 = require("./screens/StagesScreen.js");
 const PipelineRunsScreen_js_1 = require("./screens/PipelineRunsScreen.js");
 const PipelineRunScreen_js_1 = require("./screens/PipelineRunScreen.js");
 const MappingScreen_js_1 = require("./screens/MappingScreen.js");
+const OrgsScreen_js_1 = require("./screens/OrgsScreen.js");
+const ProjectsScreen_js_1 = require("./screens/ProjectsScreen.js");
 // ── CLI args ──────────────────────────────────────────────────────────────────
 function showHelp() {
     console.log(`
 Azure Pipelines TUI
 
 Usage:
-  npx tsx src/tui.ts ORG/PROJECT                  Pipelines Overview (default)
-  npx tsx src/tui.ts ORG/PROJECT --envs            Environments Overview
-  npx tsx src/tui.ts ORG/PROJECT --stages <id>     Stages Dashboard
-  npx tsx src/tui.ts ORG/PROJECT --runs <id>       Pipeline Runs List
-  npx tsx src/tui.ts <build-url>                   Pipeline Run (single build)
-  npx tsx src/tui.ts ORG/PROJECT <buildId>         Pipeline Run (single build)
+  npx azure-pipelines-tui ORG/PROJECT                  Pipelines Overview (default)
+  npx azure-pipelines-tui ORG/PROJECT --envs            Environments Overview
+  npx azure-pipelines-tui ORG/PROJECT --stages <id>     Stages Dashboard
+  npx azure-pipelines-tui ORG/PROJECT --runs <id>       Pipeline Runs List
+  npx azure-pipelines-tui <build-url>                   Pipeline Run (single build)
+  npx azure-pipelines-tui ORG/PROJECT <buildId>         Pipeline Run (single build)
 
 Options:
   --config <file>       Config file (default: environments-config.json)
@@ -140,6 +142,8 @@ else if (RUNS_ARG)
     INITIAL_VIEW = "runs";
 else if (ENVS_FLAG)
     INITIAL_VIEW = "environments";
+else if (!ORG)
+    INITIAL_VIEW = "orgs";
 // ── Main ──────────────────────────────────────────────────────────────────────
 async function main() {
     const config = (0, api_js_1.loadConfig)(CONFIG_FILE);
@@ -147,13 +151,15 @@ async function main() {
         ORG = config.org ?? "";
     if (!PROJECT)
         PROJECT = config.project ?? "";
-    if (!ORG || !PROJECT) {
+    if ((!ORG || !PROJECT) && INITIAL_VIEW !== "orgs") {
         console.error("Error: org/project required. Pass as 'org/project' argument or set in environments-config.json.\n" +
             "Run with --help for usage.");
         process.exit(1);
     }
-    config.org = ORG;
-    config.project = PROJECT;
+    if (ORG)
+        config.org = ORG;
+    if (PROJECT)
+        config.project = PROJECT;
     // ── Shared state ──────────────────────────────────────────────────────────
     const state = { pipelines: [] };
     // ── Screen + widgets ──────────────────────────────────────────────────────
@@ -169,7 +175,7 @@ async function main() {
     const headerBox = blessed.box({
         parent: screen, top: 0, left: 0, width: "100%", height: 1, tags: true,
         style: { bg: "blue", fg: "white", bold: true },
-        content: ` {bold}Azure Pipelines TUI{/bold}  ${ORG} / ${PROJECT}`,
+        content: ` {bold}Azure Pipelines TUI{/bold}`,
     });
     const footerBox = blessed.box({
         parent: screen, bottom: 0, left: 0, width: "100%", height: 1, tags: true,
@@ -192,7 +198,13 @@ async function main() {
     let currentDest = { view: "pipelines" };
     function updateHeader() {
         let content;
-        if (currentView === "pipelineRun") {
+        if (currentView === "orgs") {
+            content = ` {bold}Azure Pipelines TUI{/bold}  Select organization`;
+        }
+        else if (currentView === "projects") {
+            content = ` {bold}Azure Pipelines TUI{/bold}  ${ORG}  — Select project`;
+        }
+        else if (currentView === "pipelineRun") {
             const run = screens.pipelineRun;
             const build = run.getBuild();
             const id = run.getBuildId();
@@ -242,6 +254,12 @@ async function main() {
         currentView = dest.view;
         hideAll();
         switch (dest.view) {
+            case "orgs":
+                screens.orgs.show();
+                break;
+            case "projects":
+                screens.projects.show(dest.org);
+                break;
             case "pipelines":
                 screens.pipelines.show();
                 break;
@@ -269,14 +287,21 @@ async function main() {
     }
     // ── App context ────────────────────────────────────────────────────────────
     const ctx = {
-        org: ORG,
-        project: PROJECT,
+        get org() { return ORG; },
+        get project() { return PROJECT; },
         config,
         state,
         getToken: () => (0, api_js_1.getToken)(config.azConfigDir),
         navigate,
         goBack,
         setStatus,
+        setOrgProject(org, project) {
+            ORG = org;
+            PROJECT = project;
+            config.org = org;
+            config.project = project;
+            state.pipelines = [];
+        },
         loadPipelineDefinitions: async () => {
             if (state.pipelines.length > 0)
                 return;
@@ -294,6 +319,8 @@ async function main() {
     // ── Create screens ─────────────────────────────────────────────────────────
     const envScreen = new EnvironmentsScreen_js_1.EnvironmentsScreen(screen, ctx);
     const screens = {
+        orgs: new OrgsScreen_js_1.OrgsScreen(screen, ctx),
+        projects: new ProjectsScreen_js_1.ProjectsScreen(screen, ctx),
         pipelines: new PipelinesScreen_js_1.PipelinesScreen(screen, ctx),
         environments: envScreen,
         stages: new StagesScreen_js_1.StagesScreen(screen, ctx),
@@ -314,7 +341,10 @@ async function main() {
         }
     });
     // ── Initial navigation ────────────────────────────────────────────────────
-    if (INITIAL_VIEW === "pipelineRun" && INITIAL_BUILD_ID) {
+    if (INITIAL_VIEW === "orgs") {
+        navigate({ view: "orgs" });
+    }
+    else if (INITIAL_VIEW === "pipelineRun" && INITIAL_BUILD_ID) {
         navigate({ view: "pipelineRun", buildId: INITIAL_BUILD_ID });
     }
     else if (INITIAL_VIEW === "stages" && STAGES_ARG) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "azure-pipelines-tui",
-  "version": "0.5.1",
-  "description": "Azure Pipelines TUI log viewer",
+  "version": "0.5.3",
+  "description": "Azure Pipelines TUI",
   "bin": {
     "azure-pipelines-tui": "./dist/tui.js"
   },