azure-pipelines-tui 0.5.0

package/dist/tui.js

@@ -0,0 +1,358 @@
+#!/usr/bin/env node
+"use strict";
+// tui.ts — Unified Azure Pipelines TUI entry point
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const os_1 = __importDefault(require("os"));
+const url_1 = require("url");
+const blessed = __importStar(require("blessed"));
+const api_js_1 = require("./lib/api.js");
+const PipelinesScreen_js_1 = require("./screens/PipelinesScreen.js");
+const EnvironmentsScreen_js_1 = require("./screens/EnvironmentsScreen.js");
+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");
+// ── 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)
+
+Options:
+  --config <file>       Config file (default: environments-config.json)
+  --stages <id>         Pipeline ID or name to open stages view directly
+  --runs <id>           Pipeline ID or name to open runs list directly
+  --envs                Open environments overview
+  --keep-timestamps     Keep timestamps in log output
+  --help                Show this help
+
+Cache location: ${os_1.default.homedir()}/.azure-pipelines-tui/cache/
+`);
+    process.exit(0);
+}
+const rawArgs = process.argv.slice(2);
+if (rawArgs.includes("--help"))
+    showHelp();
+const flagsWithValues = new Set(["--config", "--stages", "--runs"]);
+const positional = [];
+for (let i = 0; i < rawArgs.length; i++) {
+    const a = rawArgs[i];
+    if (a.startsWith("--")) {
+        if (flagsWithValues.has(a))
+            i++;
+        continue;
+    }
+    positional.push(a);
+}
+const configIdx = rawArgs.indexOf("--config");
+const CONFIG_FILE = configIdx >= 0 ? rawArgs[configIdx + 1] : "environments-config.json";
+const stagesIdx = rawArgs.indexOf("--stages");
+const STAGES_ARG = stagesIdx >= 0 ? rawArgs[stagesIdx + 1] : undefined;
+const runsIdx = rawArgs.indexOf("--runs");
+const RUNS_ARG = runsIdx >= 0 ? rawArgs[runsIdx + 1] : undefined;
+const ENVS_FLAG = rawArgs.includes("--envs");
+const KEEP_TIMESTAMPS = rawArgs.includes("--keep-timestamps");
+function parseAdoUrl(raw) {
+    try {
+        const u = new url_1.URL(raw);
+        if (u.hostname !== "dev.azure.com")
+            return null;
+        const parts = u.pathname.split("/").filter(Boolean);
+        if (parts.length < 2)
+            return null;
+        return { org: parts[0], project: parts[1], buildId: u.searchParams.get("buildId") ?? undefined };
+    }
+    catch {
+        return null;
+    }
+}
+let ORG = "";
+let PROJECT = "";
+let INITIAL_BUILD_ID;
+let INITIAL_VIEW = "pipelines";
+const parsed = positional.length >= 1 ? parseAdoUrl(positional[0]) : null;
+if (parsed) {
+    ORG = parsed.org;
+    PROJECT = parsed.project;
+    INITIAL_BUILD_ID = parsed.buildId ?? (positional.length >= 2 ? positional[1] : undefined);
+}
+else if (positional.length >= 3) {
+    [ORG, PROJECT, INITIAL_BUILD_ID] = positional;
+}
+else if (positional.length >= 1 && positional[0].includes("/")) {
+    const [org, ...rest] = positional[0].split("/");
+    ORG = org;
+    PROJECT = rest.join("/");
+    if (positional.length >= 2)
+        INITIAL_BUILD_ID = positional[1];
+}
+else if (positional.length >= 2) {
+    [ORG, PROJECT] = positional;
+}
+if (INITIAL_BUILD_ID)
+    INITIAL_VIEW = "pipelineRun";
+else if (STAGES_ARG)
+    INITIAL_VIEW = "stages";
+else if (RUNS_ARG)
+    INITIAL_VIEW = "runs";
+else if (ENVS_FLAG)
+    INITIAL_VIEW = "environments";
+// ── Main ──────────────────────────────────────────────────────────────────────
+async function main() {
+    const config = (0, api_js_1.loadConfig)(CONFIG_FILE);
+    if (!ORG)
+        ORG = config.org ?? "";
+    if (!PROJECT)
+        PROJECT = config.project ?? "";
+    if (!ORG || !PROJECT) {
+        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;
+    // ── Shared state ──────────────────────────────────────────────────────────
+    const state = { pipelines: [] };
+    // ── Screen + widgets ──────────────────────────────────────────────────────
+    const screen = blessed.screen({
+        smartCSR: true, title: "Azure Pipelines TUI",
+        fullUnicode: true, forceUnicode: true,
+    });
+    process.stdout.write("\x1b[?25l");
+    const restoreCursor = () => process.stdout.write("\x1b[?25h");
+    screen.on("destroy", restoreCursor);
+    process.on("exit", restoreCursor);
+    process.on("SIGINT", () => { restoreCursor(); process.exit(0); });
+    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}`,
+    });
+    const footerBox = blessed.box({
+        parent: screen, bottom: 0, left: 0, width: "100%", height: 1, tags: true,
+        style: { bg: "black", fg: "gray" },
+    });
+    // ── Status bar ─────────────────────────────────────────────────────────────
+    let statusMsg = "";
+    let statusTimer = null;
+    function setStatus(msg, ttlMs = 3000) {
+        statusMsg = msg;
+        if (statusTimer)
+            clearTimeout(statusTimer);
+        if (ttlMs > 0 && msg)
+            statusTimer = setTimeout(() => { statusMsg = ""; renderFooter(); }, ttlMs);
+        renderFooter();
+    }
+    // ── Navigation ─────────────────────────────────────────────────────────────
+    let currentView = INITIAL_VIEW;
+    let previousDest = { view: "pipelines" };
+    let currentDest = { view: "pipelines" };
+    function updateHeader() {
+        let content;
+        if (currentView === "pipelineRun") {
+            const run = screens.pipelineRun;
+            const build = run.getBuild();
+            const id = run.getBuildId();
+            const statusTag = !build
+                ? "{yellow-fg}loading…{/}"
+                : build.status === "completed"
+                    ? build.result === "succeeded" ? "{green-fg}succeeded{/}"
+                        : build.result === "failed" ? "{red-fg}failed{/}"
+                            : build.result === "canceled" ? "{gray-fg}canceled{/}"
+                                : (build.result ?? "completed")
+                    : build.status === "inProgress" ? "{yellow-fg}▶ running{/}"
+                        : build.status === "notStarted" ? "{gray-fg}waiting…{/}"
+                            : build.status;
+            content = ` {bold}Azure Pipelines{/bold}  ${ORG} / ${PROJECT}  #{bold}${id}{/bold}  ${statusTag}`;
+        }
+        else if (currentView === "stages") {
+            const pip = screens.stages.getPipeline();
+            content = ` {bold}Azure Pipelines{/bold}  ${ORG} / ${PROJECT}  Stages: ${pip?.name ?? ""}`;
+        }
+        else if (currentView === "runs") {
+            const pip = screens.runs.getPipeline();
+            content = ` {bold}Azure Pipelines{/bold}  ${ORG} / ${PROJECT}  Runs: ${pip?.name ?? ""}`;
+        }
+        else if (currentView === "environments") {
+            content = ` {bold}Azure Pipelines Environments{/bold}  ${ORG} / ${PROJECT}`;
+        }
+        else {
+            content = ` {bold}Azure Pipelines TUI{/bold}  ${ORG} / ${PROJECT}`;
+        }
+        headerBox.setContent(content);
+        screen.render();
+    }
+    function renderFooter() {
+        const s = statusMsg ? `  {yellow-fg}${statusMsg}{/}` : "";
+        const screenObj = screens[currentView];
+        const base = screenObj.footerText ?? "";
+        footerBox.setContent(base + s);
+        screen.render();
+    }
+    function hideAll() {
+        for (const s of Object.values(screens))
+            s.hide();
+    }
+    function navigate(dest) {
+        previousDest = currentDest;
+        currentDest = dest;
+        currentView = dest.view;
+        hideAll();
+        switch (dest.view) {
+            case "pipelines":
+                screens.pipelines.show();
+                break;
+            case "environments":
+                screens.environments.show();
+                break;
+            case "mapping":
+                screens.mapping.show();
+                break;
+            case "stages":
+                screens.stages.show(dest.pipeline);
+                break;
+            case "runs":
+                screens.runs.show(dest.pipeline);
+                break;
+            case "pipelineRun":
+                screens.pipelineRun.show(dest.buildId);
+                break;
+        }
+        updateHeader();
+        renderFooter();
+    }
+    function goBack() {
+        navigate(previousDest);
+    }
+    // ── App context ────────────────────────────────────────────────────────────
+    const ctx = {
+        org: ORG,
+        project: PROJECT,
+        config,
+        state,
+        getToken: () => (0, api_js_1.getToken)(config.azConfigDir),
+        navigate,
+        goBack,
+        setStatus,
+        loadPipelineDefinitions: async () => {
+            if (state.pipelines.length > 0)
+                return;
+            setStatus("Loading pipeline definitions…", 0);
+            try {
+                const token = await (0, api_js_1.getToken)(config.azConfigDir);
+                state.pipelines = await (0, api_js_1.fetchPipelineDefinitions)(ORG, PROJECT, token);
+                setStatus("", 0);
+            }
+            catch (e) {
+                setStatus(`Error: ${e.message.slice(0, 80)}`, 10_000);
+            }
+        },
+    };
+    // ── Create screens ─────────────────────────────────────────────────────────
+    const envScreen = new EnvironmentsScreen_js_1.EnvironmentsScreen(screen, ctx);
+    const screens = {
+        pipelines: new PipelinesScreen_js_1.PipelinesScreen(screen, ctx),
+        environments: envScreen,
+        stages: new StagesScreen_js_1.StagesScreen(screen, ctx),
+        runs: new PipelineRunsScreen_js_1.PipelineRunsScreen(screen, ctx),
+        pipelineRun: new PipelineRunScreen_js_1.PipelineRunScreen(screen, ctx, { keepTimestamps: KEEP_TIMESTAMPS }),
+        mapping: new MappingScreen_js_1.MappingScreen(screen, ctx, envScreen, CONFIG_FILE),
+    };
+    // ── Global keys ────────────────────────────────────────────────────────────
+    screen.key(["q", "C-c"], () => { screen.destroy(); process.exit(0); });
+    screen.key("tab", () => {
+        if (currentView === "pipelineRun") {
+            const { treeWidget, logWidget } = screens.pipelineRun;
+            if (screen.focused === treeWidget)
+                logWidget.focus();
+            else
+                treeWidget.focus();
+            screen.render();
+        }
+    });
+    // ── Initial navigation ────────────────────────────────────────────────────
+    if (INITIAL_VIEW === "pipelineRun" && INITIAL_BUILD_ID) {
+        navigate({ view: "pipelineRun", buildId: INITIAL_BUILD_ID });
+    }
+    else if (INITIAL_VIEW === "stages" && STAGES_ARG) {
+        navigate({ view: "pipelines" });
+        setStatus("Loading pipeline definitions…", 0);
+        ctx.loadPipelineDefinitions().then(() => {
+            const byId = Number(STAGES_ARG);
+            const pip = byId
+                ? state.pipelines.find(p => p.id === byId)
+                : state.pipelines.find(p => p.name.toLowerCase() === STAGES_ARG.toLowerCase());
+            if (!pip)
+                setStatus(`Pipeline "${STAGES_ARG}" not found`, 10_000);
+            else
+                navigate({ view: "stages", pipeline: pip });
+        });
+    }
+    else if (INITIAL_VIEW === "runs" && RUNS_ARG) {
+        navigate({ view: "pipelines" });
+        setStatus("Loading pipeline definitions…", 0);
+        ctx.loadPipelineDefinitions().then(() => {
+            const byId = Number(RUNS_ARG);
+            const pip = byId
+                ? state.pipelines.find(p => p.id === byId)
+                : state.pipelines.find(p => p.name.toLowerCase() === RUNS_ARG.toLowerCase());
+            if (!pip)
+                setStatus(`Pipeline "${RUNS_ARG}" not found`, 10_000);
+            else
+                navigate({ view: "runs", pipeline: pip });
+        });
+    }
+    else if (INITIAL_VIEW === "environments") {
+        navigate({ view: "environments" });
+    }
+    else {
+        navigate({ view: "pipelines" });
+    }
+}
+main().catch(err => {
+    console.error("Fatal:", err.message);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "azure-pipelines-tui",
+  "version": "0.5.0",
+  "description": "Azure Pipelines TUI log viewer",
+  "bin": {
+    "azure-pipelines-tui": "./dist/tui.js"
+  },
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "start": "tsx src/tui.ts",
+    "build": "tsc",
+    "prepare": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "blessed": "^0.1.81",
+    "ws": "^8.20.1"
+  },
+  "devDependencies": {
+    "@types/blessed": "^0.1.25",
+    "@types/node": "^22.19.19",
+    "@types/ws": "^8.18.1",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  }
+}