@contentrain/mcp 1.6.0 → 1.8.1

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

@@ -1 +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: 'ai@contentrain.io',\n}\n"],"mappings":"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"}
+{"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 { CONTENTRAIN_BRANCH } from '@contentrain/types'\nimport 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  opts?: { removeSourceBranch?: boolean },\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` keeps\n  //    GitLab's async server-side deletion out of the accept call — the\n  //    explicit cleanup below owns it, so the outcome is deterministic and\n  //    reported via `MergeResult.remote`.\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  const merged = mergeSha !== null\n\n  // 3. Source-branch cleanup — OPT-IN (`removeSourceBranch: true`). Like git\n  //    and GitLab's own merge, `mergeBranch` leaves the source alone by\n  //    default. Even when opted in, a long-lived branch is NEVER deleted:\n  //    not the merge target (`into`), not the `contentrain` content branch,\n  //    not the project's default branch. Mirrors the LocalProvider guard;\n  //    defends against head/base confusion and contentrain↔default flows.\n  //    Never throws — the merge itself already succeeded.\n  const remote = merged ? await cleanupSourceBranch(client, project, branch, into, opts) : undefined\n\n  return { merged, sha: mergeSha, pullRequestUrl: webUrl, ...(remote ? { remote } : {}) }\n}\n\n/**\n * Opt-in ({@link mergeBranch} `removeSourceBranch: true`) deletion of the\n * merged source branch, with the same guard as the GitHub provider and the\n * LocalProvider: never delete the merge target, the `contentrain` content\n * branch, or the project default branch — even when opted in. Fail-safe\n * skips the delete if the default branch cannot be resolved. Never throws.\n */\nasync function cleanupSourceBranch(\n  client: GitLabClient,\n  project: ProjectRef,\n  branch: string,\n  into: string,\n  opts?: { removeSourceBranch?: boolean },\n): Promise<MergeResult['remote'] | undefined> {\n  if (opts?.removeSourceBranch !== true) return undefined\n\n  if (branch === into || branch === CONTENTRAIN_BRANCH) {\n    return { deleted: false, skipped: 'protected' }\n  }\n  try {\n    if (branch === await getDefaultBranch(client, project)) {\n      return { deleted: false, skipped: 'protected' }\n    }\n  } catch {\n    return { deleted: false, skipped: 'protected' }\n  }\n\n  try {\n    await deleteBranch(client, project, branch)\n    return { deleted: true }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n    return /404|not found/i.test(message)\n      ? { deleted: false, skipped: 'not-found' }\n      : { deleted: false, warning: `Could not delete \"${branch}\": ${message}` }\n  }\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, opts?: { removeSourceBranch?: boolean }): Promise<MergeResult> {\n    return mergeBranchOp(this.client, this.project, branch, into, opts)\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: 'ai@contentrain.io',\n}\n"],"mappings":"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"}

package/dist/providers/local/index.mjs

@@ -2,11 +2,12 @@ import "../../contracts-DfL0BfrD.mjs";
 import "../../ops-Dh2T3u53.mjs";
 import "../../serialization-B1CEzR4H.mjs";
 import "../../fs-DLbVB-Ek.mjs";
-import "../../config-Lw7vpK9n.mjs";
+import "../../config-DlFcTxFG.mjs";
 import { C as LocalReader } from "../../model-manager-BhLsUgaB.mjs";
 import "../../meta-manager-C900rEyG.mjs";
-import "../../context-DS40WOdw.mjs";
-import "../../id-CIO9s0x_.mjs";
-import "../../transaction-LiTjan9Q.mjs";
-import { t as LocalProvider } from "../../local-D56D9e5T.mjs";
+import "../../context-CYN__o3Q.mjs";
+import "../../branch-lifecycle-D7tXOE4f.mjs";
+import "../../id-DV_T9Ic8.mjs";
+import "../../transaction-qliKvBRL.mjs";
+import { t as LocalProvider } from "../../local-BZEUWBoC.mjs";
 export { LocalProvider, LocalReader };

package/dist/server/http/index.d.mts

@@ -1,4 +1,4 @@
-import { n as ToolProvider } from "../../server-WqGx6ait.mjs";
+import { n as ToolProvider } from "../../server-DZBcZWhE.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import http from "node:http";
 

package/dist/server/http/index.mjs

@@ -2,24 +2,24 @@ import "../../contracts-DfL0BfrD.mjs";
 import "../../ops-Dh2T3u53.mjs";
 import "../../serialization-B1CEzR4H.mjs";
 import "../../fs-DLbVB-Ek.mjs";
-import "../../config-Lw7vpK9n.mjs";
+import "../../config-DlFcTxFG.mjs";
 import "../../model-manager-BhLsUgaB.mjs";
 import "../../meta-manager-C900rEyG.mjs";
-import "../../context-DS40WOdw.mjs";
-import "../../id-CIO9s0x_.mjs";
-import "../../transaction-LiTjan9Q.mjs";
-import "../../local-D56D9e5T.mjs";
-import "../../detect-DL9mFmaS.mjs";
-import "../../branch-lifecycle-DjX3MXNG.mjs";
+import "../../context-CYN__o3Q.mjs";
+import "../../branch-lifecycle-D7tXOE4f.mjs";
+import "../../id-DV_T9Ic8.mjs";
+import "../../transaction-qliKvBRL.mjs";
+import "../../local-BZEUWBoC.mjs";
+import "../../detect-eWS6lvoH.mjs";
 import "../../annotations-BFJbfSKe.mjs";
-import { t as createServer } from "../../server-CufhOunD.mjs";
-import "../../validator-Bo06QPVB.mjs";
+import { t as createServer } from "../../server-CXZFrEyu.mjs";
+import "../../validator-Z3DGNWQ6.mjs";
 import "../../scan-config-jC6XmiqF.mjs";
 import "../../graph-builder-DXv2JEp-.mjs";
 import "../../scanner-DKMwc03k.mjs";
 import "../../tsx-parser-CQc6nr-o.mjs";
-import "../../apply-manager-BJ3nKEls.mjs";
-import "../../doctor-Dxu_SzZy.mjs";
+import "../../apply-manager-BRmB27H5.mjs";
+import "../../doctor-qiUKCy9b.mjs";
 import { randomUUID } from "node:crypto";
 import http from "node:http";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";

package/dist/{server-CufhOunD.mjs → server-CXZFrEyu.mjs}

@@ -1,22 +1,22 @@
 import { i as planContentDelete, n as planModelDelete, r as planContentSave, t as planModelSave } from "./ops-Dh2T3u53.mjs";
 import { n as contentFilePath, t as contentDirPath } from "./paths-CYl5vCBD.mjs";
 import { a as readJson, n as ensureDir, r as pathExists, s as writeJson, t as contentrainDir } from "./fs-DLbVB-Ek.mjs";
-import { n as readVocabulary, t as readConfig } from "./config-Lw7vpK9n.mjs";
+import { n as readVocabulary, t as readConfig } from "./config-DlFcTxFG.mjs";
 import { S as writeContent, _ as resolveMdFilePath, a as fieldDefZodSchema, c as validateModelDefinition, d as listContent, g as resolveLocaleStrategy, h as resolveJsonFilePath, l as writeModel, m as resolveContentDir, n as checkReferences, o as listModels, r as countEntries, s as readModel, u as deleteContent } from "./model-manager-BhLsUgaB.mjs";
 import { n as readMeta, r as writeMeta } from "./meta-manager-C900rEyG.mjs";
-import { n as readContext } from "./context-DS40WOdw.mjs";
-import { i as mergeBranch, n as createTransaction, r as ensureContentBranch, t as buildBranchName } from "./transaction-LiTjan9Q.mjs";
-import { n as isMerged, t as LocalProvider } from "./local-D56D9e5T.mjs";
-import { t as detectStack } from "./detect-DL9mFmaS.mjs";
-import { n as checkBranchHealth, r as cleanupMergedBranches } from "./branch-lifecycle-DjX3MXNG.mjs";
+import { n as readContext } from "./context-CYN__o3Q.mjs";
+import { a as deleteRemoteBranch, c as pruneMergedRemoteBranches, i as cleanupMergedBranches, n as checkBranchHealth, s as listRemoteCrBranches } from "./branch-lifecycle-D7tXOE4f.mjs";
+import { i as mergeBranch, n as createTransaction, r as ensureContentBranch, t as buildBranchName } from "./transaction-qliKvBRL.mjs";
+import { n as isMerged, t as LocalProvider } from "./local-BZEUWBoC.mjs";
+import { t as detectStack } from "./detect-eWS6lvoH.mjs";
 import { t as TOOL_ANNOTATIONS } from "./annotations-BFJbfSKe.mjs";
 import { n as listTemplates, t as getTemplate } from "./templates-VrLVqfe5.mjs";
-import { t as validateProject } from "./validator-Bo06QPVB.mjs";
+import { t as validateProject } from "./validator-Z3DGNWQ6.mjs";
 import { t as OverlayReader } from "./overlay-reader-CUs9jgqk.mjs";
 import { t as buildGraph } from "./graph-builder-DXv2JEp-.mjs";
 import { n as scanSummary, t as scanCandidates } from "./scanner-DKMwc03k.mjs";
-import { n as applyExtract, r as applyReuse } from "./apply-manager-BJ3nKEls.mjs";
-import { t as runDoctor } from "./doctor-Dxu_SzZy.mjs";
+import { n as applyExtract, r as applyReuse } from "./apply-manager-BRmB27H5.mjs";
+import { t as runDoctor } from "./doctor-qiUKCy9b.mjs";
 import { join } from "node:path";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { CONTENTRAIN_BRANCH } from "@contentrain/types";
@@ -1576,10 +1576,15 @@ function registerWorkflowTools(server, provider, projectRoot) {
 				await git.push(remoteName, CONTENTRAIN_BRANCH);
 			} catch {}
 			const cleanup = await cleanupMergedBranches(projectRoot);
+			const remotePrune = await pruneMergedRemoteBranches(projectRoot, {
+				config,
+				max: 20
+			});
 			const nextSteps = [];
 			if (pushed.length > 0) nextSteps.push("Create PRs on your git platform for review");
 			if (pushed.length > 0) nextSteps.push("For merge: use contentrain_merge or direct user to http://localhost:3333/branches");
 			if (errors.length > 0) nextSteps.push("Fix push errors and retry");
+			if (remotePrune.errors.length > 0) nextSteps.push("Some merged remote branches could not be pruned — run `contentrain prune`");
 			if (cleanup.remaining >= 50) nextSteps.push(`Warning: ${cleanup.remaining} active contentrain branches. Consider reviewing old branches.`);
 			return { content: [{
 				type: "text",
@@ -1593,6 +1598,7 @@ function registerWorkflowTools(server, provider, projectRoot) {
 						deleted: cleanup.deleted,
 						remaining: cleanup.remaining
 					} : void 0,
+					remote_cleanup: remotePrune.deleted.length > 0 ? { deleted: remotePrune.deleted.length } : void 0,
 					next_steps: nextSteps
 				}, null, 2)
 			}] };
@@ -1644,10 +1650,12 @@ function registerWorkflowTools(server, provider, projectRoot) {
 					action: result.action,
 					commit: result.commit,
 					sync: result.sync,
+					...result.remote ? { remote: result.remote } : {},
 					next_steps: [
 						"Run `contentrain generate` (or `npx contentrain-query generate`) to update the SDK client",
 						"Run contentrain_validate to verify content integrity",
-						result.sync.skipped.length > 0 ? `${result.sync.skipped.length} file(s) skipped due to local changes — resolve manually` : ""
+						result.sync.skipped.length > 0 ? `${result.sync.skipped.length} file(s) skipped due to local changes — resolve manually` : "",
+						result.remote?.warning ? `Remote copy not deleted (${result.remote.warning}) — delete it manually: git push <remote> --delete ${targetBranch}` : ""
 					].filter(Boolean)
 				}, null, 2)
 			}] };
@@ -1661,12 +1669,17 @@ function registerWorkflowTools(server, provider, projectRoot) {
 			};
 		}
 	});
-	server.tool("contentrain_branch_list", "List pending contentrain (cr/*) branches with their merge status against the contentrain branch. Use this to discover branch names for contentrain_merge / contentrain_branch_delete, and to monitor branch-health limits (warning at 50, blocked at 80 unmerged).", { unmerged_only: z.boolean().optional().describe("Only list branches not yet merged into contentrain. Default: false") }, TOOL_ANNOTATIONS["contentrain_branch_list"], async (input) => {
+	server.tool("contentrain_branch_list", "List pending contentrain (cr/*) branches with their merge status against the contentrain branch. Use this to discover branch names for contentrain_merge / contentrain_branch_delete, and to monitor branch-health limits (warning at 50, blocked at 80 unmerged).", {
+		unmerged_only: z.boolean().optional().describe("Only list branches not yet merged into contentrain. Default: false"),
+		remote: z.boolean().optional().describe("Also check the git remote: annotate entries with on_remote and report remote-only cr/* leftovers. Requires network. Default: false")
+	}, TOOL_ANNOTATIONS["contentrain_branch_list"], async (input) => {
 		if (!provider.capabilities.localWorktree || !projectRoot) return capabilityError("contentrain_branch_list", "localWorktree");
 		try {
 			const git = simpleGit(projectRoot);
 			const summary = await git.branchLocal();
 			const crBranches = summary.all.filter((b) => b.startsWith("cr/") && b !== CONTENTRAIN_BRANCH);
+			const remoteList = input.remote ? await listRemoteCrBranches(projectRoot) : void 0;
+			const remoteNames = remoteList && !remoteList.error ? new Set(remoteList.branches.map((b) => b.name)) : void 0;
 			const ordered = (await Promise.all(crBranches.map(async (name) => {
 				const [merged, ts] = await Promise.all([isMerged(projectRoot, name, CONTENTRAIN_BRANCH), git.raw([
 					"log",
@@ -1678,17 +1691,21 @@ function registerWorkflowTools(server, provider, projectRoot) {
 					name,
 					sha: summary.branches[name]?.commit ?? "",
 					merged,
-					lastCommit: ts
+					lastCommit: ts,
+					...remoteNames ? { on_remote: remoteNames.has(name) } : {}
 				};
 			}))).toSorted((left, right) => right.lastCommit.localeCompare(left.lastCommit));
 			const filtered = input.unmerged_only ? ordered.filter((b) => !b.merged) : ordered;
 			const health = await checkBranchHealth(projectRoot);
+			const localNames = new Set(crBranches);
+			const remoteExtras = input.remote ? remoteList === null ? { remote_error: "No git remote configured." } : remoteList.error ? { remote_error: remoteList.error } : { remote_only: remoteList.branches.filter((b) => !localNames.has(b.name)).map((b) => b.name) } : {};
 			return { content: [{
 				type: "text",
 				text: JSON.stringify({
 					total: ordered.length,
 					unmerged: ordered.filter((b) => !b.merged).length,
 					branches: filtered,
+					...remoteExtras,
 					health: {
 						warning: health.warning,
 						blocked: health.blocked,
@@ -1721,28 +1738,45 @@ function registerWorkflowTools(server, provider, projectRoot) {
 		};
 		try {
 			const git = simpleGit(projectRoot);
-			if (!(await git.branchLocal()).all.includes(input.branch)) return {
-				content: [{
+			if (!(await git.branchLocal()).all.includes(input.branch)) {
+				const remoteOnly = await deleteRemoteBranch(projectRoot, input.branch);
+				if (remoteOnly.deleted) return { content: [{
 					type: "text",
 					text: JSON.stringify({
-						error: `Branch "${input.branch}" not found locally.`,
-						next_steps: ["List branches with contentrain_branch_list"]
-					})
-				}],
-				isError: true
-			};
+						status: "deleted",
+						branch: input.branch,
+						scope: "remote-only",
+						message: "Branch was not present locally; its remote copy was deleted."
+					}, null, 2)
+				}] };
+				return {
+					content: [{
+						type: "text",
+						text: JSON.stringify({
+							error: `Branch "${input.branch}" not found locally${remoteOnly.skipped === "not-found" ? " or on the remote" : ""}.`,
+							...remoteOnly.warning ? { remote_warning: remoteOnly.warning } : {},
+							next_steps: ["List branches with contentrain_branch_list"]
+						})
+					}],
+					isError: true
+				};
+			}
 			const merged = await isMerged(projectRoot, input.branch, CONTENTRAIN_BRANCH);
 			await git.raw([
 				"branch",
 				"-D",
 				input.branch
 			]);
+			const remote = await deleteRemoteBranch(projectRoot, input.branch);
 			return { content: [{
 				type: "text",
 				text: JSON.stringify({
 					status: "deleted",
 					branch: input.branch,
 					was_merged: merged,
+					remote_deleted: remote.deleted,
+					...remote.skipped ? { remote_skipped: remote.skipped } : {},
+					...remote.warning ? { remote_warning: remote.warning } : {},
 					warning: merged ? void 0 : "Branch was not merged — its commits were discarded."
 				}, null, 2)
 			}] };
@@ -2334,7 +2368,7 @@ function registerDoctorTools(server, _provider, projectRoot) {
 }
 //#endregion
 //#region package.json
-var version = "1.6.0";
+var version = "1.8.1";
 //#endregion
 //#region src/server.ts
 function createServer(input) {
@@ -2375,4 +2409,4 @@ function resolveServerContext(input) {
 //#endregion
 export { createServer as t };
 
-//# sourceMappingURL=server-CufhOunD.mjs.map
+//# sourceMappingURL=server-CXZFrEyu.mjs.map