ghagga-forge 3.1.0

package/dist/types.d.ts

@@ -0,0 +1,310 @@
+/**
+ * Canonical forge-agnostic domain types.
+ *
+ * These types are the lingua franca between GHAGGA's core review engine and any
+ * concrete forge adapter (GitHub / GitLab / Gitea). They are deliberately
+ * provider-neutral: nothing here leaks a GitHub PR number, a GitLab IID, or a
+ * Gitea path as a bare primitive that could be mis-assigned across forges.
+ *
+ * Invariants enforced by these shapes:
+ * - R-COMMENTID: comment identifiers are BOXED ({@link CommentId}), never a bare
+ *   number — a GitHub comment id and a GitLab note id must never be cross-assigned.
+ * - RepoRef identity keys on {@link RepoRef.nativeId} — `path` is mutable (repos
+ *   get renamed/moved) and MUST NOT participate in identity.
+ * - ChangeRequestRef uses {@link ChangeRequestRef.iid} (project-scoped) with an
+ *   optional {@link ChangeRequestRef.globalId} for forges that expose one.
+ */
+/** The forge providers GHAGGA can target. */
+export declare const FORGE_KIND: {
+    readonly GITHUB: "github";
+    readonly GITLAB: "gitlab";
+    readonly GITEA: "gitea";
+};
+export type ForgeKind = (typeof FORGE_KIND)[keyof typeof FORGE_KIND];
+/** How a single file changed within a change request. */
+export declare const CHANGE_KIND: {
+    readonly ADDED: "added";
+    readonly MODIFIED: "modified";
+    readonly REMOVED: "removed";
+    readonly RENAMED: "renamed";
+};
+export type ChangeKind = (typeof CHANGE_KIND)[keyof typeof CHANGE_KIND];
+/** Whether an {@link Actor} is a human or an automated account. */
+export declare const ACTOR_KIND: {
+    readonly USER: "user";
+    readonly BOT: "bot";
+};
+export type ActorKind = (typeof ACTOR_KIND)[keyof typeof ACTOR_KIND];
+/**
+ * Relationship between a comment author and the repository.
+ *
+ * Mirrors GitHub's `author_association`; other forges map their nearest
+ * equivalent. Used for trust/permission gating (e.g. only act on commands from
+ * owners/members/collaborators).
+ */
+export declare const AUTHOR_ASSOCIATION: {
+    readonly OWNER: "owner";
+    readonly MEMBER: "member";
+    readonly COLLABORATOR: "collaborator";
+    readonly CONTRIBUTOR: "contributor";
+    readonly NONE: "none";
+};
+export type AuthorAssociation = (typeof AUTHOR_ASSOCIATION)[keyof typeof AUTHOR_ASSOCIATION];
+/**
+ * Stable identity of a repository on a given forge.
+ *
+ * IDENTITY RULE (R-COMMENTID family): two RepoRefs are the same repository iff
+ * their `kind` AND `nativeId` match. `path` is a human-friendly *label* that can
+ * change when a repo is renamed/transferred — it MUST NOT be used for identity
+ * comparison or as a lookup key.
+ */
+export interface RepoRef {
+    /** Which forge this repo lives on. */
+    kind: ForgeKind;
+    /**
+     * OPAQUE forge-native identity string. It is the numeric repo/project id WHEN
+     * resolvable (GitHub repo id, GitLab project id) — immutable across
+     * rename/transfer — but it MAY be a path-shaped legacy/fallback value
+     * (e.g. `owner/repo`) when the numeric id could not be resolved (an old
+     * in-flight job, or a network/404 failure during CLI resolution; both are
+     * intentional safe degradations, not bugs).
+     *
+     * Consumers MUST treat this as an opaque identity token: compare it for
+     * equality, key on it, persist it — but MUST NOT assume it parses as a number.
+     * `Number(ref.nativeId)` is NOT safe (a path-shaped fallback yields NaN).
+     */
+    nativeId: string;
+    /** Human-friendly "owner/name" path. Mutable — NOT part of identity. */
+    path?: string;
+}
+/**
+ * Reference to a single change request (PR / MR).
+ *
+ * `iid` is the project-scoped number a human sees (GitHub PR number, GitLab MR
+ * IID). `globalId` is the forge-global identifier when one exists (GitLab MRs
+ * have both; GitHub does not expose a separate global PR number).
+ */
+export interface ChangeRequestRef {
+    /** The repository this change request belongs to. */
+    repo: RepoRef;
+    /** Project-scoped identifier (PR number / MR IID). */
+    iid: number;
+    /** Forge-global identifier, when the forge exposes one. */
+    globalId?: string;
+}
+/** A human or bot account on a forge. */
+export interface Actor {
+    /** Login / username. */
+    login: string;
+    /** Whether this account is a human or an automated bot. */
+    kind: ActorKind;
+}
+/** One file changed within a change request. */
+export interface ChangedFile {
+    /** Current path of the file. Always available. */
+    path: string;
+    /**
+     * How the file changed. Optional because the GitHub PR file-list endpoint
+     * wrapper does not expose it; populated only when a richer source is available.
+     */
+    changeKind?: ChangeKind;
+    /**
+     * Lines added. Optional because the GitHub PR file-list endpoint wrapper does
+     * not expose it; populated only when a richer source is available.
+     */
+    additions?: number;
+    /**
+     * Lines removed. Optional because the GitHub PR file-list endpoint wrapper
+     * does not expose it; populated only when a richer source is available.
+     */
+    deletions?: number;
+}
+/** A single commit in a change request. */
+export interface Commit {
+    /**
+     * Commit SHA. Optional because the GitHub PR commit-list endpoint wrapper only
+     * returns messages; populated only when a richer source is available.
+     */
+    sha?: string;
+    /** Full commit message. Always available. */
+    message: string;
+    /**
+     * Commit author. Optional because the GitHub PR commit-list endpoint wrapper
+     * does not expose author identity; populated only when a richer source is
+     * available.
+     */
+    author?: Actor;
+}
+/**
+ * Optional diff anchoring SHAs.
+ *
+ * When present, ALL THREE are required (the three-dot base, the head, and the
+ * GitLab-style start SHA). The whole block is optional; partial diffRefs are not
+ * representable by design.
+ */
+export interface DiffRefs {
+    /** Merge-base / comparison base SHA. */
+    baseSha: string;
+    /** Head SHA of the change request. */
+    headSha: string;
+    /** Start SHA (GitLab diff_refs.start_sha analogue). */
+    startSha: string;
+}
+/** A unified diff plus optional anchoring SHAs. */
+export interface UnifiedDiff {
+    /** The raw unified-diff text. */
+    text: string;
+    /** Anchoring SHAs; all-or-nothing (see {@link DiffRefs}). */
+    diffRefs?: DiffRefs;
+}
+/**
+ * A full change request projection (after fetch).
+ *
+ * Carries the fields the review engine needs to anchor a review: head SHA, the
+ * base branch it targets, and the author.
+ */
+export interface ChangeRequest {
+    /** Reference identifying this change request. */
+    ref: ChangeRequestRef;
+    /** Head commit SHA. */
+    headSha: string;
+    /** Branch this change request targets. */
+    baseBranch: string;
+    /** Author of the change request. */
+    author: Actor;
+}
+/**
+ * BOXED comment identifier (R-COMMENTID).
+ *
+ * Never pass a bare number where a comment id is expected. The `kind` tag plus
+ * the opaque `raw` value prevents a GitHub comment id from being silently used
+ * as a GitLab note id (and vice-versa). `raw` is intentionally `string | number`
+ * because forges differ (GitHub: number, GitLab note id: number, but some
+ * resources are string-keyed) — consumers MUST treat it as opaque.
+ */
+export interface CommentId {
+    /** Discriminator naming the resource/forge the id belongs to. */
+    kind: string;
+    /** Opaque forge-native identifier. Treat as opaque — do not parse. */
+    raw: string | number;
+}
+/**
+ * Result of upserting the single summary comment.
+ *
+ * `created` is the surviving summary comment id; `deleted` lists any stale prior
+ * summary comment ids that were removed during the upsert (idempotency cleanup).
+ *
+ * BOUNDARY DECISION (forge-agnostic P1): ids here are PLAIN FORGE-NATIVE
+ * primitives (e.g. GitHub numeric comment ids), NOT boxed {@link CommentId}.
+ * The {@link CommentId} boxing ({kind, raw}) happens caller-LOCAL (review.ts)
+ * after the adapter returns — it is NOT part of the adapter↔caller wire shape.
+ * `CommentId` remains the canonical boxed type for cross-forge comment
+ * identity elsewhere; only THIS result intentionally stays native.
+ */
+export interface UpsertSummaryResult {
+    /** The forge-native id of the summary comment that now exists. */
+    created: number;
+    /** Forge-native ids of stale summary comments removed during upsert. */
+    deleted: number[];
+}
+/**
+ * Outcome of publishing a batch of inline comments.
+ *
+ * Partial success is representable: `posted` holds the ids that succeeded,
+ * `failed` records the index (into the input array) and error for each failure.
+ */
+export interface PublishReport {
+    /** Comment ids that were successfully posted. */
+    posted: CommentId[];
+    /** Per-item failures, keyed by input index. */
+    failed: PublishFailure[];
+}
+/** A single inline-publish failure. */
+export interface PublishFailure {
+    /** Index into the input {@link InlineComment} array. */
+    index: number;
+    /** Human-readable error. */
+    error: string;
+    /**
+     * The HTTP status of the underlying forge failure, when one was carried on the
+     * thrown error (e.g. `401`, `403`, `422`, `500`). Absent when the failure had
+     * no usable numeric status (e.g. a network error or a non-HTTP throw). Lets a
+     * caller distinguish an auth failure from a transient/server one WITHOUT
+     * string-parsing {@link PublishFailure.error}. Additive + optional, so older
+     * consumers are unaffected.
+     */
+    status?: number;
+    /**
+     * `true` when the failure was an AUTHENTICATION/authorization failure (HTTP
+     * 401/403). A static-token forge cannot recover from this (nothing to re-mint),
+     * so a caller can surface "fix your token" guidance instead of treating it as a
+     * retry-able transient. Absent/`false` for non-auth failures. Additive +
+     * optional.
+     */
+    authFailure?: boolean;
+}
+/**
+ * Declarative capability HINTS for an adapter.
+ *
+ * R-CAPABILITY: these flags are HINTS ONLY (e.g. for UI / planning). They MUST
+ * NOT be used as the runtime guard for calling an optional method. The runtime
+ * guard is ALWAYS method-presence (`'methodName' in adapter`). See
+ * `ports/forge-adapter.ts`.
+ */
+export interface ForgeCapabilities {
+    /** Adapter can add reactions to comments. */
+    readonly reactions: boolean;
+    /** Adapter can publish inline (line-anchored) comments. */
+    readonly inlineComments: boolean;
+    /** Adapter can read a dependency graph for the repo. */
+    readonly graphRead: boolean;
+}
+/**
+ * An HTML marker embedded in a comment body to identify GHAGGA-owned comments.
+ *
+ * Typically an HTML comment like `<!-- ghagga:summary -->` so it renders
+ * invisibly but is machine-extractable for idempotent upserts.
+ */
+export interface CommentMarker {
+    /** The literal HTML marker string. */
+    html: string;
+}
+/**
+ * A comment normalized into forge-agnostic shape.
+ *
+ * Produced by the webhook codec when parsing an incoming comment event so the
+ * core engine never touches forge-specific payload shapes.
+ */
+export interface NormalizedComment {
+    /** Change request the comment belongs to. */
+    ref: ChangeRequestRef;
+    /** Boxed id of the comment itself. */
+    commentId: CommentId;
+    /** Comment body (markdown). */
+    body: string;
+    /** Who wrote the comment. */
+    author: Actor;
+    /** Author's relationship to the repo (trust gating). */
+    association: AuthorAssociation;
+}
+/** A parsed, forge-agnostic webhook event. */
+export type ForgeEvent = {
+    type: 'comment';
+    comment: NormalizedComment;
+} | {
+    type: 'unsupported';
+    raw: unknown;
+};
+/**
+ * Minimal tenant-routing hint extracted from a webhook BEFORE verification.
+ *
+ * Used in the two-phase webhook flow to pick the right secret/credentials for
+ * the verify step. Contains no trusted data — only enough to route.
+ */
+export interface TenantHint {
+    /** Which forge the webhook came from. */
+    forge: ForgeKind;
+    /** Opaque tenant routing key (installation id, project namespace, …). */
+    tenantKey: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,50 @@
+/**
+ * Canonical forge-agnostic domain types.
+ *
+ * These types are the lingua franca between GHAGGA's core review engine and any
+ * concrete forge adapter (GitHub / GitLab / Gitea). They are deliberately
+ * provider-neutral: nothing here leaks a GitHub PR number, a GitLab IID, or a
+ * Gitea path as a bare primitive that could be mis-assigned across forges.
+ *
+ * Invariants enforced by these shapes:
+ * - R-COMMENTID: comment identifiers are BOXED ({@link CommentId}), never a bare
+ *   number — a GitHub comment id and a GitLab note id must never be cross-assigned.
+ * - RepoRef identity keys on {@link RepoRef.nativeId} — `path` is mutable (repos
+ *   get renamed/moved) and MUST NOT participate in identity.
+ * - ChangeRequestRef uses {@link ChangeRequestRef.iid} (project-scoped) with an
+ *   optional {@link ChangeRequestRef.globalId} for forges that expose one.
+ */
+// ─── Kind enums (const-object pattern → single source of truth) ──
+/** The forge providers GHAGGA can target. */
+export const FORGE_KIND = {
+    GITHUB: 'github',
+    GITLAB: 'gitlab',
+    GITEA: 'gitea',
+};
+/** How a single file changed within a change request. */
+export const CHANGE_KIND = {
+    ADDED: 'added',
+    MODIFIED: 'modified',
+    REMOVED: 'removed',
+    RENAMED: 'renamed',
+};
+/** Whether an {@link Actor} is a human or an automated account. */
+export const ACTOR_KIND = {
+    USER: 'user',
+    BOT: 'bot',
+};
+/**
+ * Relationship between a comment author and the repository.
+ *
+ * Mirrors GitHub's `author_association`; other forges map their nearest
+ * equivalent. Used for trust/permission gating (e.g. only act on commands from
+ * owners/members/collaborators).
+ */
+export const AUTHOR_ASSOCIATION = {
+    OWNER: 'owner',
+    MEMBER: 'member',
+    COLLABORATOR: 'collaborator',
+    CONTRIBUTOR: 'contributor',
+    NONE: 'none',
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,oEAAoE;AAEpE,6CAA6C;AAC7C,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;CACN,CAAC;AAIX,yDAAyD;AACzD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACV,CAAC;AAIX,mEAAmE;AACnE,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;CACF,CAAC;AAIX;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,IAAI,EAAE,MAAM;CACJ,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "ghagga-forge",
+  "version": "3.1.0",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "description": "Forge-agnostic ports and domain types for GHAGGA (GitHub / GitLab / Gitea)",
+  "author": "JNZader",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JNZader/ghagga.git",
+    "directory": "packages/forge"
+  },
+  "homepage": "https://github.com/JNZader/ghagga#readme",
+  "bugs": {
+    "url": "https://github.com/JNZader/ghagga/issues"
+  },
+  "keywords": [
+    "ghagga",
+    "forge",
+    "github",
+    "gitlab",
+    "gitea",
+    "code-review"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "ghagga-core": "3.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9"
+  },
+  "scripts": {
+    "build": "tsc && node scripts/copy-impl-assets.mjs",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "node scripts/lint-boundary.mjs && node scripts/lint-server-forge-boundary.mjs",
+    "lint:boundary": "node scripts/lint-boundary.mjs",
+    "lint:server-forge-boundary": "node scripts/lint-server-forge-boundary.mjs",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}