@foundation0/git 1.2.4 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foundation0/git",
-  "version": "1.2.4",
+  "version": "1.3.0",
   "description": "Foundation 0 Git API and MCP server",
   "type": "module",
   "bin": {

package/src/actions-api.ts

@@ -9,9 +9,25 @@ const isRecord = (value: unknown): value is Record<string, unknown> =>
   typeof value === 'object' && value !== null && !Array.isArray(value)
 
 const toTrimmedString = (value: unknown): string | null => {
+  if (value === null || value === undefined) {
+    return null
+  }
+
+  if (typeof value === 'number') {
+    if (!Number.isFinite(value)) return null
+    const asText = String(Math.trunc(value)).trim()
+    return asText.length > 0 ? asText : null
+  }
+
+  if (typeof value === 'bigint') {
+    const asText = value.toString().trim()
+    return asText.length > 0 ? asText : null
+  }
+
   if (typeof value !== 'string') {
     return null
   }
+
   const trimmed = value.trim()
   return trimmed.length > 0 ? trimmed : null
 }
@@ -162,6 +178,19 @@ const resolveOwnerRepoFromArgs = (
   return { ...resolved, rest: args }
 }
 
+type NormalizedActionsState = 'success' | 'failure' | 'pending'
+
+const normalizeActionsState = (raw: unknown): NormalizedActionsState => {
+  const value = toTrimmedString(raw).toLowerCase()
+  if (value === 'success') return 'success'
+  if (value === 'failure' || value === 'failed' || value === 'error') return 'failure'
+  if (value === 'cancelled' || value === 'canceled') return 'failure'
+  if (value === 'skipped') return 'success'
+  if (value === 'running' || value === 'in_progress' || value === 'queued' || value === 'waiting') return 'pending'
+  if (value === 'pending') return 'pending'
+  return 'pending'
+}
+
 const resolveOwnerRepoAndId = (
   rawArgs: unknown[],
   defaults: GitActionsApiDefaults,
@@ -495,10 +524,24 @@ export const createGitActionsApi = (api: GitServiceApi, ctx: GitActionsApiContex
         throw new Error(`No matching run found in actions/tasks for head_sha=${sha} run_number=${run}.`)
       }
 
-      const jobId = match.id
-      const jobIdText = toTrimmedString(jobId)
+      const jobIdCandidate =
+        (match as Record<string, unknown>).job_id ??
+        (match as Record<string, unknown>).jobId ??
+        (match as Record<string, unknown>).task_id ??
+        (match as Record<string, unknown>).taskId ??
+        (match as Record<string, unknown>).id
+
+      const jobIdText = toTrimmedString(jobIdCandidate)
       if (!jobIdText) {
-        throw new Error('Matched run entry does not expose an id usable as job_id.')
+        const keys = Object.keys(match).slice(0, 32).join(',')
+        const preview = (() => {
+          try {
+            return JSON.stringify(match).slice(0, 500)
+          } catch {
+            return ''
+          }
+        })()
+        throw new Error(`Matched run entry does not expose an id usable as job_id. keys=[${keys}] preview=${preview}`)
       }
 
       const logs = await requestGitea(
@@ -524,6 +567,109 @@ export const createGitActionsApi = (api: GitServiceApi, ctx: GitActionsApiContex
       }
     },
 
+    diagnoseLatestFailure: async (ownerOrOptions?: unknown, repoOrOptions?: unknown, maybeOptions?: unknown) => {
+      const parsed = normalizeScopeArgs(ownerOrOptions, repoOrOptions, maybeOptions)
+      // Allow calling with a single object payload: { owner, repo, workflowName, ... }.
+      const scope = normalizeScopeArgs(parsed.options.owner, parsed.options.repo, parsed.options)
+      const { owner, repo } = resolveOwnerRepo(scope, defaults)
+
+      const workflowNameRaw = typeof scope.options.workflowName === 'string' ? scope.options.workflowName.trim() : ''
+      const workflowName = workflowNameRaw.length > 0 ? workflowNameRaw : null
+      const maxLines = toPositiveInteger(scope.options.maxLines) ?? DEFAULT_LOG_TAIL_LINES
+      const maxBytes = toPositiveInteger(scope.options.maxBytes)
+      const contains = typeof scope.options.contains === 'string' ? scope.options.contains : undefined
+      const limit = toPositiveInteger(scope.options.limit) ?? 50
+
+      const tasks = await requestGitea(
+        ctx,
+        ['actions', 'tasks', 'list'],
+        owner,
+        repo,
+        'GET',
+        ['tasks'],
+        { ...scope.options, query: { ...(isRecord(scope.options.query) ? scope.options.query : {}), limit } },
+      )
+
+      const entries = isRecord(tasks.body) && Array.isArray(tasks.body.workflow_runs)
+        ? (tasks.body.workflow_runs as unknown[])
+        : []
+
+      const normalizedWorkflowName = workflowName ? workflowName.toLowerCase() : null
+      const failing = entries
+        .filter((entry) => isRecord(entry))
+        .filter((entry) => normalizeActionsState((entry as Record<string, unknown>).status) === 'failure')
+        .filter((entry) => {
+          if (!normalizedWorkflowName) return true
+          const name = String((entry as Record<string, unknown>).name ?? '').toLowerCase()
+          const displayTitle = String((entry as Record<string, unknown>).display_title ?? '').toLowerCase()
+          return name.includes(normalizedWorkflowName) || displayTitle.includes(normalizedWorkflowName)
+        })
+        .sort((a, b) => {
+          const aRecord = a as Record<string, unknown>
+          const bRecord = b as Record<string, unknown>
+          const aUpdated = Date.parse(String(aRecord.updated_at ?? '')) || 0
+          const bUpdated = Date.parse(String(bRecord.updated_at ?? '')) || 0
+          return bUpdated - aUpdated
+        })
+
+      const match = failing[0]
+      if (!match || !isRecord(match)) {
+        throw new Error(
+          workflowName
+            ? `No failing workflow run found matching workflowName=${workflowName}.`
+            : 'No failing workflow run found.',
+        )
+      }
+
+      const sha = String((match as Record<string, unknown>).head_sha ?? '').trim()
+      const run = toPositiveInteger((match as Record<string, unknown>).run_number)
+      if (!sha || !run) {
+        throw new Error('Matched run entry is missing head_sha or run_number.')
+      }
+
+      const jobIdCandidate =
+        (match as Record<string, unknown>).job_id ??
+        (match as Record<string, unknown>).jobId ??
+        (match as Record<string, unknown>).task_id ??
+        (match as Record<string, unknown>).taskId ??
+        (match as Record<string, unknown>).id
+
+      const jobIdText = toTrimmedString(jobIdCandidate)
+      if (!jobIdText) {
+        throw new Error('Matched run entry does not expose an id usable as job_id.')
+      }
+
+      const logs = await requestGitea(
+        ctx,
+        ['actions', 'jobs', 'logs'],
+        owner,
+        repo,
+        'GET',
+        ['jobs', jobIdText, 'logs'],
+        scope.options,
+      )
+
+      const asText = typeof logs.body === 'string' ? logs.body : JSON.stringify(logs.body, null, 2)
+      const tailed = tailText(asText, {
+        contains,
+        maxLines,
+        ...(maxBytes ? { maxBytes } : {}),
+      })
+
+      return {
+        ...logs,
+        body: {
+          run: match,
+          logsTail: tailed,
+          owner,
+          repo,
+          headSha: sha,
+          runNumber: run,
+          jobId: jobIdText,
+        },
+      }
+    },
+
     artifacts: async (ownerOrOptions?: unknown, repoOrOptions?: unknown, maybeOptions?: unknown) => {
       const parsed = normalizeScopeArgs(ownerOrOptions, repoOrOptions, maybeOptions)
       const { owner, repo } = resolveOwnerRepo(parsed, defaults)
@@ -599,6 +745,7 @@ export const attachGitActionsApi = (api: GitServiceApi, ctx: GitActionsApiContex
     jobsLogs: { to: 'jobs.logs', description: 'Download job logs for a workflow run job_id' },
     jobsLogsTail: { to: 'jobs.logsTail', description: 'Download and tail job logs (bounded for LLM)' },
     jobsLogsForRunTail: { to: 'jobs.logsForRunTail', description: 'Resolve run by sha+run_number and tail logs' },
+    diagnoseLatestFailure: { to: 'diagnoseLatestFailure', description: 'Find latest failing run and return log tail' },
     artifacts: { to: 'artifacts.list', description: 'List repository artifacts' },
     artifactsByRun: { to: 'runs.artifacts', description: 'List artifacts for a run' },
     artifactZipUrl: { to: 'artifacts.downloadZipUrl', description: 'Return redirect URL for artifact zip download' },
@@ -613,4 +760,3 @@ export const attachGitActionsApi = (api: GitServiceApi, ctx: GitActionsApiContex
     }
   }
 }
-