@bhimudev/gnanai 0.4.0

package/dist/utils/ci-status.js

@@ -0,0 +1,349 @@
+import { execSync } from "child_process";
+import { logger } from "./logger.js";
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Enhanced CLI command executor with rate-limit and auth-failure detection.
+ * NOT exported -- internal to ci-status.ts only.
+ */
+function ciExec(cmd, ctx) {
+    const cwd = ctx.config?.projectRoot ?? process.cwd();
+    const timeout = ctx.config?.timeout ?? 10000;
+    const env = { ...process.env };
+    delete env.GIT_DIR;
+    delete env.GIT_WORK_TREE;
+    delete env.GIT_INDEX_FILE;
+    delete env.GIT_QUARANTINE_PATH;
+    try {
+        const result = execSync(cmd, {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+            timeout,
+            cwd,
+            env,
+        });
+        return { output: result.trim() || null, rateLimited: false, authError: false };
+    }
+    catch (error) {
+        const stderr = error?.stderr?.toString?.() ?? "";
+        const stdout = error?.stdout?.toString?.() ?? "";
+        const combined = stderr + stdout;
+        // Rate-limit detection
+        if (/rate limit|API rate limit exceeded|429|too many requests/i.test(combined)) {
+            return { output: null, rateLimited: true, authError: false };
+        }
+        // Auth failure detection
+        if (/auth.*(fail|denied|required)|(HTTP )?(401|403)|not logged in|gh auth login|glab auth login/i.test(combined)) {
+            return { output: null, rateLimited: false, authError: true };
+        }
+        return { output: null, rateLimited: false, authError: false };
+    }
+}
+// ---------------------------------------------------------------------------
+// Pure utility functions
+// ---------------------------------------------------------------------------
+/**
+ * Truncate a log to the last maxLines lines.
+ * Normalizes CRLF to LF. Prepends a truncation message if truncated.
+ */
+export function truncateLog(log, maxLines = 200) {
+    if (log === "")
+        return "";
+    // Normalize CRLF to LF
+    const normalized = log.replace(/\r\n/g, "\n");
+    const lines = normalized.split("\n");
+    // Remove trailing empty line from trailing newline
+    if (lines[lines.length - 1] === "") {
+        lines.pop();
+    }
+    if (lines.length <= maxLines) {
+        return lines.join("\n");
+    }
+    const truncated = lines.slice(lines.length - maxLines);
+    const droppedCount = lines.length - maxLines;
+    return `[...truncated ${droppedCount} lines...]\n${truncated.join("\n")}`;
+}
+/**
+ * Compute exponential backoff delay with jitter.
+ * Base: 1000ms * 2^attempt, capped at 60000ms, plus random jitter up to 1000ms.
+ */
+export function exponentialBackoff(attempt) {
+    const delay = Math.min(1000 * Math.pow(2, attempt), 60000);
+    return delay + Math.random() * 1000;
+}
+/**
+ * Classify a failure based on log content using regex pattern matching.
+ * Priority order: infrastructure > timeout > lint > test > build > deploy > unknown.
+ */
+export function classifyFailure(logs) {
+    if (!logs || !logs.trim())
+        return "unknown";
+    const patterns = [
+        ["infrastructure", /out of memory|OOM|no space left|connection refused|runner.*offline/i],
+        ["timeout", /timed? ?out|timeout|exceeded.*time.*limit/i],
+        ["lint", /eslint|prettier|stylelint|linting failed|lint error|tslint/i],
+        ["test", /tests? failed|FAIL\s|AssertionError|vitest|jest|mocha|pytest/i],
+        ["build", /build failed|compilation error|tsc.*error|error TS\d+|webpack|Cannot find module/i],
+        ["deploy", /deploy failed|kubectl|docker push|helm|terraform/i],
+    ];
+    for (const [type, regex] of patterns) {
+        if (regex.test(logs))
+            return type;
+    }
+    return "unknown";
+}
+// ---------------------------------------------------------------------------
+// Status checking
+// ---------------------------------------------------------------------------
+/**
+ * Check pipeline status with extended semantics (not_found, not_configured).
+ * Note: Returns "not_found" for ANY null from provider, including network errors.
+ * The grace period in waitForPipelineCompletion handles transient errors by retrying.
+ */
+export async function checkPipelineStatus(ctx, branch, commit) {
+    if (ctx.provider.getProviderName() === "none") {
+        return { status: "not_configured", pipeline: null };
+    }
+    const result = await ctx.provider.getPipelineStatus(branch, commit);
+    if (result === null) {
+        return { status: "not_found", pipeline: null };
+    }
+    return { status: result.status, pipeline: result };
+}
+// ---------------------------------------------------------------------------
+// Wait for completion
+// ---------------------------------------------------------------------------
+const TERMINAL_STATUSES = ["success", "failed", "cancelled"];
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Wait for a pipeline to reach a terminal status with grace period support.
+ * Does NOT call ctx.provider.waitForPipeline() -- supersedes it with grace period
+ * and better not_found handling.
+ *
+ * Known limitation: Rate-limit detection is NOT possible in the polling path because
+ * CIProvider.getPipelineStatus() swallows all errors. Rate-limit detection is only
+ * available in getFailingJobLogs via ciExec.
+ */
+export async function waitForPipelineCompletion(ctx, branch, options) {
+    if (ctx.provider.getProviderName() === "none") {
+        return { status: "not_configured", timedOut: false, pipeline: null };
+    }
+    const pollInterval = options?.pollInterval ?? 15000;
+    const maxWait = options?.maxWait ?? 600000;
+    const gracePeriod = options?.gracePeriod ?? 60000;
+    const startTime = Date.now();
+    // Phase 1: Grace period -- wait for pipeline to appear
+    let lastCheck = await checkPipelineStatus(ctx, branch);
+    if (lastCheck.status === "not_found" || lastCheck.status === "not_configured") {
+        // Pipeline not yet found, enter grace period polling
+        while (Date.now() - startTime < gracePeriod) {
+            if (lastCheck.status !== "not_found" && lastCheck.status !== "not_configured") {
+                break; // Pipeline found, exit grace period
+            }
+            await sleep(pollInterval);
+            lastCheck = await checkPipelineStatus(ctx, branch);
+        }
+        // If still not found after grace period, return not_found
+        if (lastCheck.status === "not_found" || lastCheck.status === "not_configured") {
+            return { status: "not_found", timedOut: false, pipeline: null };
+        }
+    }
+    // Phase 2: Wait for terminal status
+    let lastStatus = lastCheck.status;
+    let lastPipeline = lastCheck.pipeline;
+    if (TERMINAL_STATUSES.includes(lastStatus)) {
+        return { status: lastStatus, timedOut: false, pipeline: lastPipeline };
+    }
+    while (Date.now() - startTime < maxWait) {
+        await sleep(pollInterval);
+        const check = await checkPipelineStatus(ctx, branch);
+        lastStatus = check.status;
+        lastPipeline = check.pipeline;
+        if (TERMINAL_STATUSES.includes(lastStatus)) {
+            return { status: lastStatus, timedOut: false, pipeline: lastPipeline };
+        }
+    }
+    return { status: lastStatus, timedOut: true, pipeline: lastPipeline };
+}
+// ---------------------------------------------------------------------------
+// Parsers
+// ---------------------------------------------------------------------------
+/**
+ * Parse GitHub Actions --log-failed output into per-job logs.
+ * Each line is tab-separated: jobName TAB stepName TAB timestamp message.
+ * Groups lines by job name, extracts message portion after the timestamp.
+ */
+export function parseGitHubFailedLogs(output) {
+    if (!output || !output.trim())
+        return [];
+    const lines = output.split("\n");
+    const jobMap = new Map();
+    const jobOrder = [];
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        const parts = line.split("\t");
+        if (parts.length < 3) {
+            // Malformed line -- treat entire output as single job
+            if (!jobMap.has("unknown")) {
+                jobMap.set("unknown", []);
+                jobOrder.push("unknown");
+            }
+            jobMap.get("unknown").push(line);
+            continue;
+        }
+        const jobName = parts[0];
+        // Message is everything after the second tab and the timestamp prefix
+        // Format: "2026-03-04T10:00:00Z actual message"
+        const timestampAndMessage = parts.slice(2).join("\t");
+        // Strip the ISO timestamp prefix (first space-delimited token)
+        const spaceIdx = timestampAndMessage.indexOf(" ");
+        const message = spaceIdx >= 0 ? timestampAndMessage.substring(spaceIdx + 1) : timestampAndMessage;
+        if (!jobMap.has(jobName)) {
+            jobMap.set(jobName, []);
+            jobOrder.push(jobName);
+        }
+        jobMap.get(jobName).push(message);
+    }
+    return jobOrder.map((name) => ({
+        name,
+        log: jobMap.get(name).join("\n"),
+    }));
+}
+/**
+ * Parse GitLab REST API job list JSON response.
+ * Filters to failed jobs only.
+ */
+export function parseGitLabJobList(jsonOutput) {
+    try {
+        const parsed = JSON.parse(jsonOutput);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed
+            .filter((item) => item.status === "failed")
+            .map((item) => ({
+            id: String(item.id),
+            name: item.name,
+            status: item.status,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+// ---------------------------------------------------------------------------
+// Failing job logs
+// ---------------------------------------------------------------------------
+/**
+ * Fetch logs for failing jobs only in a pipeline.
+ * Uses CLI commands directly via ciExec for per-job log extraction.
+ */
+export async function getFailingJobLogs(ctx, pipelineId) {
+    const providerName = ctx.provider.getProviderName();
+    if (providerName === "none")
+        return [];
+    if (ctx.config === null)
+        return [];
+    if (providerName === "github") {
+        return getGitHubFailingJobLogs(ctx, pipelineId);
+    }
+    if (providerName === "gitlab") {
+        return getGitLabFailingJobLogs(ctx, pipelineId);
+    }
+    return [];
+}
+async function getGitHubFailingJobLogs(ctx, pipelineId) {
+    const result = ciExec(`gh run view ${pipelineId} --log-failed`, ctx);
+    if (result.authError) {
+        logger.warn("CI authentication failed. Run gh auth login to authenticate with GitHub Actions.");
+        return [];
+    }
+    if (result.rateLimited) {
+        logger.warn("CI API rate limited while fetching logs");
+        return [];
+    }
+    if (result.output === null)
+        return [];
+    const jobs = parseGitHubFailedLogs(result.output);
+    return jobs.map((job) => ({
+        name: job.name,
+        log: truncateLog(job.log, 200),
+    }));
+}
+async function getGitLabFailingJobLogs(ctx, pipelineId) {
+    if (!ctx.config?.projectPath) {
+        logger.warn("GitLab API unavailable: no project path detected.");
+        // Fallback to glab ci view
+        const token = process.env.GITLAB_TOKEN || process.env.CI_JOB_TOKEN;
+        if (!token) {
+            const fallbackResult = ciExec(`glab ci view ${pipelineId}`, ctx);
+            if (fallbackResult.output) {
+                return [{ name: "pipeline", log: truncateLog(fallbackResult.output, 200) }];
+            }
+            return [];
+        }
+        return [];
+    }
+    const token = process.env.GITLAB_TOKEN || process.env.CI_JOB_TOKEN;
+    if (!token) {
+        // Fallback to glab ci view
+        const fallbackResult = ciExec(`glab ci view ${pipelineId}`, ctx);
+        if (fallbackResult.authError) {
+            logger.warn("CI authentication failed. Run glab auth login or set GITLAB_TOKEN to authenticate with GitLab CI.");
+            return [];
+        }
+        if (fallbackResult.output) {
+            return [{ name: "pipeline", log: truncateLog(fallbackResult.output, 200) }];
+        }
+        return [];
+    }
+    // Use GitLab REST API for per-job logs
+    const apiBase = ctx.config.apiBaseUrl || "https://gitlab.com/api/v4";
+    const encodedPath = ctx.config.projectPath
+        .split("/")
+        .map(encodeURIComponent)
+        .join("%2F");
+    // Get failed jobs list
+    const jobListResult = ciExec(`curl -s -H "PRIVATE-TOKEN: ${token}" "${apiBase}/projects/${encodedPath}/pipelines/${pipelineId}/jobs?scope=failed"`, ctx);
+    if (jobListResult.authError) {
+        logger.warn("CI authentication failed. Run glab auth login or set GITLAB_TOKEN to authenticate with GitLab CI.");
+        return [];
+    }
+    if (jobListResult.rateLimited) {
+        logger.warn("CI API rate limited while fetching logs");
+        return [];
+    }
+    if (jobListResult.output === null)
+        return [];
+    const failedJobs = parseGitLabJobList(jobListResult.output);
+    const result = [];
+    for (const job of failedJobs) {
+        const traceResult = ciExec(`curl -s -H "PRIVATE-TOKEN: ${token}" "${apiBase}/projects/${encodedPath}/jobs/${job.id}/trace"`, ctx);
+        const logText = traceResult.output ?? "";
+        result.push({
+            name: job.name,
+            log: truncateLog(logText, 200),
+        });
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Report builder
+// ---------------------------------------------------------------------------
+/**
+ * Assemble a structured CIFailureReport from pipeline data, failing jobs, and failure type.
+ */
+export function buildFailureReport(pipeline, failingJobs, failureType) {
+    return {
+        pipelineId: pipeline.id,
+        status: pipeline.status,
+        failureType,
+        failingJobs,
+        url: pipeline.url,
+        timestamp: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=ci-status.js.map

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

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

package/dist/utils/dependency-analysis.d.ts

@@ -0,0 +1,34 @@
+import type { TaskSpec } from '../types/task.js';
+import type { ExecutionGroup } from '../types/dependency-analysis.js';
+/**
+ * Error thrown when cyclic dependencies are detected among tasks.
+ */
+export declare class CyclicDependencyError extends Error {
+    /** The task IDs forming the cycle */
+    readonly cycle: string[];
+    constructor(cycle: string[]);
+}
+/**
+ * Normalize a filesystem path for comparison.
+ */
+export declare function normalizePath(p: string): string;
+/**
+ * Parse affected area paths from a task body markdown.
+ * Returns null if no Affected Areas section found, or string[] of normalized paths.
+ */
+export declare function parseAffectedAreas(body: string): string[] | null;
+/**
+ * Check if two sets of paths have hierarchical overlap.
+ * Paths should already be normalized (trailing slash, lowercase).
+ */
+export declare function pathsOverlap(pathsA: string[], pathsB: string[]): boolean;
+/**
+ * Build an execution graph from task specs.
+ * Returns an ordered list of execution groups where tasks within a group
+ * are independent (can run in parallel) and groups must execute sequentially.
+ *
+ * Note: Only `depends_on` is consulted for explicit dependencies.
+ * The `blocks` field is not used by this function.
+ */
+export declare function buildExecutionGraph(tasks: TaskSpec[]): ExecutionGroup[];
+//# sourceMappingURL=dependency-analysis.d.ts.map

package/dist/utils/dependency-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-analysis.d.ts","sourceRoot":"","sources":["../../src/utils/dependency-analysis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,qCAAqC;IACrC,SAAgB,KAAK,EAAE,MAAM,EAAE,CAAC;gBAEpB,KAAK,EAAE,MAAM,EAAE;CAM5B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAY/C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAkChE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAcxE;AAoMD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE,CAwDvE"}