@contentrain/mcp 1.2.1 → 1.3.0

package/dist/providers/github/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["listBranchesOp","createBranchOp","deleteBranchOp","getBranchDiffOp","mergeBranchOp","isMergedOp","getDefaultBranchOp"],"sources":["../../../src/providers/github/capabilities.ts","../../../src/providers/github/apply-plan.ts","../../../src/providers/github/branch-ops.ts","../../../src/providers/github/reader.ts","../../../src/providers/github/provider.ts","../../../src/providers/github/factory.ts","../../../src/providers/github/types.ts"],"sourcesContent":["import type { ProviderCapabilities } from '../../core/contracts/index.js'\n\n/**\n * Capability set for GitHubProvider.\n *\n * GitHub over the Git Data API has no working tree, so local worktree\n * features, source-file access and AST scans are unavailable. Push /\n * PR operations are free because every commit goes straight to the\n * remote. Branch protection detection uses the Repos API.\n *\n * Tools that require `astScan`, `sourceRead` or `sourceWrite` must\n * gracefully reject (with `capability_required`) when running against\n * a GitHubProvider — this is the mechanism behind phase 6's normalize\n * capability-gate.\n */\nexport const GITHUB_CAPABILITIES: ProviderCapabilities = {\n  localWorktree: false,\n  sourceRead: false,\n  sourceWrite: false,\n  pushRemote: true,\n  branchProtection: true,\n  pullRequestFallback: true,\n  astScan: false,\n}\n","import { CONTENTRAIN_BRANCH } from '@contentrain/types'\nimport type { ApplyPlanInput, Commit, FileChange } from '../../core/contracts/index.js'\nimport { isNotFoundError, resolveRepoPath } from '../shared/index.js'\nimport type { GitHubClient } from './client.js'\nimport type { RepoRef } from './types.js'\n\ninterface TreeEntry {\n  path: string\n  mode: '100644' | '100755' | '040000' | '160000' | '120000'\n  type: 'blob' | 'tree' | 'commit'\n  sha: string | null\n}\n\n/**\n * Apply a plan to a GitHub repository as a single atomic commit via the\n * Git Data API. High-level flow:\n *\n * 1. Resolve the base commit SHA — either the current HEAD of the target\n *    branch, or the HEAD of `input.base` (or the repo's default branch)\n *    when the target branch does not yet exist.\n * 2. Read the base tree SHA from that commit.\n * 3. Walk `input.changes` in parallel — create a blob per non-null\n *    content, emit a tree entry with `sha: null` for each deletion.\n * 4. Create a new tree layered on top of the base tree with the collected\n *    entries.\n * 5. Create the commit (tree, parents, author).\n * 6. Update an existing branch ref or create a new one pointing at the\n *    commit.\n *\n * No working tree, no transaction — the commit is durable as soon as the\n * final ref update returns.\n */\nexport async function applyPlanToGitHub(\n  client: GitHubClient,\n  repo: RepoRef,\n  input: ApplyPlanInput,\n): Promise<Commit> {\n  const { baseSha, branchExists } = await resolveBaseSha(client, repo, input.branch, input.base)\n\n  const baseCommit = await client.rest.git.getCommit({\n    owner: repo.owner,\n    repo: repo.name,\n    commit_sha: baseSha,\n  })\n  const baseTreeSha = baseCommit.data.tree.sha\n\n  const treeEntries = await Promise.all(\n    input.changes.map(change => buildTreeEntry(client, repo, change)),\n  )\n\n  const tree = await client.rest.git.createTree({\n    owner: repo.owner,\n    repo: repo.name,\n    base_tree: baseTreeSha,\n    tree: treeEntries,\n  })\n\n  const timestamp = new Date().toISOString()\n  const commit = await client.rest.git.createCommit({\n    owner: repo.owner,\n    repo: repo.name,\n    message: input.message,\n    tree: tree.data.sha,\n    parents: [baseSha],\n    author: {\n      name: input.author.name,\n      email: input.author.email,\n      date: timestamp,\n    },\n  })\n\n  if (branchExists) {\n    await client.rest.git.updateRef({\n      owner: repo.owner,\n      repo: repo.name,\n      ref: `heads/${input.branch}`,\n      sha: commit.data.sha,\n    })\n  } else {\n    await client.rest.git.createRef({\n      owner: repo.owner,\n      repo: repo.name,\n      ref: `refs/heads/${input.branch}`,\n      sha: commit.data.sha,\n    })\n  }\n\n  return {\n    sha: commit.data.sha,\n    message: commit.data.message,\n    author: {\n      name: commit.data.author?.name ?? input.author.name,\n      email: commit.data.author?.email ?? input.author.email,\n    },\n    timestamp: commit.data.author?.date ?? timestamp,\n  }\n}\n\nasync function buildTreeEntry(\n  client: GitHubClient,\n  repo: RepoRef,\n  change: FileChange,\n): Promise<TreeEntry> {\n  const path = resolveRepoPath(repo.contentRoot, change.path)\n  if (change.content === null) {\n    return { path, mode: '100644', type: 'blob', sha: null }\n  }\n  const blob = await client.rest.git.createBlob({\n    owner: repo.owner,\n    repo: repo.name,\n    content: change.content,\n    encoding: 'utf-8',\n  })\n  return { path, mode: '100644', type: 'blob', sha: blob.data.sha }\n}\n\nasync function resolveBaseSha(\n  client: GitHubClient,\n  repo: RepoRef,\n  branch: string,\n  base: string | undefined,\n): Promise<{ baseSha: string, branchExists: boolean }> {\n  try {\n    const ref = await client.rest.git.getRef({\n      owner: repo.owner,\n      repo: repo.name,\n      ref: `heads/${branch}`,\n    })\n    return { baseSha: ref.data.object.sha, branchExists: true }\n  } catch (error) {\n    if (!isNotFoundError(error)) throw error\n  }\n\n  // Invariant: feature branches always fork from the Contentrain\n  // content-tracking branch. Callers that genuinely want to bypass this\n  // must pass `base` explicitly. The repository's default branch\n  // (main / master / trunk) is NOT the fallback — that would create a\n  // split-brain where remote writes derive from a different ref than\n  // local writes, which the LocalProvider transaction path forbids.\n  const baseRefName = base ?? CONTENTRAIN_BRANCH\n\n  const baseRef = await client.rest.git.getRef({\n    owner: repo.owner,\n    repo: repo.name,\n    ref: `heads/${baseRefName}`,\n  })\n  return { baseSha: baseRef.data.object.sha, branchExists: false }\n}\n","import type { Branch, FileDiff, MergeResult } from '../../core/contracts/index.js'\nimport type { GitHubClient } from './client.js'\nimport type { RepoRef } from './types.js'\n\n/**\n * Branch/merge/diff helpers backed by the Repos and Git Data APIs.\n *\n * Pure functions so they can be composed into `GitHubProvider` or used\n * standalone. All throw on non-404 errors; 404s collapse to empty-ish\n * results where that matches the `RepoProvider` contract (e.g. a\n * missing branch prefix yields `[]` rather than raising).\n */\n\nexport async function getDefaultBranch(client: GitHubClient, repo: RepoRef): Promise<string> {\n  const response = await client.rest.repos.get({ owner: repo.owner, repo: repo.name })\n  return response.data.default_branch\n}\n\nexport async function listBranches(\n  client: GitHubClient,\n  repo: RepoRef,\n  prefix?: string,\n): Promise<Branch[]> {\n  const branches: Branch[] = []\n  const iterator = client.paginate.iterator(client.rest.repos.listBranches, {\n    owner: repo.owner,\n    repo: repo.name,\n    per_page: 100,\n  })\n  for await (const page of iterator) {\n    for (const b of page.data) {\n      if (prefix && !b.name.startsWith(prefix)) continue\n      branches.push({ name: b.name, sha: b.commit.sha, protected: b.protected })\n    }\n  }\n  return branches\n}\n\nexport async function createBranch(\n  client: GitHubClient,\n  repo: RepoRef,\n  name: string,\n  fromRef: string,\n): Promise<void> {\n  const base = await client.rest.git.getRef({\n    owner: repo.owner,\n    repo: repo.name,\n    ref: `heads/${fromRef}`,\n  })\n  await client.rest.git.createRef({\n    owner: repo.owner,\n    repo: repo.name,\n    ref: `refs/heads/${name}`,\n    sha: base.data.object.sha,\n  })\n}\n\nexport async function deleteBranch(\n  client: GitHubClient,\n  repo: RepoRef,\n  name: string,\n): Promise<void> {\n  await client.rest.git.deleteRef({\n    owner: repo.owner,\n    repo: repo.name,\n    ref: `heads/${name}`,\n  })\n}\n\nexport async function getBranchDiff(\n  client: GitHubClient,\n  repo: RepoRef,\n  branch: string,\n  base: string,\n): Promise<FileDiff[]> {\n  const response = await client.rest.repos.compareCommits({\n    owner: repo.owner,\n    repo: repo.name,\n    base,\n    head: branch,\n  })\n  const files = response.data.files ?? []\n  return files.map(f => ({\n    path: f.filename,\n    status: normaliseStatus(f.status),\n    before: null,\n    after: null,\n  }))\n}\n\nexport async function mergeBranch(\n  client: GitHubClient,\n  repo: RepoRef,\n  branch: string,\n  into: string,\n): Promise<MergeResult> {\n  try {\n    const response = await client.rest.repos.merge({\n      owner: repo.owner,\n      repo: repo.name,\n      base: into,\n      head: branch,\n    })\n    return { merged: true, sha: response.data.sha, pullRequestUrl: null }\n  } catch (error) {\n    if (isNotModified(error)) {\n      return { merged: true, sha: null, pullRequestUrl: null }\n    }\n    throw error\n  }\n}\n\nexport async function isMerged(\n  client: GitHubClient,\n  repo: RepoRef,\n  branch: string,\n  into: string,\n): Promise<boolean> {\n  const response = await client.rest.repos.compareCommits({\n    owner: repo.owner,\n    repo: repo.name,\n    base: into,\n    head: branch,\n  })\n  return response.data.ahead_by === 0\n}\n\nfunction normaliseStatus(status: string): FileDiff['status'] {\n  if (status === 'added') return 'added'\n  if (status === 'removed') return 'removed'\n  return 'modified'\n}\n\nfunction isNotModified(error: unknown): boolean {\n  return typeof error === 'object' && error !== null && (error as { status?: number }).status === 204\n}\n","import type { RepoReader } from '../../core/contracts/index.js'\nimport { isNotFoundError, resolveRepoPath } from '../shared/index.js'\nimport type { GitHubClient } from './client.js'\nimport type { RepoRef } from './types.js'\n\n/**\n * GitHubReader — `RepoReader` backed by the GitHub Repos + Git Data APIs.\n *\n * Reads pass through `repos.getContent`; directories return a list of\n * names, files return decoded UTF-8 text. Files larger than ~1 MB are\n * fetched by blob SHA through `git.getBlob` because `getContent` omits\n * the body in that case.\n *\n * `ref` is forwarded verbatim and may be a branch name, tag name or\n * commit SHA. When omitted, GitHub resolves to the repository's default\n * branch — which is usually wrong for Contentrain flows, so callers\n * should always pass the explicit `contentrain` tracking branch.\n */\nexport class GitHubReader implements RepoReader {\n  constructor(\n    private readonly client: GitHubClient,\n    private readonly repo: RepoRef,\n  ) {}\n\n  async readFile(path: string, ref?: string): Promise<string> {\n    const repoPath = resolveRepoPath(this.repo.contentRoot, path)\n    const response = await this.client.rest.repos.getContent({\n      owner: this.repo.owner,\n      repo: this.repo.name,\n      path: repoPath,\n      ref,\n    })\n    const data = response.data\n    if (Array.isArray(data)) {\n      throw new Error(`GitHubReader: path \"${path}\" is a directory, not a file`)\n    }\n    if (data.type !== 'file') {\n      throw new Error(`GitHubReader: path \"${path}\" is a ${data.type}, not a file`)\n    }\n\n    // GitHub omits content for files > 1 MB — fall back to blob fetch.\n    if (data.content === '' && data.size > 0) {\n      const blob = await this.client.rest.git.getBlob({\n        owner: this.repo.owner,\n        repo: this.repo.name,\n        file_sha: data.sha,\n      })\n      if (blob.data.encoding !== 'base64') {\n        throw new Error(`GitHubReader: unexpected blob encoding \"${blob.data.encoding}\" for ${path}`)\n      }\n      return Buffer.from(blob.data.content, 'base64').toString('utf-8')\n    }\n\n    if (data.encoding !== 'base64') {\n      throw new Error(`GitHubReader: unexpected encoding \"${data.encoding}\" for ${path}`)\n    }\n    return Buffer.from(data.content, 'base64').toString('utf-8')\n  }\n\n  async listDirectory(path: string, ref?: string): Promise<string[]> {\n    const repoPath = resolveRepoPath(this.repo.contentRoot, path)\n    try {\n      const response = await this.client.rest.repos.getContent({\n        owner: this.repo.owner,\n        repo: this.repo.name,\n        path: repoPath,\n        ref,\n      })\n      const data = response.data\n      if (!Array.isArray(data)) return []\n      return data.map(entry => entry.name)\n    } catch (error) {\n      if (isNotFoundError(error)) return []\n      throw error\n    }\n  }\n\n  async fileExists(path: string, ref?: string): Promise<boolean> {\n    const repoPath = resolveRepoPath(this.repo.contentRoot, path)\n    try {\n      await this.client.rest.repos.getContent({\n        owner: this.repo.owner,\n        repo: this.repo.name,\n        path: repoPath,\n        ref,\n      })\n      return true\n    } catch (error) {\n      if (isNotFoundError(error)) return false\n      throw error\n    }\n  }\n}\n","import type {\n  ApplyPlanInput,\n  Branch,\n  Commit,\n  FileDiff,\n  MergeResult,\n  ProviderCapabilities,\n  RepoProvider,\n} from '../../core/contracts/index.js'\nimport { applyPlanToGitHub } from './apply-plan.js'\nimport {\n  createBranch as createBranchOp,\n  deleteBranch as deleteBranchOp,\n  getBranchDiff as getBranchDiffOp,\n  getDefaultBranch as getDefaultBranchOp,\n  isMerged as isMergedOp,\n  listBranches as listBranchesOp,\n  mergeBranch as mergeBranchOp,\n} from './branch-ops.js'\nimport { GITHUB_CAPABILITIES } from './capabilities.js'\nimport type { GitHubClient } from './client.js'\nimport { GitHubReader } from './reader.js'\nimport type { RepoRef } from './types.js'\n\n/**\n * GitHubProvider — `RepoProvider` backed by the Octokit-driven GitHub\n * REST + Git Data APIs.\n *\n * The provider is transport-agnostic; it only talks to an `Octokit`\n * instance passed into the constructor. The `createGitHubProvider`\n * helper in `factory.ts` wraps the dynamic import so consumers never\n * have to touch Octokit directly.\n */\nexport class GitHubProvider implements RepoProvider {\n  readonly capabilities: ProviderCapabilities = GITHUB_CAPABILITIES\n  private readonly reader: GitHubReader\n\n  constructor(\n    private readonly client: GitHubClient,\n    public readonly repo: RepoRef,\n  ) {\n    this.reader = new GitHubReader(client, repo)\n  }\n\n  readFile(path: string, ref?: string): Promise<string> {\n    return this.reader.readFile(path, ref)\n  }\n  listDirectory(path: string, ref?: string): Promise<string[]> {\n    return this.reader.listDirectory(path, ref)\n  }\n  fileExists(path: string, ref?: string): Promise<boolean> {\n    return this.reader.fileExists(path, ref)\n  }\n\n  applyPlan(input: ApplyPlanInput): Promise<Commit> {\n    return applyPlanToGitHub(this.client, this.repo, input)\n  }\n\n  listBranches(prefix?: string): Promise<Branch[]> {\n    return listBranchesOp(this.client, this.repo, prefix)\n  }\n  createBranch(name: string, fromRef?: string): Promise<void> {\n    const resolved = fromRef ?? 'main'\n    return createBranchOp(this.client, this.repo, name, resolved)\n  }\n  deleteBranch(name: string): Promise<void> {\n    return deleteBranchOp(this.client, this.repo, name)\n  }\n  getBranchDiff(branch: string, base?: string): Promise<FileDiff[]> {\n    const resolved = base ?? 'main'\n    return getBranchDiffOp(this.client, this.repo, branch, resolved)\n  }\n  mergeBranch(branch: string, into: string): Promise<MergeResult> {\n    return mergeBranchOp(this.client, this.repo, branch, into)\n  }\n  isMerged(branch: string, into?: string): Promise<boolean> {\n    const resolved = into ?? 'main'\n    return isMergedOp(this.client, this.repo, branch, resolved)\n  }\n  getDefaultBranch(): Promise<string> {\n    return getDefaultBranchOp(this.client, this.repo)\n  }\n}\n","import type { GitHubClient } from './client.js'\nimport { GitHubProvider } from './provider.js'\nimport type { GitHubAuth, RepoRef } from './types.js'\n\n/**\n * Create an Octokit-backed `GitHubClient` from an auth configuration.\n *\n * The `@octokit/rest` module is imported dynamically so it stays a pure\n * optional peer dependency — self-hosted MCP on stdio can run without\n * it. If the module is not installed, the import throws with a helpful\n * hint pointing the operator at the peer dependency.\n *\n * Phase 5.1 ships with PAT auth only. App-based auth (JWT + installation\n * token) lands in phase 5.2 together with the HTTP transport.\n */\nexport async function createGitHubClient(auth: GitHubAuth): Promise<GitHubClient> {\n  if (auth.type !== 'pat') {\n    throw new Error(\n      `GitHub auth type \"${auth.type}\" is not yet supported. Phase 5.1 ships with \"pat\" only; `\n      + `\"app\" installation auth arrives in phase 5.2.`,\n    )\n  }\n\n  let OctokitCtor: typeof import('@octokit/rest').Octokit\n  try {\n    ({ Octokit: OctokitCtor } = await import('@octokit/rest'))\n  } catch (error) {\n    throw new Error(\n      '@octokit/rest is required for the GitHubProvider but could not be loaded. '\n      + 'Install it as a peer dependency: pnpm add @octokit/rest.',\n      { cause: error },\n    )\n  }\n\n  return new OctokitCtor({ auth: auth.token })\n}\n\n/**\n * Factory for the full provider — instantiates an Octokit client and\n * wraps it in a `GitHubProvider`. Consumers who already hold an Octokit\n * instance (HTTP server injecting shared clients, tests, etc.) should\n * instantiate `GitHubProvider` directly instead.\n */\nexport async function createGitHubProvider(opts: { auth: GitHubAuth, repo: RepoRef }): Promise<GitHubProvider> {\n  const client = await createGitHubClient(opts.auth)\n  return new GitHubProvider(client, opts.repo)\n}\n","import type { CommitAuthor } from '../../core/contracts/index.js'\n\n/**\n * A reference to a GitHub repository.\n *\n * `contentRoot` is the repo-relative directory prefix where Contentrain\n * content lives. For a flat content repo it stays `''`; for a monorepo\n * where Contentrain is embedded (e.g. `apps/web/.contentrain/`) it holds\n * that prefix. All reader/writer paths are joined against it.\n */\nexport interface RepoRef {\n  owner: string\n  name: string\n  contentRoot?: string\n}\n\n/**\n * Authentication options for the GitHub provider.\n *\n * - `pat` — a personal access token or fine-grained PAT. Simplest for\n *   self-hosted MCP or CI runners. Phase 5.1 ships with this mode only.\n * - `app` — GitHub App installation auth (JWT + installation token\n *   exchange). Planned for Phase 5.2; see `.internal/refactor/\n *   02-studio-handoff.md` S6 for how Studio's hosted MCP plugs in.\n */\nexport type GitHubAuth =\n  | { type: 'pat', token: string }\n  | {\n      type: 'app'\n      appId: number\n      privateKey: string\n      installationId: number\n    }\n\n/** Default author used when a call does not provide one. */\nexport const DEFAULT_GITHUB_AUTHOR: CommitAuthor = {\n  name: 'Contentrain',\n  email: 'mcp@contentrain.io',\n}\n"],"mappings":"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"}

package/dist/providers/gitlab/index.d.mts

@@ -0,0 +1,158 @@
+import { c as MergeResult, d as RepoReader, i as CommitAuthor, l as ProviderCapabilities, n as Branch, o as FileDiff, r as Commit, t as ApplyPlanInput, u as RepoProvider } from "../../index-D0wQJSgs.mjs";
+import { Gitlab } from "@gitbeaker/rest";
+
+//#region src/providers/gitlab/capabilities.d.ts
+/**
+ * Capability set for GitLabProvider.
+ *
+ * GitLab over REST has no working tree, so local worktree features,
+ * source-file access and AST scans are unavailable. Push, merge and
+ * branch-protection detection all work over the API. GitLab enforces
+ * merges through merge requests, so `pullRequestFallback` is `true` —
+ * `mergeBranch` opens an MR and auto-accepts it to match GitHub's
+ * `repos.merge` semantics while still leaving an audit trail.
+ */
+declare const GITLAB_CAPABILITIES: ProviderCapabilities;
+//#endregion
+//#region src/providers/gitlab/client.d.ts
+/**
+ * Type alias for a `Gitlab` instance from `@gitbeaker/rest`.
+ *
+ * Provider code operates against this narrow surface so callers can
+ * pass a fully constructed gitbeaker client, a carefully faked one for
+ * unit tests, or an instance created by {@link createGitLabClient} in
+ * `factory.ts`. The import is type-only so the runtime dependency
+ * stays a pure optional peer.
+ */
+type GitLabClient = InstanceType<typeof Gitlab>;
+//#endregion
+//#region src/providers/gitlab/types.d.ts
+/**
+ * A reference to a GitLab project.
+ *
+ * `projectId` accepts the numeric project ID or a URL-encoded path
+ * (`namespace/project`). Gitbeaker URL-encodes string paths internally,
+ * so either form is fine.
+ *
+ * `contentRoot` is the repo-relative directory prefix where Contentrain
+ * content lives. For a flat content repo it stays `''`; for a monorepo
+ * where Contentrain sits under `apps/web/.contentrain/` it holds that
+ * prefix. All reader/writer paths are joined against it.
+ *
+ * `host` points at a self-hosted GitLab instance. Leave undefined to
+ * use `https://gitlab.com` (gitbeaker's default).
+ */
+interface ProjectRef {
+  projectId: string | number;
+  contentRoot?: string;
+  host?: string;
+}
+/**
+ * Authentication options for the GitLab provider.
+ *
+ * - `pat` — personal access token with the `api` scope. Simplest for
+ *   self-hosted MCP or CI runners.
+ * - `oauth` — OAuth2 token. Used when the runner is driven by a GitLab
+ *   OAuth flow.
+ * - `job` — CI job token (`CI_JOB_TOKEN`). Scoped to the running
+ *   pipeline; useful for pipeline-driven content updates.
+ */
+type GitLabAuth = {
+  type: 'pat';
+  token: string;
+} | {
+  type: 'oauth';
+  oauthToken: string;
+} | {
+  type: 'job';
+  jobToken: string;
+};
+/** Default author used when a call does not provide one. */
+declare const DEFAULT_GITLAB_AUTHOR: CommitAuthor;
+//#endregion
+//#region src/providers/gitlab/provider.d.ts
+/**
+ * GitLabProvider — `RepoProvider` backed by the gitbeaker-driven GitLab
+ * REST API.
+ *
+ * Transport-agnostic: the provider only talks to a `GitLabClient`
+ * (a `@gitbeaker/rest` `Gitlab` instance). `createGitLabProvider` in
+ * `factory.ts` wraps the dynamic import so consumers never touch
+ * `@gitbeaker/rest` directly unless they want to.
+ *
+ * Capability gaps versus `GitHubProvider`: none — both providers
+ * expose the same set. GitLab's merge flow routes through an MR under
+ * the hood, but `mergeBranch` presents the same `MergeResult` shape.
+ */
+declare class GitLabProvider implements RepoProvider {
+  private readonly client;
+  readonly project: ProjectRef;
+  readonly capabilities: ProviderCapabilities;
+  private readonly reader;
+  constructor(client: GitLabClient, project: ProjectRef);
+  readFile(path: string, ref?: string): Promise<string>;
+  listDirectory(path: string, ref?: string): Promise<string[]>;
+  fileExists(path: string, ref?: string): Promise<boolean>;
+  applyPlan(input: ApplyPlanInput): Promise<Commit>;
+  listBranches(prefix?: string): Promise<Branch[]>;
+  createBranch(name: string, fromRef?: string): Promise<void>;
+  deleteBranch(name: string): Promise<void>;
+  getBranchDiff(branch: string, base?: string): Promise<FileDiff[]>;
+  mergeBranch(branch: string, into: string): Promise<MergeResult>;
+  isMerged(branch: string, into?: string): Promise<boolean>;
+  getDefaultBranch(): Promise<string>;
+}
+//#endregion
+//#region src/providers/gitlab/factory.d.ts
+/**
+ * Create a gitbeaker-backed `GitLabClient` from an auth configuration.
+ *
+ * The `@gitbeaker/rest` module is imported dynamically so it stays a
+ * pure optional peer dependency — self-hosted MCP on stdio runs fine
+ * without it. If the module is not installed, the import throws with
+ * a helpful hint pointing the operator at the peer dependency.
+ *
+ * Supported auth types: `pat`, `oauth`, `job`. All three are thin
+ * wrappers over gitbeaker's `token`, `oauthToken`, and `jobToken`
+ * constructor options.
+ */
+declare function createGitLabClient(auth: GitLabAuth, host?: string): Promise<GitLabClient>;
+/**
+ * Factory for the full provider — instantiates a gitbeaker client and
+ * wraps it in a `GitLabProvider`. Consumers who already hold a
+ * gitbeaker instance (HTTP server injecting shared clients, tests,
+ * etc.) should instantiate `GitLabProvider` directly instead.
+ */
+declare function createGitLabProvider(opts: {
+  auth: GitLabAuth;
+  project: ProjectRef;
+}): Promise<GitLabProvider>;
+//#endregion
+//#region src/providers/gitlab/reader.d.ts
+/**
+ * GitLabReader — `RepoReader` backed by the GitLab REST API.
+ *
+ * File reads go through `RepositoryFiles.showRaw`, which returns the
+ * file content as UTF-8 text (or a `Blob` on browser/edge runtimes we
+ * decode with `.text()`). Directory listings go through
+ * `Repositories.allRepositoryTrees`. `fileExists` tries the file
+ * endpoint first and falls back to a tree listing so directories
+ * resolve to `true` as well — matching LocalReader / GitHubReader.
+ *
+ * `ref` is forwarded verbatim and may be a branch name, tag name or
+ * commit SHA. Callers should always pass the explicit `contentrain`
+ * tracking branch; GitLab's default resolution is the project's
+ * default branch, which is usually wrong for Contentrain flows.
+ */
+declare class GitLabReader implements RepoReader {
+  private readonly client;
+  private readonly project;
+  constructor(client: GitLabClient, project: ProjectRef);
+  readFile(path: string, ref?: string): Promise<string>;
+  listDirectory(path: string, ref?: string): Promise<string[]>;
+  fileExists(path: string, ref?: string): Promise<boolean>;
+  private resolveDefaultRef;
+}
+//#endregion
+export { DEFAULT_GITLAB_AUTHOR, GITLAB_CAPABILITIES, type GitLabAuth, type GitLabClient, GitLabProvider, GitLabReader, type ProjectRef, createGitLabClient, createGitLabProvider };
+//# sourceMappingURL=index.d.mts.map

package/dist/providers/gitlab/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/providers/gitlab/capabilities.ts","../../../src/providers/gitlab/client.ts","../../../src/providers/gitlab/types.ts","../../../src/providers/gitlab/provider.ts","../../../src/providers/gitlab/factory.ts","../../../src/providers/gitlab/reader.ts"],"mappings":";;;;;;;AAYA;;;;;;;cAAa,mBAAA,EAAqB,oBAAA;;;;;;AAAlC;;;;;;KCDY,YAAA,GAAe,YAAA,QAAoB,MAAA;;;;;;ADC/C;;;;;;;;ACDA;;;;UCMiB,UAAA;EACf,SAAA;EACA,WAAA;EACA,IAAA;AAAA;;;;;;;;;AAaF;;KAAY,UAAA;EACN,IAAA;EAAa,KAAA;AAAA;EACb,IAAA;EAAe,UAAA;AAAA;EACf,IAAA;EAAa,QAAA;AAAA;AAGnB;AAAA,cAAa,qBAAA,EAAuB,YAAA;;;;AF3BpC;;;;;;;;ACDA;;;;cE0Ba,cAAA,YAA0B,YAAA;EAAA,iBAKlB,MAAA;EAAA,SACD,OAAA,EAAS,UAAA;EAAA,SALlB,YAAA,EAAc,oBAAA;EAAA,iBACN,MAAA;cAGE,MAAA,EAAQ,YAAA,EACT,OAAA,EAAS,UAAA;EAK3B,QAAA,CAAS,IAAA,UAAc,GAAA,YAAe,OAAA;EAGtC,aAAA,CAAc,IAAA,UAAc,GAAA,YAAe,OAAA;EAG3C,UAAA,CAAW,IAAA,UAAc,GAAA,YAAe,OAAA;EAIxC,SAAA,CAAU,KAAA,EAAO,cAAA,GAAiB,OAAA,CAAQ,MAAA;EAI1C,YAAA,CAAa,MAAA,YAAkB,OAAA,CAAQ,MAAA;EAGjC,YAAA,CAAa,IAAA,UAAc,OAAA,YAAmB,OAAA;EAIpD,YAAA,CAAa,IAAA,WAAe,OAAA;EAGtB,aAAA,CAAc,MAAA,UAAgB,IAAA,YAAgB,OAAA,CAAQ,QAAA;EAI5D,WAAA,CAAY,MAAA,UAAgB,IAAA,WAAe,OAAA,CAAQ,WAAA;EAG7C,QAAA,CAAS,MAAA,UAAgB,IAAA,YAAgB,OAAA;EAI/C,gBAAA,CAAA,GAAoB,OAAA;AAAA;;;;AHvEtB;;;;;;;;ACDA;;;iBGKsB,kBAAA,CACpB,IAAA,EAAM,UAAA,EACN,IAAA,YACC,OAAA,CAAQ,YAAA;;;;;AFFX;;iBEwCsB,oBAAA,CACpB,IAAA;EAAQ,IAAA,EAAM,UAAA;EAAY,OAAA,EAAS,UAAA;AAAA,IAClC,OAAA,CAAQ,cAAA;;;;AJ/CX;;;;;;;;ACDA;;;;;;cISa,YAAA,YAAwB,UAAA;EAAA,iBAEhB,MAAA;EAAA,iBACA,OAAA;cADA,MAAA,EAAQ,YAAA,EACR,OAAA,EAAS,UAAA;EAGtB,QAAA,CAAS,IAAA,UAAc,GAAA,YAAe,OAAA;EAatC,aAAA,CAAc,IAAA,UAAc,GAAA,YAAe,OAAA;EAoB3C,UAAA,CAAW,IAAA,UAAc,GAAA,YAAe,OAAA;EAAA,QA8BhC,iBAAA;AAAA"}

package/dist/providers/gitlab/index.mjs

@@ -0,0 +1,361 @@
+import { n as isNotFoundError, t as resolveRepoPath } from "../../paths-C3xNyc7z.mjs";
+import { CONTENTRAIN_BRANCH } from "@contentrain/types";
+//#region src/providers/gitlab/capabilities.ts
+/**
+* Capability set for GitLabProvider.
+*
+* GitLab over REST has no working tree, so local worktree features,
+* source-file access and AST scans are unavailable. Push, merge and
+* branch-protection detection all work over the API. GitLab enforces
+* merges through merge requests, so `pullRequestFallback` is `true` —
+* `mergeBranch` opens an MR and auto-accepts it to match GitHub's
+* `repos.merge` semantics while still leaving an audit trail.
+*/
+const GITLAB_CAPABILITIES = {
+	localWorktree: false,
+	sourceRead: false,
+	sourceWrite: false,
+	pushRemote: true,
+	branchProtection: true,
+	pullRequestFallback: true,
+	astScan: false
+};
+//#endregion
+//#region src/providers/gitlab/apply-plan.ts
+/**
+* Apply a plan to a GitLab repository as a single atomic commit via the
+* Commits API. High-level flow:
+*
+* 1. Check whether the target branch exists. If it does not, GitLab's
+*    `startBranch` option forks a new branch from `input.base` (or the
+*    project's default branch) as part of the same commit.
+* 2. For each `FileChange`, figure out the right GitLab action verb
+*    (`create` vs `update` vs `delete`) by probing the path against the
+*    resolved ref. GitLab validates this server-side and returns a 400
+*    for mismatches — we avoid the round trip by getting it right up
+*    front.
+* 3. POST `/repository/commits` once with the full action set. No
+*    working tree, no multi-call tree-assembly dance — GitLab exposes
+*    a richer primitive than the GitHub Git Data API for this case.
+*
+* The commit is durable as soon as the call returns; GitLab's ref
+* update happens inside the same request.
+*/
+async function applyPlanToGitLab(client, project, input) {
+	const branchExists = await branchHasRef(client, project, input.branch);
+	const baseBranch = input.base ?? CONTENTRAIN_BRANCH;
+	const refForActionResolution = branchExists ? input.branch : baseBranch;
+	const actions = (await Promise.all(input.changes.map((change) => resolveAction(client, project, refForActionResolution, change)))).filter((a) => a !== null);
+	if (actions.length === 0) throw new Error("applyPlanToGitLab: plan contained no applicable actions");
+	const options = {
+		authorName: input.author.name,
+		authorEmail: input.author.email
+	};
+	if (!branchExists) options.startBranch = baseBranch;
+	const commit = await client.Commits.create(project.projectId, input.branch, input.message, actions, options);
+	const commitTimestamp = toIsoTimestamp(commit.created_at) ?? (/* @__PURE__ */ new Date()).toISOString();
+	return {
+		sha: commit.id,
+		message: commit.message ?? input.message,
+		author: {
+			name: commit.author_name ?? input.author.name,
+			email: commit.author_email ?? input.author.email
+		},
+		timestamp: commitTimestamp
+	};
+}
+async function resolveAction(client, project, ref, change) {
+	const filePath = resolveRepoPath(project.contentRoot, change.path);
+	const exists = await fileExistsAtRef(client, project, filePath, ref);
+	if (change.content === null) {
+		if (!exists) return null;
+		return {
+			action: "delete",
+			filePath
+		};
+	}
+	return {
+		action: exists ? "update" : "create",
+		filePath,
+		content: change.content,
+		encoding: "text"
+	};
+}
+async function branchHasRef(client, project, branch) {
+	try {
+		await client.Branches.show(project.projectId, branch);
+		return true;
+	} catch (error) {
+		if (isNotFoundError(error)) return false;
+		throw error;
+	}
+}
+async function fileExistsAtRef(client, project, filePath, ref) {
+	try {
+		await client.RepositoryFiles.show(project.projectId, filePath, ref);
+		return true;
+	} catch (error) {
+		if (isNotFoundError(error)) return false;
+		throw error;
+	}
+}
+function toIsoTimestamp(raw) {
+	if (typeof raw !== "string") return null;
+	const date = new Date(raw);
+	if (Number.isNaN(date.getTime())) return null;
+	return date.toISOString();
+}
+//#endregion
+//#region src/providers/gitlab/branch-ops.ts
+/**
+* Branch / merge / diff helpers backed by the GitLab REST API.
+*
+* Pure functions so they can be composed into `GitLabProvider` or used
+* standalone. 404s collapse to empty-ish results where that matches
+* the `RepoProvider` contract (missing branch prefix → `[]`).
+*
+* Merge semantics: GitLab does not expose a direct branch-to-branch
+* merge endpoint. Every merge flows through a merge request, so
+* `mergeBranch` opens an MR and immediately accepts it. The resulting
+* `MergeResult` mirrors GitHub's `repos.merge` return shape — callers
+* see the same `{ merged, sha, pullRequestUrl }` envelope either way,
+* with the MR URL available for audit.
+*/
+async function getDefaultBranch(client, project) {
+	return (await client.Projects.show(project.projectId)).default_branch ?? "main";
+}
+async function listBranches(client, project, prefix) {
+	const options = {
+		perPage: 100,
+		maxPages: 10
+	};
+	if (prefix) options.search = prefix;
+	const rawBranches = await client.Branches.all(project.projectId, options);
+	return (Array.isArray(rawBranches) ? rawBranches : []).filter((b) => !prefix || b.name.startsWith(prefix)).map((b) => ({
+		name: b.name,
+		sha: b.commit.id,
+		protected: b.protected ?? false
+	}));
+}
+async function createBranch(client, project, name, fromRef) {
+	await client.Branches.create(project.projectId, name, fromRef);
+}
+async function deleteBranch(client, project, name) {
+	await client.Branches.remove(project.projectId, name);
+}
+async function getBranchDiff(client, project, branch, base) {
+	const response = await client.Repositories.compare(project.projectId, base, branch, { straight: false });
+	return (Array.isArray(response.diffs) ? response.diffs : []).map((d) => ({
+		path: d.new_file ? d.new_path : d.old_path,
+		status: d.deleted_file ? "removed" : d.new_file ? "added" : "modified",
+		before: null,
+		after: null
+	}));
+}
+async function mergeBranch(client, project, branch, into) {
+	const mr = await client.MergeRequests.create(project.projectId, branch, into, `[contentrain] merge ${branch} → ${into}`, { removeSourceBranch: false });
+	const accepted = await client.MergeRequests.accept(project.projectId, mr.iid, {
+		shouldRemoveSourceBranch: false,
+		squash: false
+	});
+	const mergeSha = accepted.merge_commit_sha ?? accepted.sha ?? null;
+	const webUrl = mr.web_url ?? null;
+	return {
+		merged: mergeSha !== null,
+		sha: mergeSha,
+		pullRequestUrl: webUrl
+	};
+}
+async function isMerged(client, project, branch, into) {
+	const response = await client.Repositories.compare(project.projectId, into, branch, { straight: false });
+	return (Array.isArray(response.commits) ? response.commits : []).length === 0;
+}
+//#endregion
+//#region src/providers/gitlab/reader.ts
+/**
+* GitLabReader — `RepoReader` backed by the GitLab REST API.
+*
+* File reads go through `RepositoryFiles.showRaw`, which returns the
+* file content as UTF-8 text (or a `Blob` on browser/edge runtimes we
+* decode with `.text()`). Directory listings go through
+* `Repositories.allRepositoryTrees`. `fileExists` tries the file
+* endpoint first and falls back to a tree listing so directories
+* resolve to `true` as well — matching LocalReader / GitHubReader.
+*
+* `ref` is forwarded verbatim and may be a branch name, tag name or
+* commit SHA. Callers should always pass the explicit `contentrain`
+* tracking branch; GitLab's default resolution is the project's
+* default branch, which is usually wrong for Contentrain flows.
+*/
+var GitLabReader = class {
+	constructor(client, project) {
+		this.client = client;
+		this.project = project;
+	}
+	async readFile(path, ref) {
+		const repoPath = resolveRepoPath(this.project.contentRoot, path);
+		const resolvedRef = ref ?? await this.resolveDefaultRef();
+		const raw = await this.client.RepositoryFiles.showRaw(this.project.projectId, repoPath, resolvedRef);
+		if (typeof raw === "string") return raw;
+		return raw.text();
+	}
+	async listDirectory(path, ref) {
+		const repoPath = resolveRepoPath(this.project.contentRoot, path);
+		const resolvedRef = ref ?? await this.resolveDefaultRef();
+		try {
+			const entries = await this.client.Repositories.allRepositoryTrees(this.project.projectId, {
+				path: repoPath,
+				ref: resolvedRef,
+				perPage: 100,
+				recursive: false
+			});
+			return Array.isArray(entries) ? entries.map((e) => e.name) : [];
+		} catch (error) {
+			if (isNotFoundError(error)) return [];
+			throw error;
+		}
+	}
+	async fileExists(path, ref) {
+		const repoPath = resolveRepoPath(this.project.contentRoot, path);
+		const resolvedRef = ref ?? await this.resolveDefaultRef();
+		try {
+			await this.client.RepositoryFiles.show(this.project.projectId, repoPath, resolvedRef);
+			return true;
+		} catch (error) {
+			if (!isNotFoundError(error)) throw error;
+		}
+		try {
+			const entries = await this.client.Repositories.allRepositoryTrees(this.project.projectId, {
+				path: repoPath,
+				ref: resolvedRef,
+				perPage: 1
+			});
+			return Array.isArray(entries) && entries.length > 0;
+		} catch (error) {
+			if (isNotFoundError(error)) return false;
+			throw error;
+		}
+	}
+	async resolveDefaultRef() {
+		return (await this.client.Projects.show(this.project.projectId)).default_branch ?? "main";
+	}
+};
+//#endregion
+//#region src/providers/gitlab/provider.ts
+/**
+* GitLabProvider — `RepoProvider` backed by the gitbeaker-driven GitLab
+* REST API.
+*
+* Transport-agnostic: the provider only talks to a `GitLabClient`
+* (a `@gitbeaker/rest` `Gitlab` instance). `createGitLabProvider` in
+* `factory.ts` wraps the dynamic import so consumers never touch
+* `@gitbeaker/rest` directly unless they want to.
+*
+* Capability gaps versus `GitHubProvider`: none — both providers
+* expose the same set. GitLab's merge flow routes through an MR under
+* the hood, but `mergeBranch` presents the same `MergeResult` shape.
+*/
+var GitLabProvider = class {
+	capabilities = GITLAB_CAPABILITIES;
+	reader;
+	constructor(client, project) {
+		this.client = client;
+		this.project = project;
+		this.reader = new GitLabReader(client, project);
+	}
+	readFile(path, ref) {
+		return this.reader.readFile(path, ref);
+	}
+	listDirectory(path, ref) {
+		return this.reader.listDirectory(path, ref);
+	}
+	fileExists(path, ref) {
+		return this.reader.fileExists(path, ref);
+	}
+	applyPlan(input) {
+		return applyPlanToGitLab(this.client, this.project, input);
+	}
+	listBranches(prefix) {
+		return listBranches(this.client, this.project, prefix);
+	}
+	async createBranch(name, fromRef) {
+		const resolved = fromRef ?? await getDefaultBranch(this.client, this.project);
+		await createBranch(this.client, this.project, name, resolved);
+	}
+	deleteBranch(name) {
+		return deleteBranch(this.client, this.project, name);
+	}
+	async getBranchDiff(branch, base) {
+		const resolved = base ?? await getDefaultBranch(this.client, this.project);
+		return getBranchDiff(this.client, this.project, branch, resolved);
+	}
+	mergeBranch(branch, into) {
+		return mergeBranch(this.client, this.project, branch, into);
+	}
+	async isMerged(branch, into) {
+		const resolved = into ?? await getDefaultBranch(this.client, this.project);
+		return isMerged(this.client, this.project, branch, resolved);
+	}
+	getDefaultBranch() {
+		return getDefaultBranch(this.client, this.project);
+	}
+};
+//#endregion
+//#region src/providers/gitlab/factory.ts
+/**
+* Create a gitbeaker-backed `GitLabClient` from an auth configuration.
+*
+* The `@gitbeaker/rest` module is imported dynamically so it stays a
+* pure optional peer dependency — self-hosted MCP on stdio runs fine
+* without it. If the module is not installed, the import throws with
+* a helpful hint pointing the operator at the peer dependency.
+*
+* Supported auth types: `pat`, `oauth`, `job`. All three are thin
+* wrappers over gitbeaker's `token`, `oauthToken`, and `jobToken`
+* constructor options.
+*/
+async function createGitLabClient(auth, host) {
+	let GitlabCtor;
+	try {
+		({Gitlab: GitlabCtor} = await import("@gitbeaker/rest"));
+	} catch (error) {
+		throw new Error("@gitbeaker/rest is required for the GitLabProvider but could not be loaded. Install it as a peer dependency: pnpm add @gitbeaker/rest.", { cause: error });
+	}
+	const config = host ? { host } : {};
+	switch (auth.type) {
+		case "pat":
+			config.token = auth.token;
+			break;
+		case "oauth":
+			config.oauthToken = auth.oauthToken;
+			break;
+		case "job":
+			config.jobToken = auth.jobToken;
+			break;
+		default: {
+			const { type } = auth;
+			throw new Error(`Unsupported GitLab auth type: "${type}"`);
+		}
+	}
+	return new GitlabCtor(config);
+}
+/**
+* Factory for the full provider — instantiates a gitbeaker client and
+* wraps it in a `GitLabProvider`. Consumers who already hold a
+* gitbeaker instance (HTTP server injecting shared clients, tests,
+* etc.) should instantiate `GitLabProvider` directly instead.
+*/
+async function createGitLabProvider(opts) {
+	return new GitLabProvider(await createGitLabClient(opts.auth, opts.project.host), opts.project);
+}
+//#endregion
+//#region src/providers/gitlab/types.ts
+/** Default author used when a call does not provide one. */
+const DEFAULT_GITLAB_AUTHOR = {
+	name: "Contentrain",
+	email: "mcp@contentrain.io"
+};
+//#endregion
+export { DEFAULT_GITLAB_AUTHOR, GITLAB_CAPABILITIES, GitLabProvider, GitLabReader, createGitLabClient, createGitLabProvider };
+
+//# sourceMappingURL=index.mjs.map

package/dist/providers/gitlab/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["listBranchesOp","getDefaultBranchOp","createBranchOp","deleteBranchOp","getBranchDiffOp","mergeBranchOp","isMergedOp"],"sources":["../../../src/providers/gitlab/capabilities.ts","../../../src/providers/gitlab/apply-plan.ts","../../../src/providers/gitlab/branch-ops.ts","../../../src/providers/gitlab/reader.ts","../../../src/providers/gitlab/provider.ts","../../../src/providers/gitlab/factory.ts","../../../src/providers/gitlab/types.ts"],"sourcesContent":["import type { ProviderCapabilities } from '../../core/contracts/index.js'\n\n/**\n * Capability set for GitLabProvider.\n *\n * GitLab over REST has no working tree, so local worktree features,\n * source-file access and AST scans are unavailable. Push, merge and\n * branch-protection detection all work over the API. GitLab enforces\n * merges through merge requests, so `pullRequestFallback` is `true` —\n * `mergeBranch` opens an MR and auto-accepts it to match GitHub's\n * `repos.merge` semantics while still leaving an audit trail.\n */\nexport const GITLAB_CAPABILITIES: ProviderCapabilities = {\n  localWorktree: false,\n  sourceRead: false,\n  sourceWrite: false,\n  pushRemote: true,\n  branchProtection: true,\n  pullRequestFallback: true,\n  astScan: false,\n}\n","import { CONTENTRAIN_BRANCH } from '@contentrain/types'\nimport type { ApplyPlanInput, Commit, FileChange } from '../../core/contracts/index.js'\nimport { isNotFoundError, resolveRepoPath } from '../shared/index.js'\nimport type { GitLabClient } from './client.js'\nimport type { ProjectRef } from './types.js'\n\ntype CommitActionType = 'create' | 'update' | 'delete'\n\ninterface CommitAction {\n  action: CommitActionType\n  filePath: string\n  content?: string\n  encoding?: 'text' | 'base64'\n}\n\n/**\n * Apply a plan to a GitLab repository as a single atomic commit via the\n * Commits API. High-level flow:\n *\n * 1. Check whether the target branch exists. If it does not, GitLab's\n *    `startBranch` option forks a new branch from `input.base` (or the\n *    project's default branch) as part of the same commit.\n * 2. For each `FileChange`, figure out the right GitLab action verb\n *    (`create` vs `update` vs `delete`) by probing the path against the\n *    resolved ref. GitLab validates this server-side and returns a 400\n *    for mismatches — we avoid the round trip by getting it right up\n *    front.\n * 3. POST `/repository/commits` once with the full action set. No\n *    working tree, no multi-call tree-assembly dance — GitLab exposes\n *    a richer primitive than the GitHub Git Data API for this case.\n *\n * The commit is durable as soon as the call returns; GitLab's ref\n * update happens inside the same request.\n */\nexport async function applyPlanToGitLab(\n  client: GitLabClient,\n  project: ProjectRef,\n  input: ApplyPlanInput,\n): Promise<Commit> {\n  const branchExists = await branchHasRef(client, project, input.branch)\n  // Invariant: fork from the Contentrain content-tracking branch, not\n  // the repo's default branch. See ApplyPlanInput.base docstring in\n  // @contentrain/types.\n  const baseBranch = input.base ?? CONTENTRAIN_BRANCH\n\n  // Actions are computed against the HEAD of the feature branch when it\n  // exists, otherwise against the fork point (baseBranch). GitLab\n  // treats `create` / `update` / `delete` as a strict check against the\n  // path's existence at that ref.\n  const refForActionResolution = branchExists ? input.branch : baseBranch\n  const rawActions = await Promise.all(\n    input.changes.map(change => resolveAction(client, project, refForActionResolution, change)),\n  )\n  const actions = rawActions.filter((a): a is CommitAction => a !== null)\n\n  if (actions.length === 0) {\n    // Nothing to apply. Callers don't generally build empty plans, but\n    // if they do we short-circuit before touching the API.\n    throw new Error('applyPlanToGitLab: plan contained no applicable actions')\n  }\n\n  const options: Record<string, unknown> = {\n    authorName: input.author.name,\n    authorEmail: input.author.email,\n  }\n  if (!branchExists) {\n    options.startBranch = baseBranch\n  }\n\n  const response = await client.Commits.create(\n    project.projectId,\n    input.branch,\n    input.message,\n    actions,\n    options,\n  )\n\n  // Gitbeaker's generic-heavy response type widens string fields to\n  // `string | Camelize<…>` — at runtime they are always strings under\n  // the default (non-camelize) response mode we use. Cast narrows the\n  // shape we actually touch.\n  const commit = response as {\n    id: string\n    message?: string\n    author_name?: string\n    author_email?: string\n    created_at?: string\n  }\n  const commitTimestamp = toIsoTimestamp(commit.created_at) ?? new Date().toISOString()\n  return {\n    sha: commit.id,\n    message: commit.message ?? input.message,\n    author: {\n      name: commit.author_name ?? input.author.name,\n      email: commit.author_email ?? input.author.email,\n    },\n    timestamp: commitTimestamp,\n  }\n}\n\nasync function resolveAction(\n  client: GitLabClient,\n  project: ProjectRef,\n  ref: string,\n  change: FileChange,\n): Promise<CommitAction | null> {\n  const filePath = resolveRepoPath(project.contentRoot, change.path)\n  const exists = await fileExistsAtRef(client, project, filePath, ref)\n\n  if (change.content === null) {\n    // Filter out deletes against non-existent files — GitLab returns\n    // 400 otherwise. The plan author asked us to \"make this file not\n    // exist\", which is already satisfied.\n    if (!exists) return null\n    return { action: 'delete', filePath }\n  }\n\n  return {\n    action: exists ? 'update' : 'create',\n    filePath,\n    content: change.content,\n    encoding: 'text',\n  }\n}\n\nasync function branchHasRef(\n  client: GitLabClient,\n  project: ProjectRef,\n  branch: string,\n): Promise<boolean> {\n  try {\n    await client.Branches.show(project.projectId, branch)\n    return true\n  } catch (error) {\n    if (isNotFoundError(error)) return false\n    throw error\n  }\n}\n\nasync function fileExistsAtRef(\n  client: GitLabClient,\n  project: ProjectRef,\n  filePath: string,\n  ref: string,\n): Promise<boolean> {\n  try {\n    await client.RepositoryFiles.show(project.projectId, filePath, ref)\n    return true\n  } catch (error) {\n    if (isNotFoundError(error)) return false\n    throw error\n  }\n}\n\n\nfunction toIsoTimestamp(raw: unknown): string | null {\n  if (typeof raw !== 'string') return null\n  const date = new Date(raw)\n  if (Number.isNaN(date.getTime())) return null\n  return date.toISOString()\n}\n\n","import type { Branch, FileDiff, MergeResult } from '../../core/contracts/index.js'\nimport type { GitLabClient } from './client.js'\nimport type { ProjectRef } from './types.js'\n\n/**\n * Branch / merge / diff helpers backed by the GitLab REST API.\n *\n * Pure functions so they can be composed into `GitLabProvider` or used\n * standalone. 404s collapse to empty-ish results where that matches\n * the `RepoProvider` contract (missing branch prefix → `[]`).\n *\n * Merge semantics: GitLab does not expose a direct branch-to-branch\n * merge endpoint. Every merge flows through a merge request, so\n * `mergeBranch` opens an MR and immediately accepts it. The resulting\n * `MergeResult` mirrors GitHub's `repos.merge` return shape — callers\n * see the same `{ merged, sha, pullRequestUrl }` envelope either way,\n * with the MR URL available for audit.\n */\n\nexport async function getDefaultBranch(\n  client: GitLabClient,\n  project: ProjectRef,\n): Promise<string> {\n  const p = await client.Projects.show(project.projectId) as { default_branch?: string }\n  return p.default_branch ?? 'main'\n}\n\nexport async function listBranches(\n  client: GitLabClient,\n  project: ProjectRef,\n  prefix?: string,\n): Promise<Branch[]> {\n  // Gitbeaker's `all` supports a `search` string (substring match). For\n  // Contentrain's `cr/*` naming the substring case is equivalent to a\n  // prefix because the slug never appears anywhere except at the start.\n  // Server-side filter + client-side prefix enforcement keeps us\n  // correct even if the substring coincidence breaks someday.\n  const options: Record<string, unknown> = {\n    perPage: 100,\n    maxPages: 10,\n  }\n  if (prefix) options.search = prefix\n\n  const rawBranches = await client.Branches.all(project.projectId, options)\n  const branches = Array.isArray(rawBranches) ? rawBranches : []\n\n  return branches\n    .filter((b: { name: string }) => !prefix || b.name.startsWith(prefix))\n    .map((b: { name: string, commit: { id: string }, protected?: boolean }) => ({\n      name: b.name,\n      sha: b.commit.id,\n      protected: b.protected ?? false,\n    }))\n}\n\nexport async function createBranch(\n  client: GitLabClient,\n  project: ProjectRef,\n  name: string,\n  fromRef: string,\n): Promise<void> {\n  await client.Branches.create(project.projectId, name, fromRef)\n}\n\nexport async function deleteBranch(\n  client: GitLabClient,\n  project: ProjectRef,\n  name: string,\n): Promise<void> {\n  await client.Branches.remove(project.projectId, name)\n}\n\nexport async function getBranchDiff(\n  client: GitLabClient,\n  project: ProjectRef,\n  branch: string,\n  base: string,\n): Promise<FileDiff[]> {\n  const response = await client.Repositories.compare(\n    project.projectId,\n    base,\n    branch,\n    { straight: false },\n  )\n  const diffs = Array.isArray(response.diffs) ? response.diffs : []\n  return diffs.map((d: { new_path: string, old_path: string, new_file?: boolean, deleted_file?: boolean }) => ({\n    path: d.new_file ? d.new_path : d.old_path,\n    status: d.deleted_file ? 'removed' : d.new_file ? 'added' : 'modified',\n    before: null,\n    after: null,\n  }))\n}\n\nexport async function mergeBranch(\n  client: GitLabClient,\n  project: ProjectRef,\n  branch: string,\n  into: string,\n): Promise<MergeResult> {\n  // 1. Open MR — GitLab rejects create when source === target or when\n  //    an MR is already open for this pair. Let the error propagate in\n  //    those cases; the caller retries or surfaces the message.\n  const mr = await client.MergeRequests.create(\n    project.projectId,\n    branch,\n    into,\n    `[contentrain] merge ${branch} → ${into}`,\n    { removeSourceBranch: false },\n  )\n\n  // 2. Accept the MR immediately. `shouldRemoveSourceBranch: false`\n  //    preserves the feature branch so audit/retry logic still has\n  //    access to it; Studio's cleanup flow deletes it separately.\n  const accepted = await client.MergeRequests.accept(\n    project.projectId,\n    (mr as { iid: number }).iid,\n    { shouldRemoveSourceBranch: false, squash: false },\n  )\n\n  const mergeSha = (accepted as { merge_commit_sha?: string | null, sha?: string | null }).merge_commit_sha\n    ?? (accepted as { sha?: string | null }).sha\n    ?? null\n  const webUrl = (mr as { web_url?: string }).web_url ?? null\n\n  return { merged: mergeSha !== null, sha: mergeSha, pullRequestUrl: webUrl }\n}\n\nexport async function isMerged(\n  client: GitLabClient,\n  project: ProjectRef,\n  branch: string,\n  into: string,\n): Promise<boolean> {\n  // compare(from=into, to=branch) — commits list is empty when branch\n  // is fully contained in into (i.e. already merged).\n  const response = await client.Repositories.compare(\n    project.projectId,\n    into,\n    branch,\n    { straight: false },\n  )\n  const commits = Array.isArray(response.commits) ? response.commits : []\n  return commits.length === 0\n}\n","import type { RepoReader } from '../../core/contracts/index.js'\nimport { isNotFoundError, resolveRepoPath } from '../shared/index.js'\nimport type { GitLabClient } from './client.js'\nimport type { ProjectRef } from './types.js'\n\n/**\n * GitLabReader — `RepoReader` backed by the GitLab REST API.\n *\n * File reads go through `RepositoryFiles.showRaw`, which returns the\n * file content as UTF-8 text (or a `Blob` on browser/edge runtimes we\n * decode with `.text()`). Directory listings go through\n * `Repositories.allRepositoryTrees`. `fileExists` tries the file\n * endpoint first and falls back to a tree listing so directories\n * resolve to `true` as well — matching LocalReader / GitHubReader.\n *\n * `ref` is forwarded verbatim and may be a branch name, tag name or\n * commit SHA. Callers should always pass the explicit `contentrain`\n * tracking branch; GitLab's default resolution is the project's\n * default branch, which is usually wrong for Contentrain flows.\n */\nexport class GitLabReader implements RepoReader {\n  constructor(\n    private readonly client: GitLabClient,\n    private readonly project: ProjectRef,\n  ) {}\n\n  async readFile(path: string, ref?: string): Promise<string> {\n    const repoPath = resolveRepoPath(this.project.contentRoot, path)\n    const resolvedRef = ref ?? await this.resolveDefaultRef()\n    const raw = await this.client.RepositoryFiles.showRaw(\n      this.project.projectId,\n      repoPath,\n      resolvedRef,\n    )\n    if (typeof raw === 'string') return raw\n    // Browser / edge runtimes return a Blob; decode as UTF-8.\n    return (raw as Blob).text()\n  }\n\n  async listDirectory(path: string, ref?: string): Promise<string[]> {\n    const repoPath = resolveRepoPath(this.project.contentRoot, path)\n    const resolvedRef = ref ?? await this.resolveDefaultRef()\n    try {\n      const entries = await this.client.Repositories.allRepositoryTrees(\n        this.project.projectId,\n        {\n          path: repoPath,\n          ref: resolvedRef,\n          perPage: 100,\n          recursive: false,\n        },\n      )\n      return Array.isArray(entries) ? entries.map(e => e.name) : []\n    } catch (error) {\n      if (isNotFoundError(error)) return []\n      throw error\n    }\n  }\n\n  async fileExists(path: string, ref?: string): Promise<boolean> {\n    const repoPath = resolveRepoPath(this.project.contentRoot, path)\n    const resolvedRef = ref ?? await this.resolveDefaultRef()\n\n    // 1. Try as a file — cheap and most common case for Contentrain.\n    try {\n      await this.client.RepositoryFiles.show(\n        this.project.projectId,\n        repoPath,\n        resolvedRef,\n      )\n      return true\n    } catch (error) {\n      if (!isNotFoundError(error)) throw error\n    }\n\n    // 2. Fall back to a tree listing — directories and empty dirs show\n    //    up here. Any non-404 result means the path resolves.\n    try {\n      const entries = await this.client.Repositories.allRepositoryTrees(\n        this.project.projectId,\n        { path: repoPath, ref: resolvedRef, perPage: 1 },\n      )\n      return Array.isArray(entries) && entries.length > 0\n    } catch (error) {\n      if (isNotFoundError(error)) return false\n      throw error\n    }\n  }\n\n  private async resolveDefaultRef(): Promise<string> {\n    const project = await this.client.Projects.show(this.project.projectId) as { default_branch?: string }\n    return project.default_branch ?? 'main'\n  }\n}\n\n","import type {\n  ApplyPlanInput,\n  Branch,\n  Commit,\n  FileDiff,\n  MergeResult,\n  ProviderCapabilities,\n  RepoProvider,\n} from '../../core/contracts/index.js'\nimport { applyPlanToGitLab } from './apply-plan.js'\nimport {\n  createBranch as createBranchOp,\n  deleteBranch as deleteBranchOp,\n  getBranchDiff as getBranchDiffOp,\n  getDefaultBranch as getDefaultBranchOp,\n  isMerged as isMergedOp,\n  listBranches as listBranchesOp,\n  mergeBranch as mergeBranchOp,\n} from './branch-ops.js'\nimport { GITLAB_CAPABILITIES } from './capabilities.js'\nimport type { GitLabClient } from './client.js'\nimport { GitLabReader } from './reader.js'\nimport type { ProjectRef } from './types.js'\n\n/**\n * GitLabProvider — `RepoProvider` backed by the gitbeaker-driven GitLab\n * REST API.\n *\n * Transport-agnostic: the provider only talks to a `GitLabClient`\n * (a `@gitbeaker/rest` `Gitlab` instance). `createGitLabProvider` in\n * `factory.ts` wraps the dynamic import so consumers never touch\n * `@gitbeaker/rest` directly unless they want to.\n *\n * Capability gaps versus `GitHubProvider`: none — both providers\n * expose the same set. GitLab's merge flow routes through an MR under\n * the hood, but `mergeBranch` presents the same `MergeResult` shape.\n */\nexport class GitLabProvider implements RepoProvider {\n  readonly capabilities: ProviderCapabilities = GITLAB_CAPABILITIES\n  private readonly reader: GitLabReader\n\n  constructor(\n    private readonly client: GitLabClient,\n    public readonly project: ProjectRef,\n  ) {\n    this.reader = new GitLabReader(client, project)\n  }\n\n  readFile(path: string, ref?: string): Promise<string> {\n    return this.reader.readFile(path, ref)\n  }\n  listDirectory(path: string, ref?: string): Promise<string[]> {\n    return this.reader.listDirectory(path, ref)\n  }\n  fileExists(path: string, ref?: string): Promise<boolean> {\n    return this.reader.fileExists(path, ref)\n  }\n\n  applyPlan(input: ApplyPlanInput): Promise<Commit> {\n    return applyPlanToGitLab(this.client, this.project, input)\n  }\n\n  listBranches(prefix?: string): Promise<Branch[]> {\n    return listBranchesOp(this.client, this.project, prefix)\n  }\n  async createBranch(name: string, fromRef?: string): Promise<void> {\n    const resolved = fromRef ?? await getDefaultBranchOp(this.client, this.project)\n    await createBranchOp(this.client, this.project, name, resolved)\n  }\n  deleteBranch(name: string): Promise<void> {\n    return deleteBranchOp(this.client, this.project, name)\n  }\n  async getBranchDiff(branch: string, base?: string): Promise<FileDiff[]> {\n    const resolved = base ?? await getDefaultBranchOp(this.client, this.project)\n    return getBranchDiffOp(this.client, this.project, branch, resolved)\n  }\n  mergeBranch(branch: string, into: string): Promise<MergeResult> {\n    return mergeBranchOp(this.client, this.project, branch, into)\n  }\n  async isMerged(branch: string, into?: string): Promise<boolean> {\n    const resolved = into ?? await getDefaultBranchOp(this.client, this.project)\n    return isMergedOp(this.client, this.project, branch, resolved)\n  }\n  getDefaultBranch(): Promise<string> {\n    return getDefaultBranchOp(this.client, this.project)\n  }\n}\n","import type { GitLabClient } from './client.js'\nimport { GitLabProvider } from './provider.js'\nimport type { GitLabAuth, ProjectRef } from './types.js'\n\n/**\n * Create a gitbeaker-backed `GitLabClient` from an auth configuration.\n *\n * The `@gitbeaker/rest` module is imported dynamically so it stays a\n * pure optional peer dependency — self-hosted MCP on stdio runs fine\n * without it. If the module is not installed, the import throws with\n * a helpful hint pointing the operator at the peer dependency.\n *\n * Supported auth types: `pat`, `oauth`, `job`. All three are thin\n * wrappers over gitbeaker's `token`, `oauthToken`, and `jobToken`\n * constructor options.\n */\nexport async function createGitLabClient(\n  auth: GitLabAuth,\n  host?: string,\n): Promise<GitLabClient> {\n  let GitlabCtor: typeof import('@gitbeaker/rest').Gitlab\n  try {\n    ({ Gitlab: GitlabCtor } = await import('@gitbeaker/rest'))\n  } catch (error) {\n    throw new Error(\n      '@gitbeaker/rest is required for the GitLabProvider but could not be loaded. '\n      + 'Install it as a peer dependency: pnpm add @gitbeaker/rest.',\n      { cause: error },\n    )\n  }\n\n  const config: Record<string, unknown> = host ? { host } : {}\n  switch (auth.type) {\n    case 'pat':\n      config.token = auth.token\n      break\n    case 'oauth':\n      config.oauthToken = auth.oauthToken\n      break\n    case 'job':\n      config.jobToken = auth.jobToken\n      break\n    default: {\n      const { type } = auth as { type: string }\n      throw new Error(`Unsupported GitLab auth type: \"${type}\"`)\n    }\n  }\n\n  return new GitlabCtor(config) as GitLabClient\n}\n\n/**\n * Factory for the full provider — instantiates a gitbeaker client and\n * wraps it in a `GitLabProvider`. Consumers who already hold a\n * gitbeaker instance (HTTP server injecting shared clients, tests,\n * etc.) should instantiate `GitLabProvider` directly instead.\n */\nexport async function createGitLabProvider(\n  opts: { auth: GitLabAuth, project: ProjectRef },\n): Promise<GitLabProvider> {\n  const client = await createGitLabClient(opts.auth, opts.project.host)\n  return new GitLabProvider(client, opts.project)\n}\n","import type { CommitAuthor } from '../../core/contracts/index.js'\n\n/**\n * A reference to a GitLab project.\n *\n * `projectId` accepts the numeric project ID or a URL-encoded path\n * (`namespace/project`). Gitbeaker URL-encodes string paths internally,\n * so either form is fine.\n *\n * `contentRoot` is the repo-relative directory prefix where Contentrain\n * content lives. For a flat content repo it stays `''`; for a monorepo\n * where Contentrain sits under `apps/web/.contentrain/` it holds that\n * prefix. All reader/writer paths are joined against it.\n *\n * `host` points at a self-hosted GitLab instance. Leave undefined to\n * use `https://gitlab.com` (gitbeaker's default).\n */\nexport interface ProjectRef {\n  projectId: string | number\n  contentRoot?: string\n  host?: string\n}\n\n/**\n * Authentication options for the GitLab provider.\n *\n * - `pat` — personal access token with the `api` scope. Simplest for\n *   self-hosted MCP or CI runners.\n * - `oauth` — OAuth2 token. Used when the runner is driven by a GitLab\n *   OAuth flow.\n * - `job` — CI job token (`CI_JOB_TOKEN`). Scoped to the running\n *   pipeline; useful for pipeline-driven content updates.\n */\nexport type GitLabAuth =\n  | { type: 'pat', token: string }\n  | { type: 'oauth', oauthToken: string }\n  | { type: 'job', jobToken: string }\n\n/** Default author used when a call does not provide one. */\nexport const DEFAULT_GITLAB_AUTHOR: CommitAuthor = {\n  name: 'Contentrain',\n  email: 'mcp@contentrain.io',\n}\n"],"mappings":";;;;;;;;;;;;;AAYA,MAAa,sBAA4C;CACvD,eAAe;CACf,YAAY;CACZ,aAAa;CACb,YAAY;CACZ,kBAAkB;CAClB,qBAAqB;CACrB,SAAS;CACV;;;;;;;;;;;;;;;;;;;;;;ACcD,eAAsB,kBACpB,QACA,SACA,OACiB;CACjB,MAAM,eAAe,MAAM,aAAa,QAAQ,SAAS,MAAM,OAAO;CAItE,MAAM,aAAa,MAAM,QAAQ;CAMjC,MAAM,yBAAyB,eAAe,MAAM,SAAS;CAI7D,MAAM,WAHa,MAAM,QAAQ,IAC/B,MAAM,QAAQ,KAAI,WAAU,cAAc,QAAQ,SAAS,wBAAwB,OAAO,CAAC,CAC5F,EAC0B,QAAQ,MAAyB,MAAM,KAAK;AAEvE,KAAI,QAAQ,WAAW,EAGrB,OAAM,IAAI,MAAM,0DAA0D;CAG5E,MAAM,UAAmC;EACvC,YAAY,MAAM,OAAO;EACzB,aAAa,MAAM,OAAO;EAC3B;AACD,KAAI,CAAC,aACH,SAAQ,cAAc;CAexB,MAAM,SAZW,MAAM,OAAO,QAAQ,OACpC,QAAQ,WACR,MAAM,QACN,MAAM,SACN,SACA,QACD;CAaD,MAAM,kBAAkB,eAAe,OAAO,WAAW,qBAAI,IAAI,MAAM,EAAC,aAAa;AACrF,QAAO;EACL,KAAK,OAAO;EACZ,SAAS,OAAO,WAAW,MAAM;EACjC,QAAQ;GACN,MAAM,OAAO,eAAe,MAAM,OAAO;GACzC,OAAO,OAAO,gBAAgB,MAAM,OAAO;GAC5C;EACD,WAAW;EACZ;;AAGH,eAAe,cACb,QACA,SACA,KACA,QAC8B;CAC9B,MAAM,WAAW,gBAAgB,QAAQ,aAAa,OAAO,KAAK;CAClE,MAAM,SAAS,MAAM,gBAAgB,QAAQ,SAAS,UAAU,IAAI;AAEpE,KAAI,OAAO,YAAY,MAAM;AAI3B,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO;GAAE,QAAQ;GAAU;GAAU;;AAGvC,QAAO;EACL,QAAQ,SAAS,WAAW;EAC5B;EACA,SAAS,OAAO;EAChB,UAAU;EACX;;AAGH,eAAe,aACb,QACA,SACA,QACkB;AAClB,KAAI;AACF,QAAM,OAAO,SAAS,KAAK,QAAQ,WAAW,OAAO;AACrD,SAAO;UACA,OAAO;AACd,MAAI,gBAAgB,MAAM,CAAE,QAAO;AACnC,QAAM;;;AAIV,eAAe,gBACb,QACA,SACA,UACA,KACkB;AAClB,KAAI;AACF,QAAM,OAAO,gBAAgB,KAAK,QAAQ,WAAW,UAAU,IAAI;AACnE,SAAO;UACA,OAAO;AACd,MAAI,gBAAgB,MAAM,CAAE,QAAO;AACnC,QAAM;;;AAKV,SAAS,eAAe,KAA6B;AACnD,KAAI,OAAO,QAAQ,SAAU,QAAO;CACpC,MAAM,OAAO,IAAI,KAAK,IAAI;AAC1B,KAAI,OAAO,MAAM,KAAK,SAAS,CAAC,CAAE,QAAO;AACzC,QAAO,KAAK,aAAa;;;;;;;;;;;;;;;;;;AC5I3B,eAAsB,iBACpB,QACA,SACiB;AAEjB,SADU,MAAM,OAAO,SAAS,KAAK,QAAQ,UAAU,EAC9C,kBAAkB;;AAG7B,eAAsB,aACpB,QACA,SACA,QACmB;CAMnB,MAAM,UAAmC;EACvC,SAAS;EACT,UAAU;EACX;AACD,KAAI,OAAQ,SAAQ,SAAS;CAE7B,MAAM,cAAc,MAAM,OAAO,SAAS,IAAI,QAAQ,WAAW,QAAQ;AAGzE,SAFiB,MAAM,QAAQ,YAAY,GAAG,cAAc,EAAE,EAG3D,QAAQ,MAAwB,CAAC,UAAU,EAAE,KAAK,WAAW,OAAO,CAAC,CACrE,KAAK,OAAsE;EAC1E,MAAM,EAAE;EACR,KAAK,EAAE,OAAO;EACd,WAAW,EAAE,aAAa;EAC3B,EAAE;;AAGP,eAAsB,aACpB,QACA,SACA,MACA,SACe;AACf,OAAM,OAAO,SAAS,OAAO,QAAQ,WAAW,MAAM,QAAQ;;AAGhE,eAAsB,aACpB,QACA,SACA,MACe;AACf,OAAM,OAAO,SAAS,OAAO,QAAQ,WAAW,KAAK;;AAGvD,eAAsB,cACpB,QACA,SACA,QACA,MACqB;CACrB,MAAM,WAAW,MAAM,OAAO,aAAa,QACzC,QAAQ,WACR,MACA,QACA,EAAE,UAAU,OAAO,CACpB;AAED,SADc,MAAM,QAAQ,SAAS,MAAM,GAAG,SAAS,QAAQ,EAAE,EACpD,KAAK,OAA2F;EAC3G,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE;EAClC,QAAQ,EAAE,eAAe,YAAY,EAAE,WAAW,UAAU;EAC5D,QAAQ;EACR,OAAO;EACR,EAAE;;AAGL,eAAsB,YACpB,QACA,SACA,QACA,MACsB;CAItB,MAAM,KAAK,MAAM,OAAO,cAAc,OACpC,QAAQ,WACR,QACA,MACA,uBAAuB,OAAO,KAAK,QACnC,EAAE,oBAAoB,OAAO,CAC9B;CAKD,MAAM,WAAW,MAAM,OAAO,cAAc,OAC1C,QAAQ,WACP,GAAuB,KACxB;EAAE,0BAA0B;EAAO,QAAQ;EAAO,CACnD;CAED,MAAM,WAAY,SAAuE,oBACnF,SAAqC,OACtC;CACL,MAAM,SAAU,GAA4B,WAAW;AAEvD,QAAO;EAAE,QAAQ,aAAa;EAAM,KAAK;EAAU,gBAAgB;EAAQ;;AAG7E,eAAsB,SACpB,QACA,SACA,QACA,MACkB;CAGlB,MAAM,WAAW,MAAM,OAAO,aAAa,QACzC,QAAQ,WACR,MACA,QACA,EAAE,UAAU,OAAO,CACpB;AAED,SADgB,MAAM,QAAQ,SAAS,QAAQ,GAAG,SAAS,UAAU,EAAE,EACxD,WAAW;;;;;;;;;;;;;;;;;;;AC1H5B,IAAa,eAAb,MAAgD;CAC9C,YACE,QACA,SACA;AAFiB,OAAA,SAAA;AACA,OAAA,UAAA;;CAGnB,MAAM,SAAS,MAAc,KAA+B;EAC1D,MAAM,WAAW,gBAAgB,KAAK,QAAQ,aAAa,KAAK;EAChE,MAAM,cAAc,OAAO,MAAM,KAAK,mBAAmB;EACzD,MAAM,MAAM,MAAM,KAAK,OAAO,gBAAgB,QAC5C,KAAK,QAAQ,WACb,UACA,YACD;AACD,MAAI,OAAO,QAAQ,SAAU,QAAO;AAEpC,SAAQ,IAAa,MAAM;;CAG7B,MAAM,cAAc,MAAc,KAAiC;EACjE,MAAM,WAAW,gBAAgB,KAAK,QAAQ,aAAa,KAAK;EAChE,MAAM,cAAc,OAAO,MAAM,KAAK,mBAAmB;AACzD,MAAI;GACF,MAAM,UAAU,MAAM,KAAK,OAAO,aAAa,mBAC7C,KAAK,QAAQ,WACb;IACE,MAAM;IACN,KAAK;IACL,SAAS;IACT,WAAW;IACZ,CACF;AACD,UAAO,MAAM,QAAQ,QAAQ,GAAG,QAAQ,KAAI,MAAK,EAAE,KAAK,GAAG,EAAE;WACtD,OAAO;AACd,OAAI,gBAAgB,MAAM,CAAE,QAAO,EAAE;AACrC,SAAM;;;CAIV,MAAM,WAAW,MAAc,KAAgC;EAC7D,MAAM,WAAW,gBAAgB,KAAK,QAAQ,aAAa,KAAK;EAChE,MAAM,cAAc,OAAO,MAAM,KAAK,mBAAmB;AAGzD,MAAI;AACF,SAAM,KAAK,OAAO,gBAAgB,KAChC,KAAK,QAAQ,WACb,UACA,YACD;AACD,UAAO;WACA,OAAO;AACd,OAAI,CAAC,gBAAgB,MAAM,CAAE,OAAM;;AAKrC,MAAI;GACF,MAAM,UAAU,MAAM,KAAK,OAAO,aAAa,mBAC7C,KAAK,QAAQ,WACb;IAAE,MAAM;IAAU,KAAK;IAAa,SAAS;IAAG,CACjD;AACD,UAAO,MAAM,QAAQ,QAAQ,IAAI,QAAQ,SAAS;WAC3C,OAAO;AACd,OAAI,gBAAgB,MAAM,CAAE,QAAO;AACnC,SAAM;;;CAIV,MAAc,oBAAqC;AAEjD,UADgB,MAAM,KAAK,OAAO,SAAS,KAAK,KAAK,QAAQ,UAAU,EACxD,kBAAkB;;;;;;;;;;;;;;;;;;ACtDrC,IAAa,iBAAb,MAAoD;CAClD,eAA8C;CAC9C;CAEA,YACE,QACA,SACA;AAFiB,OAAA,SAAA;AACD,OAAA,UAAA;AAEhB,OAAK,SAAS,IAAI,aAAa,QAAQ,QAAQ;;CAGjD,SAAS,MAAc,KAA+B;AACpD,SAAO,KAAK,OAAO,SAAS,MAAM,IAAI;;CAExC,cAAc,MAAc,KAAiC;AAC3D,SAAO,KAAK,OAAO,cAAc,MAAM,IAAI;;CAE7C,WAAW,MAAc,KAAgC;AACvD,SAAO,KAAK,OAAO,WAAW,MAAM,IAAI;;CAG1C,UAAU,OAAwC;AAChD,SAAO,kBAAkB,KAAK,QAAQ,KAAK,SAAS,MAAM;;CAG5D,aAAa,QAAoC;AAC/C,SAAOA,aAAe,KAAK,QAAQ,KAAK,SAAS,OAAO;;CAE1D,MAAM,aAAa,MAAc,SAAiC;EAChE,MAAM,WAAW,WAAW,MAAMC,iBAAmB,KAAK,QAAQ,KAAK,QAAQ;AAC/E,QAAMC,aAAe,KAAK,QAAQ,KAAK,SAAS,MAAM,SAAS;;CAEjE,aAAa,MAA6B;AACxC,SAAOC,aAAe,KAAK,QAAQ,KAAK,SAAS,KAAK;;CAExD,MAAM,cAAc,QAAgB,MAAoC;EACtE,MAAM,WAAW,QAAQ,MAAMF,iBAAmB,KAAK,QAAQ,KAAK,QAAQ;AAC5E,SAAOG,cAAgB,KAAK,QAAQ,KAAK,SAAS,QAAQ,SAAS;;CAErE,YAAY,QAAgB,MAAoC;AAC9D,SAAOC,YAAc,KAAK,QAAQ,KAAK,SAAS,QAAQ,KAAK;;CAE/D,MAAM,SAAS,QAAgB,MAAiC;EAC9D,MAAM,WAAW,QAAQ,MAAMJ,iBAAmB,KAAK,QAAQ,KAAK,QAAQ;AAC5E,SAAOK,SAAW,KAAK,QAAQ,KAAK,SAAS,QAAQ,SAAS;;CAEhE,mBAAoC;AAClC,SAAOL,iBAAmB,KAAK,QAAQ,KAAK,QAAQ;;;;;;;;;;;;;;;;;ACpExD,eAAsB,mBACpB,MACA,MACuB;CACvB,IAAI;AACJ,KAAI;AACF,GAAC,CAAE,QAAQ,cAAe,MAAM,OAAO;UAChC,OAAO;AACd,QAAM,IAAI,MACR,0IAEA,EAAE,OAAO,OAAO,CACjB;;CAGH,MAAM,SAAkC,OAAO,EAAE,MAAM,GAAG,EAAE;AAC5D,SAAQ,KAAK,MAAb;EACE,KAAK;AACH,UAAO,QAAQ,KAAK;AACpB;EACF,KAAK;AACH,UAAO,aAAa,KAAK;AACzB;EACF,KAAK;AACH,UAAO,WAAW,KAAK;AACvB;EACF,SAAS;GACP,MAAM,EAAE,SAAS;AACjB,SAAM,IAAI,MAAM,kCAAkC,KAAK,GAAG;;;AAI9D,QAAO,IAAI,WAAW,OAAO;;;;;;;;AAS/B,eAAsB,qBACpB,MACyB;AAEzB,QAAO,IAAI,eADI,MAAM,mBAAmB,KAAK,MAAM,KAAK,QAAQ,KAAK,EACnC,KAAK,QAAQ;;;;;ACtBjD,MAAa,wBAAsC;CACjD,MAAM;CACN,OAAO;CACR"}