@remogram/provider-gitea-api 0.1.0-beta.4 → 0.1.0-beta.6

package/index.js

@@ -10,8 +10,21 @@ import {
   gitAheadBehind,
   refsInventory,
   crInventory,
-  buildMergePlanBodyFromFacts,
+  buildMergePlanFromProviderFacts,
   buildChangeRequestOpenedBody,
+  buildCommitStatusSetBody,
+  parseStatusSetArgs,
+  normalizeStatusSetState,
+  buildProviderIdentityFromGiteaUser,
+  buildBranchProtectionFromGiteaProtection,
+  buildCrFilesBody,
+  buildCrFilesFromGiteaFiles,
+  buildCrCommentsBody,
+  buildCrCommentsFromGiteaComments,
+  buildForgeChangesFromGiteaPulls,
+  buildChecksConclusionObservedEvent,
+  appendForgeChangeEvents,
+  parseSinceObservedAt,
   ERROR_CODES,
   forgeError,
   forgeIngestCapabilityFacts,
@@ -43,6 +56,7 @@ import {
   buildOpenPullListMeta,
   giteaOpenPullSortQuery,
   appendSortQuery,
+  assertWriteCommandConfigured,
 } from '@remogram/core';
 const PUBLIC_GITEA_HOST = 'gitea.com';
 const PUBLIC_GITEA_API = 'https://gitea.com/api/v1';
@@ -56,9 +70,22 @@ const AUTH_CAPABILITIES = [
   'merge_plan',
   'sync_plan',
   'cr_open',
+  'status_set',
+  'whoami',
+  'branch_protection',
+  'cr_files',
+  'cr_comments',
+  'forge_changes',
 ];
 
-const STRUCTURED_COMMANDS = apiProviderCommands({ writeCommandsImplemented: true });
+const STRUCTURED_COMMANDS = apiProviderCommands({
+  writeCommandsImplemented: true,
+  statusSetImplemented: true,
+  branchProtectionImplemented: true,
+  crFilesImplemented: true,
+  crCommentsImplemented: true,
+  forgeChangesImplemented: true,
+});
 
 export function giteaToken() {
   return process.env.GITEA_TOKEN || null;
@@ -259,6 +286,195 @@ export async function repoStatus(ctx) {
   };
 }
 
+export async function whoami(ctx) {
+  requireToken();
+  const user = await giteaFetch(ctx.config, ctx.parsed, '/user');
+  return buildProviderIdentityFromGiteaUser(user);
+}
+
+export async function branchProtection(ctx, { branchRef }) {
+  requireToken();
+  const protection = await giteaFetch(
+    ctx.config,
+    ctx.parsed,
+    repoApiPath(ctx.config, 'branch_protections', branchRef),
+  );
+  return buildBranchProtectionFromGiteaProtection(branchRef, protection);
+}
+
+export async function crFiles(ctx, { number }) {
+  requireToken();
+  if (number == null) {
+    throw Object.assign(new Error('--number required'), {
+      forgeError: forgeError(ERROR_CODES.INVALID_ARGS, 'Provide --number for PR changed paths'),
+    });
+  }
+  const path = repoApiPath(ctx.config, 'pulls', number, 'files');
+  const pageSep = path.includes('?') ? '&' : '?';
+  let activeLimit = DEFAULT_CHECK_STATUS_PAGE_SIZE;
+  const allFiles = [];
+  let listTruncated = false;
+  let entryCount = 0;
+
+  for (let page = 1; page <= MAX_CHECK_PAGES; page += 1) {
+    const { items, usedLimit } = await fetchPageWithIngestBackoff(
+      async ({ page: pageNum, limit }) => {
+        const body = await giteaFetch(
+          ctx.config,
+          ctx.parsed,
+          `${path}${pageSep}limit=${limit}&page=${pageNum}`,
+        );
+        if (!Array.isArray(body)) {
+          throw Object.assign(new Error('Provider returned non-array pull files list'), {
+            forgeError: forgeError(
+              ERROR_CODES.UNPARSEABLE_PROVIDER_OUTPUT,
+              'Provider returned non-array pull files list',
+            ),
+          });
+        }
+        return body;
+      },
+      page,
+      activeLimit,
+    );
+    activeLimit = usedLimit;
+    entryCount += items.length;
+    allFiles.push(...items);
+    if (items.length < usedLimit) break;
+    if (page === MAX_CHECK_PAGES) {
+      listTruncated = true;
+    }
+  }
+
+  const body = buildCrFilesFromGiteaFiles(number, allFiles);
+  if (listTruncated) {
+    return buildCrFilesBody({
+      pr_number: body.pr_number,
+      changed_paths: body.changed_paths,
+      paths_truncated: true,
+      path_count: entryCount,
+    });
+  }
+  return body;
+}
+
+export async function crComments(ctx, { number }) {
+  requireToken();
+  if (number == null) {
+    throw Object.assign(new Error('--number required'), {
+      forgeError: forgeError(ERROR_CODES.INVALID_ARGS, 'Provide --number for PR review comments'),
+    });
+  }
+  const path = repoApiPath(ctx.config, 'pulls', number, 'comments');
+  const pageSep = path.includes('?') ? '&' : '?';
+  let activeLimit = DEFAULT_CHECK_STATUS_PAGE_SIZE;
+  const allComments = [];
+  let listTruncated = false;
+  let entryCount = 0;
+
+  for (let page = 1; page <= MAX_CHECK_PAGES; page += 1) {
+    const { items, usedLimit } = await fetchPageWithIngestBackoff(
+      async ({ page: pageNum, limit }) => {
+        const body = await giteaFetch(
+          ctx.config,
+          ctx.parsed,
+          `${path}${pageSep}limit=${limit}&page=${pageNum}`,
+        );
+        if (!Array.isArray(body)) {
+          throw Object.assign(new Error('Provider returned non-array pull comments list'), {
+            forgeError: forgeError(
+              ERROR_CODES.UNPARSEABLE_PROVIDER_OUTPUT,
+              'Provider returned non-array pull comments list',
+            ),
+          });
+        }
+        return body;
+      },
+      page,
+      activeLimit,
+    );
+    activeLimit = usedLimit;
+    entryCount += items.length;
+    allComments.push(...items);
+    if (items.length < usedLimit) break;
+    if (page === MAX_CHECK_PAGES) {
+      listTruncated = true;
+    }
+  }
+
+  const body = buildCrCommentsFromGiteaComments(number, allComments);
+  if (listTruncated) {
+    return buildCrCommentsBody({
+      pr_number: body.pr_number,
+      comments: body.comments,
+      comments_truncated: true,
+      comment_count: entryCount,
+    });
+  }
+  return body;
+}
+
+export async function forgeChanges(ctx, { since }) {
+  requireToken();
+  const sinceIso = parseSinceObservedAt(since);
+  const path = `${repoApiPath(ctx.config, 'pulls')}?state=all&sort=recentupdate`;
+  const pageSep = '&';
+  let activeLimit = GITEA_PAGE_SIZE;
+  const allPulls = [];
+  let listTruncated = false;
+  let entryCount = 0;
+
+  for (let page = 1; page <= MAX_CHECK_PAGES; page += 1) {
+    const { items, usedLimit } = await fetchPageWithIngestBackoff(
+      async ({ page: pageNum, limit }) => {
+        const body = await giteaFetch(
+          ctx.config,
+          ctx.parsed,
+          `${path}${pageSep}limit=${limit}&page=${pageNum}`,
+        );
+        if (!Array.isArray(body)) {
+          throw Object.assign(new Error('Provider returned non-array pull list'), {
+            forgeError: forgeError(
+              ERROR_CODES.UNPARSEABLE_PROVIDER_OUTPUT,
+              'Provider returned non-array pull list',
+            ),
+          });
+        }
+        return body;
+      },
+      page,
+      activeLimit,
+    );
+    activeLimit = usedLimit;
+    entryCount += items.length;
+    allPulls.push(...items);
+    if (items.length < usedLimit) break;
+    if (page === MAX_CHECK_PAGES) {
+      listTruncated = true;
+    }
+  }
+
+  let body = buildForgeChangesFromGiteaPulls(sinceIso, allPulls, { listTruncated });
+  const checkNumbers = new Set();
+  for (const event of body.events) {
+    if (event.kind === 'pr_opened' || event.kind === 'head_sha_moved') {
+      checkNumbers.add(event.pr_number);
+    }
+  }
+
+  const checkEvents = [];
+  for (const number of checkNumbers) {
+    const checks = await prChecks(ctx, { number });
+    checkEvents.push(buildChecksConclusionObservedEvent(number, checks));
+  }
+
+  if (checkEvents.length > 0) {
+    body = appendForgeChangeEvents(body, checkEvents, { listTruncated });
+  }
+
+  return body;
+}
+
 export function providerCapabilities() {
   const check_sources = ['commit_statuses'];
   return {
@@ -269,7 +485,7 @@ export function providerCapabilities() {
     host_binding: 'verified_remote_host',
     pagination: 'supported',
     write_support: true,
-    write_commands: ['cr_open'],
+    write_commands: ['cr_open', 'status_set'],
     ...forgeIngestCapabilityFacts(),
     ...checkPaginationCapabilityFacts({
       strategy: 'offset_limit',
@@ -369,7 +585,100 @@ export async function findOpenPullByHeadBase(ctx, head, base) {
   return null;
 }
 
+function statusSetIdempotencyScanIncompleteError(pagesScanned, pageSizeUsed) {
+  return forgeError(
+    ERROR_CODES.IDEMPOTENCY_SCAN_INCOMPLETE,
+    'Cannot prove no commit status exists for sha+context within scan limit; retry or set manually',
+    null,
+    {
+      idempotency_scan: {
+        pages: pagesScanned,
+        max_pages: MAX_OPEN_PULL_IDEMPOTENCY_PAGES,
+        page_size: pageSizeUsed,
+      },
+    },
+  );
+}
+
+/** Paginated commit-status scan for idempotent status set; fail-closed when scan cap prevents proof of absence. */
+export async function findCommitStatusByContext(ctx, sha, context) {
+  requireToken();
+  const path = repoApiPath(ctx.config, 'commits', sha, 'statuses');
+  const pageSep = path.includes('?') ? '&' : '?';
+  let activeLimit = GITEA_PAGE_SIZE;
+  let bestMatch = null;
+
+  for (let page = 1; page <= MAX_OPEN_PULL_IDEMPOTENCY_PAGES; page += 1) {
+    const { items, usedLimit } = await fetchPageWithIngestBackoff(
+      async ({ page: pageNum, limit }) => {
+        const body = await giteaFetch(
+          ctx.config,
+          ctx.parsed,
+          `${path}${pageSep}limit=${limit}&page=${pageNum}`,
+        );
+        if (!Array.isArray(body)) {
+          throw Object.assign(new Error('Provider returned non-array commit status list'), {
+            forgeError: forgeError(
+              ERROR_CODES.UNPARSEABLE_PROVIDER_OUTPUT,
+              'Provider returned non-array commit status list',
+            ),
+          });
+        }
+        return body;
+      },
+      page,
+      activeLimit,
+    );
+    activeLimit = usedLimit;
+
+    for (const record of items) {
+      if (record?.context !== context) continue;
+      if (!bestMatch || giteaStatusRecordOrder(record, bestMatch) > 0) {
+        bestMatch = record;
+      }
+    }
+
+    if (items.length < usedLimit) return bestMatch;
+    if (page === MAX_OPEN_PULL_IDEMPOTENCY_PAGES) {
+      throw Object.assign(new Error('Commit status idempotency scan incomplete'), {
+        forgeError: statusSetIdempotencyScanIncompleteError(page, usedLimit),
+      });
+    }
+  }
+  return bestMatch;
+}
+
+export async function statusSet(ctx, args) {
+  assertWriteCommandConfigured(ctx.config, 'status_set');
+  const parsed = parseStatusSetArgs(args);
+  const existing = await findCommitStatusByContext(ctx, parsed.sha, parsed.context);
+  if (existing) {
+    const existingState = normalizeStatusSetState(existing.status ?? existing.state);
+    if (existingState === parsed.state) {
+      return buildCommitStatusSetBody(existing, parsed, { reusedExisting: true });
+    }
+  }
+  const payload = {
+    state: parsed.state,
+    context: parsed.context,
+  };
+  if (parsed.description != null) payload.description = parsed.description;
+  if (parsed.target_url != null) payload.target_url = parsed.target_url;
+  const response = await giteaFetch(
+    ctx.config,
+    ctx.parsed,
+    repoApiPath(ctx.config, 'statuses', parsed.sha),
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(payload),
+    },
+  );
+  return buildCommitStatusSetBody(response, parsed);
+}
+
 export async function crOpen(ctx, { head, base, title, body: prBody }) {
+  assertWriteCommandConfigured(ctx.config, 'cr_open');
   assertGitRef(head, 'head');
   assertGitRef(base, 'base');
   if (!title || typeof title !== 'string' || !title.trim()) {
@@ -664,9 +973,7 @@ export function summarizeChecks(statuses) {
 }
 
 export async function mergePlan(ctx, opts) {
-  const view = await prView(ctx, opts);
-  const checks = await prChecks(ctx, { number: view.pr_number });
-  return buildMergePlanBodyFromFacts(ctx, view, checks, opts);
+  return buildMergePlanFromProviderFacts(ctx, opts, { prView, prChecks, crFiles });
 }
 
 export async function syncPlan(ctx, remoteName = 'origin') {
@@ -709,4 +1016,10 @@ export const provider = {
   mergePlan,
   syncPlan,
   crOpen,
+  statusSet,
+  whoami,
+  branchProtection,
+  crFiles,
+  crComments,
+  forgeChanges,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remogram/provider-gitea-api",
-  "version": "0.1.0-beta.4",
+  "version": "0.1.0-beta.6",
   "description": "Gitea REST API forge provider for remogram",
   "type": "module",
   "license": "MIT",
@@ -22,6 +22,6 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@remogram/core": "0.1.0-beta.4"
+    "@remogram/core": "0.1.0-beta.6"
   }
 }