@foundation0/git 1.2.0 → 1.2.2

package/README.md

@@ -197,12 +197,21 @@ await api.repo.sync()
 ### 5) Team triage with labels
 
 ```ts
-await api.label.list()
-await api.label.create({ data: { name: 'priority-high', color: '#d73a4a' } })
-await api.label.edit('priority-high', {
-  data: { color: '#fbca04', description: 'Escalated issue' },
+await api.repo.label.listManaged()
+
+await api.repo.label.upsert('priority-high', {
+  color: '#d73a4a',
+  description: 'Initial escalation label',
 })
-await api.label.delete('priority-high')
+
+await api.repo.label.getByName('priority-high')
+
+await api.repo.label.upsert('priority-high', {
+  color: '#fbca04',
+  description: 'Escalated issue',
+})
+
+await api.repo.label.deleteByName('priority-high')
 ```
 
 ### 6) Search and discovery

package/mcp/README.md

@@ -199,7 +199,7 @@ Tips:
 
 - Prefer `https://` for `GITEA_HOST` to avoid leaking `GITEA_TOKEN` over plaintext HTTP.
 - The CLI entrypoint in `packages/git/mcp/src/cli.ts` rejects `http://` hosts unless `--allow-insecure-http` is passed for local testing.
-- Keep `GITEA_TOKEN` in environment variables (or an uncommitted `.env`); use the repo root `.env.example` as a template.
+- Set `GITEA_TOKEN` in the MCP process environment. The package does not auto-load `.env` files.
 
 ## API surface
 
@@ -207,3 +207,5 @@ Tips:
 - `GitMcpClient`
 - `createGitMcpClient(options)`
 - `normalizeToolCallNameForServer(prefix, toolName)`
+- Includes label-management tools exposed from the API object:
+  `repo.label.listManaged`, `repo.label.getByName`, `repo.label.upsert`, and `repo.label.deleteByName`

package/mcp/src/cli.ts

@@ -41,14 +41,18 @@ if (hasFlag('--help') || hasFlag('-h')) {
   process.exit(0)
 }
 
-const owner = getArgValue('--default-owner', process.env.GITEA_TEST_OWNER ?? 'example-org')
-const repo = getArgValue('--default-repo', process.env.GITEA_TEST_REPO ?? 'example-repo')
-const host = getArgValue('--gitea-host', process.env.GITEA_HOST ?? process.env.EXAMPLE_GITEA_HOST ?? 'https://gitea.example.com')?.trim()
+const owner = getArgValue('--default-owner')?.trim()
+const repo = getArgValue('--default-repo')?.trim()
+const host = getArgValue('--gitea-host', process.env.GITEA_HOST)?.trim()
 const token = process.env.GITEA_TOKEN
 const serverName = getArgValue('--server-name', 'f0-git-mcp')
 const serverVersion = getArgValue('--server-version', '1.0.0')
 const toolsPrefix = getArgValue('--tools-prefix') ?? process.env.MCP_TOOLS_PREFIX
 
+if (!host) {
+  throw new Error('GITEA_HOST is required. Set process.env.GITEA_HOST or pass --gitea-host.')
+}
+
 if (isInsecureHttpUrl(host) && !hasFlag('--allow-insecure-http')) {
   throw new Error(
     'Refusing to send requests to an insecure http:// Gitea host. Use https:// or pass --allow-insecure-http if you really need this for local testing.',
@@ -63,8 +67,8 @@ void runGitMcpServer({
     giteaHost: host,
     giteaToken: token,
   },
-  defaultOwner: owner,
-  defaultRepo: repo,
+  ...(owner ? { defaultOwner: owner } : {}),
+  ...(repo ? { defaultRepo: repo } : {}),
   toolsPrefix,
 }).catch((error) => {
   console.error('Failed to start MCP git server', error)

package/package.json

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

package/src/git-service-api.ts

@@ -2,6 +2,7 @@ import { createGitPlatformAdapter, type GitPlatformAdapterFactoryDeps } from './
 import { getGitPlatformConfig, type GitPlatformConfig } from './platform/config'
 import { type GitServiceFlag, type GitServiceFeature, gitServiceFeatureSpec } from './git-service-feature-spec.generated'
 import { type GitApiFeatureMapping } from './platform/gitea-adapter'
+import { attachGitLabelManagementApi } from './label-management'
 import { spawn } from 'node:child_process'
 import crypto from 'node:crypto'
 
@@ -217,6 +218,22 @@ const buildUrl = (
   return url.toString()
 }
 
+const unresolvedPathParamPattern = /^\{[^{}]+\}$/
+
+const assertResolvedMappedPath = (
+  mappedPath: string[],
+  featurePath: string[],
+): void => {
+  const unresolved = mappedPath.filter((segment) => unresolvedPathParamPattern.test(segment))
+  if (unresolved.length === 0) {
+    return
+  }
+
+  throw new Error(
+    `Missing required path arguments for "${featurePath.join('.')}". Unresolved parameters: ${unresolved.join(', ')}`,
+  )
+}
+
 const canUseAbortSignalTimeout = (): boolean =>
   typeof AbortSignal !== 'undefined' && typeof (AbortSignal as unknown as { timeout?: unknown }).timeout === 'function'
 
@@ -368,6 +385,7 @@ const createMethod = (
 
       return segment
     })
+    assertResolvedMappedPath(hydratedPath, feature.path)
 
     const requestBody = buildRequestBody(mapping.method, bodyOptions, unhandled)
     const headers = {
@@ -529,8 +547,8 @@ export const createGitServiceApi = (options: GitServiceApiFactoryOptions = {}):
   const log = options.log
 
   const defaults = {
-    defaultOwner: options.defaultOwner ?? process.env.GITEA_TEST_OWNER ?? 'example-org',
-    defaultRepo: options.defaultRepo ?? process.env.GITEA_TEST_REPO ?? 'example-repo',
+    defaultOwner: options.defaultOwner,
+    defaultRepo: options.defaultRepo,
   }
 
   const root: GitServiceApi = {}
@@ -556,7 +574,29 @@ export const createGitServiceApi = (options: GitServiceApiFactoryOptions = {}):
     }
   }
 
+  attachGitLabelManagementApi(root, defaults)
+
   return root
 }
 
-export const gitServiceApi = createGitServiceApi()
+const createUnavailableGitServiceApi = (error: Error): GitServiceApi => {
+  return new Proxy(
+    {},
+    {
+      get: (): never => {
+        throw error
+      },
+    },
+  ) as GitServiceApi
+}
+
+export const gitServiceApi: GitServiceApi = (() => {
+  try {
+    return createGitServiceApi()
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error)
+    return createUnavailableGitServiceApi(
+      new Error(`Failed to initialize gitServiceApi singleton: ${message}`),
+    )
+  }
+})()

package/src/index.ts

@@ -36,6 +36,14 @@ export {
   type GitIssueDependencyPayload,
   type GitIssueDependencySyncResult,
 } from './issue-dependencies'
+export {
+  attachGitLabelManagementApi,
+  createGitLabelManagementApi,
+  extractRepositoryLabels,
+  type GitLabelManagementApi,
+  type GitLabelManagementDefaults,
+  type GitRepositoryLabel,
+} from './label-management'
 export { resolveProjectRepoIdentity, type GitRepositoryIdentity } from './repository'
 export type {
   GitServiceApi,

package/src/issue-dependencies.ts

@@ -2,7 +2,6 @@ import type { GitServiceApiExecutionResult } from './git-service-api'
 import { spawn } from 'node:child_process'
 import crypto from 'node:crypto'
 
-const DEFAULT_GITEA_HOST = 'https://gitea.example.com'
 const DEFAULT_REQUEST_TIMEOUT_MS = 60_000
 
 const parseRequestTimeoutMs = (value: unknown): number | null => {
@@ -274,6 +273,14 @@ const resolveGiteaApiBase = (host: string): string => {
   return trimmed.endsWith('/api/v1') ? trimmed : `${trimmed}/api/v1`
 }
 
+const resolveRequiredGiteaHost = (host: string | undefined): string => {
+  const resolved = host?.trim() ?? process.env.GITEA_HOST?.trim()
+  if (!resolved) {
+    throw new Error('GITEA_HOST is required. Pass host explicitly or set process.env.GITEA_HOST.')
+  }
+  return resolved
+}
+
 const buildIssueDependenciesUrl = (host: string, owner: string, repo: string, issueNumber: number): string => {
   return `${resolveGiteaApiBase(host)}/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues/${issueNumber}/dependencies`
 }
@@ -283,11 +290,12 @@ export async function callIssueDependenciesApi(
   owner: string,
   repo: string,
   issueNumber: number,
-  host: string = DEFAULT_GITEA_HOST,
+  host: string | undefined,
   token: string | undefined,
   payload?: GitIssueDependencyPayload
 ): Promise<GitServiceApiExecutionResult<unknown>> {
-  const requestUrl = buildIssueDependenciesUrl(host, owner, repo, issueNumber)
+  const resolvedHost = resolveRequiredGiteaHost(host)
+  const requestUrl = buildIssueDependenciesUrl(resolvedHost, owner, repo, issueNumber)
   const headers = {
     Accept: 'application/json',
     ...(token ? { Authorization: `token ${token}` } : {}),
@@ -343,7 +351,7 @@ export async function callIssueDependenciesApi(
       method,
       query: [],
       headers: [],
-      apiBase: resolveGiteaApiBase(host),
+      apiBase: resolveGiteaApiBase(resolvedHost),
       swaggerPath: '/repos/{owner}/{repo}/issues/{index}/dependencies',
       mapped: true,
     },

package/src/label-management.ts

@@ -0,0 +1,587 @@
+import type { GitServiceApi, GitServiceApiExecutionResult, GitServiceApiMethod } from './git-service-api'
+
+const LABEL_LIST_PAGE_SIZE = 100
+const MAX_LABEL_LIST_PAGES = 100
+
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+  typeof value === 'object' && value !== null && !Array.isArray(value)
+
+const toTrimmedString = (value: unknown): string | null => {
+  if (typeof value !== 'string') {
+    return null
+  }
+  const trimmed = value.trim()
+  return trimmed.length > 0 ? trimmed : null
+}
+
+const toPositiveInteger = (value: unknown): number | null => {
+  const candidate = Number(value)
+  if (!Number.isFinite(candidate) || candidate <= 0 || Math.floor(candidate) !== candidate) {
+    return null
+  }
+  return candidate
+}
+
+const toBoolean = (value: unknown, fallback: boolean): boolean => {
+  if (typeof value === 'boolean') {
+    return value
+  }
+
+  if (typeof value === 'string') {
+    const normalized = value.trim().toLowerCase()
+    if (normalized === 'true' || normalized === '1' || normalized === 'yes') {
+      return true
+    }
+    if (normalized === 'false' || normalized === '0' || normalized === 'no') {
+      return false
+    }
+  }
+
+  return fallback
+}
+
+const toQueryRecord = (raw: unknown): Record<string, string | number | boolean> => {
+  if (!isRecord(raw)) {
+    return {}
+  }
+
+  const query: Record<string, string | number | boolean> = {}
+  for (const [key, value] of Object.entries(raw)) {
+    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+      query[key] = value
+    }
+  }
+  return query
+}
+
+type ScopeArgs = {
+  owner?: string
+  repo?: string
+  options: Record<string, unknown>
+}
+
+type NamedScopeArgs = ScopeArgs & {
+  name: string
+}
+
+const normalizeScopeArgs = (
+  ownerOrOptions?: unknown,
+  repoOrOptions?: unknown,
+  maybeOptions?: unknown,
+): ScopeArgs => {
+  const options: Record<string, unknown> = {}
+  let owner: string | undefined
+  let repo: string | undefined
+
+  const absorb = (value: unknown): string | undefined => {
+    if (value === undefined || value === null) {
+      return undefined
+    }
+
+    if (isRecord(value)) {
+      Object.assign(options, value)
+      return undefined
+    }
+
+    const asText = String(value).trim()
+    return asText.length > 0 ? asText : undefined
+  }
+
+  owner = absorb(ownerOrOptions)
+  repo = absorb(repoOrOptions)
+
+  if (isRecord(maybeOptions)) {
+    Object.assign(options, maybeOptions)
+  }
+
+  return {
+    ...(owner ? { owner } : {}),
+    ...(repo ? { repo } : {}),
+    options,
+  }
+}
+
+const normalizeNamedScopeArgs = (
+  labelName: unknown,
+  ownerOrOptions?: unknown,
+  repoOrOptions?: unknown,
+  maybeOptions?: unknown,
+): NamedScopeArgs => {
+  const name = toTrimmedString(labelName)
+  if (!name) {
+    throw new Error('Label name is required.')
+  }
+
+  return {
+    name,
+    ...normalizeScopeArgs(ownerOrOptions, repoOrOptions, maybeOptions),
+  }
+}
+
+export interface GitLabelManagementDefaults {
+  defaultOwner?: string
+  defaultRepo?: string
+}
+
+const resolveOwnerRepo = (
+  scope: Pick<ScopeArgs, 'owner' | 'repo'>,
+  defaults: GitLabelManagementDefaults,
+): { owner: string; repo: string } => {
+  const owner = scope.owner ?? defaults.defaultOwner
+  const repo = scope.repo ?? defaults.defaultRepo
+
+  if (!owner || !repo) {
+    throw new Error(
+      'Owner/repo is required. Pass owner and repo args or set defaultOwner/defaultRepo when creating the API.',
+    )
+  }
+
+  return { owner, repo }
+}
+
+const resolveLabelNamespace = (api: GitServiceApi): GitServiceApi => {
+  const direct = (api as Record<string, unknown>).label
+  if (isRecord(direct)) {
+    return direct as GitServiceApi
+  }
+
+  const repoNamespace = (api as Record<string, unknown>).repo
+  if (isRecord(repoNamespace)) {
+    const repoLabel = (repoNamespace as Record<string, unknown>).label
+    if (isRecord(repoLabel)) {
+      return repoLabel as GitServiceApi
+    }
+  }
+
+  throw new Error('Git service API does not expose label namespace')
+}
+
+type LabelCrudFeature = 'list' | 'create' | 'edit' | 'delete'
+
+const resolveLabelMethod = (api: GitServiceApi, feature: LabelCrudFeature): GitServiceApiMethod => {
+  const labelNamespace = resolveLabelNamespace(api)
+  const method = (labelNamespace as Record<string, unknown>)[feature]
+  if (typeof method !== 'function') {
+    throw new Error(`Git service API does not expose label.${feature}`)
+  }
+  return method as GitServiceApiMethod
+}
+
+const executeLabelCall = async (
+  method: GitServiceApiMethod,
+  owner: string,
+  repo: string,
+  pathArgs: unknown[] = [],
+  options: Record<string, unknown> = {},
+): Promise<GitServiceApiExecutionResult<unknown>> => {
+  const invocationArgs: unknown[] = [owner, repo, ...pathArgs]
+  if (Object.keys(options).length > 0) {
+    invocationArgs.push(options)
+  }
+  return method(...invocationArgs) as Promise<GitServiceApiExecutionResult<unknown>>
+}
+
+const ensureOk = (result: GitServiceApiExecutionResult<unknown>, context: string): void => {
+  if (!result.ok) {
+    throw new Error(`${context}: status=${result.status} url=${result.request.url}`)
+  }
+}
+
+export interface GitRepositoryLabel {
+  id: number | null
+  name: string
+  color: string | null
+  description: string | null
+  exclusive: boolean | null
+  url: string | null
+  raw: Record<string, unknown>
+}
+
+const normalizeRepositoryLabel = (raw: unknown): GitRepositoryLabel | null => {
+  if (!isRecord(raw)) {
+    return null
+  }
+
+  const name = toTrimmedString(raw.name)
+  if (!name) {
+    return null
+  }
+
+  const id = toPositiveInteger(raw.id ?? raw.number ?? raw.ID)
+  const color = toTrimmedString(raw.color)
+  const description = toTrimmedString(raw.description)
+  const url = toTrimmedString(raw.url ?? raw.html_url)
+  const exclusive = typeof raw.exclusive === 'boolean'
+    ? raw.exclusive
+    : typeof raw.is_exclusive === 'boolean'
+      ? raw.is_exclusive
+      : null
+
+  return {
+    id,
+    name,
+    color,
+    description,
+    exclusive,
+    url,
+    raw: { ...raw },
+  }
+}
+
+const dedupeRepositoryLabels = (labels: GitRepositoryLabel[]): GitRepositoryLabel[] => {
+  const seen = new Set<string>()
+  const unique: GitRepositoryLabel[] = []
+
+  for (const label of labels) {
+    const key = label.id !== null ? `id:${label.id}` : `name:${label.name.toLowerCase()}`
+    if (seen.has(key)) {
+      continue
+    }
+    seen.add(key)
+    unique.push(label)
+  }
+
+  return unique
+}
+
+export const extractRepositoryLabels = (raw: unknown): GitRepositoryLabel[] => {
+  if (Array.isArray(raw)) {
+    const labels = raw
+      .map((entry) => normalizeRepositoryLabel(entry))
+      .filter((entry): entry is GitRepositoryLabel => entry !== null)
+    return dedupeRepositoryLabels(labels)
+  }
+
+  if (isRecord(raw)) {
+    if (Array.isArray(raw.labels)) {
+      return extractRepositoryLabels(raw.labels)
+    }
+
+    if (Array.isArray(raw.data)) {
+      return extractRepositoryLabels(raw.data)
+    }
+  }
+
+  return []
+}
+
+const withBody = <T>(
+  result: GitServiceApiExecutionResult<unknown>,
+  body: T,
+): GitServiceApiExecutionResult<T> => ({
+  ...result,
+  body,
+})
+
+type LabelListContext = {
+  labels: GitRepositoryLabel[]
+  context: GitServiceApiExecutionResult<unknown>
+}
+
+const listRepositoryLabels = async (
+  api: GitServiceApi,
+  owner: string,
+  repo: string,
+  options: {
+    query?: Record<string, string | number | boolean>
+    allPages?: boolean
+  } = {},
+): Promise<LabelListContext> => {
+  const listMethod = resolveLabelMethod(api, 'list')
+  const labels: GitRepositoryLabel[] = []
+  const query = options.query ?? {}
+  const allPages = options.allPages ?? true
+  const paginate = allPages && query.page === undefined && query.limit === undefined
+  let page = 1
+  let context: GitServiceApiExecutionResult<unknown> | null = null
+
+  while (page <= MAX_LABEL_LIST_PAGES) {
+    const queryForCall: Record<string, string | number | boolean> = { ...query }
+    if (paginate) {
+      queryForCall.limit = LABEL_LIST_PAGE_SIZE
+      queryForCall.page = page
+    }
+
+    const requestOptions = Object.keys(queryForCall).length > 0
+      ? { query: queryForCall }
+      : {}
+
+    const result = await executeLabelCall(listMethod, owner, repo, [], requestOptions)
+    ensureOk(result, `Failed to list labels for ${owner}/${repo}`)
+    context = result
+
+    const batch = extractRepositoryLabels(result.body)
+    labels.push(...batch)
+
+    if (!paginate || batch.length < LABEL_LIST_PAGE_SIZE) {
+      break
+    }
+
+    page += 1
+  }
+
+  if (paginate && page > MAX_LABEL_LIST_PAGES) {
+    throw new Error(`Label pagination exceeded ${MAX_LABEL_LIST_PAGES} pages for ${owner}/${repo}.`)
+  }
+
+  if (!context) {
+    throw new Error(`Label listing did not execute for ${owner}/${repo}.`)
+  }
+
+  return {
+    labels: dedupeRepositoryLabels(labels),
+    context,
+  }
+}
+
+type LabelLookupContext = LabelListContext & {
+  match: GitRepositoryLabel | null
+}
+
+const findRepositoryLabelByName = async (
+  api: GitServiceApi,
+  owner: string,
+  repo: string,
+  name: string,
+  options: {
+    caseSensitive?: boolean
+  } = {},
+): Promise<LabelLookupContext> => {
+  const listed = await listRepositoryLabels(api, owner, repo, { allPages: true })
+  const caseSensitive = options.caseSensitive ?? false
+  const target = caseSensitive ? name : name.toLowerCase()
+
+  const match = listed.labels.find((label) => {
+    const candidate = caseSensitive ? label.name : label.name.toLowerCase()
+    return candidate === target
+  }) ?? null
+
+  return {
+    ...listed,
+    match,
+  }
+}
+
+const buildLabelUpsertPayload = (
+  name: string,
+  options: Record<string, unknown>,
+  mode: 'create' | 'update',
+): Record<string, unknown> => {
+  const payload: Record<string, unknown> = {}
+
+  const data = options.data
+  if (isRecord(data)) {
+    Object.assign(payload, data)
+  }
+
+  if (options.color !== undefined) payload.color = options.color
+  if (options.description !== undefined) payload.description = options.description
+  if (options.exclusive !== undefined) payload.exclusive = options.exclusive
+  if (options.isArchived !== undefined) payload.is_archived = options.isArchived
+  if (options.is_archived !== undefined) payload.is_archived = options.is_archived
+
+  if (mode === 'create') {
+    payload.name = name
+    const color = toTrimmedString(payload.color)
+    if (!color) {
+      throw new Error(`Label "${name}" requires a non-empty "color" when creating.`)
+    }
+    payload.color = color
+  } else {
+    delete payload.name
+  }
+
+  return payload
+}
+
+type GitLabelListManagedBody = {
+  total: number
+  labels: GitRepositoryLabel[]
+}
+
+type GitLabelGetByNameBody = {
+  found: boolean
+  label: GitRepositoryLabel | null
+}
+
+type GitLabelUpsertBody = {
+  action: 'created' | 'updated' | 'unchanged'
+  label: GitRepositoryLabel
+}
+
+type GitLabelDeleteByNameBody = {
+  deleted: boolean
+  label: GitRepositoryLabel | null
+}
+
+export type GitLabelManagementApi = {
+  listManaged: GitServiceApiMethod
+  getByName: GitServiceApiMethod
+  upsert: GitServiceApiMethod
+  deleteByName: GitServiceApiMethod
+}
+
+export const createGitLabelManagementApi = (
+  api: GitServiceApi,
+  defaults: GitLabelManagementDefaults = {},
+): GitLabelManagementApi => {
+  return {
+    listManaged: async (
+      ownerOrOptions?: unknown,
+      repoOrOptions?: unknown,
+      maybeOptions?: unknown,
+    ): Promise<GitServiceApiExecutionResult<GitLabelListManagedBody>> => {
+      const scope = normalizeScopeArgs(ownerOrOptions, repoOrOptions, maybeOptions)
+      const { owner, repo } = resolveOwnerRepo(scope, defaults)
+      const allPages = toBoolean(scope.options.allPages, true)
+      const query = toQueryRecord(scope.options.query)
+
+      const listed = await listRepositoryLabels(api, owner, repo, { allPages, query })
+      return withBody(listed.context, {
+        total: listed.labels.length,
+        labels: listed.labels,
+      })
+    },
+
+    getByName: async (
+      labelName: unknown,
+      ownerOrOptions?: unknown,
+      repoOrOptions?: unknown,
+      maybeOptions?: unknown,
+    ): Promise<GitServiceApiExecutionResult<GitLabelGetByNameBody>> => {
+      const parsed = normalizeNamedScopeArgs(labelName, ownerOrOptions, repoOrOptions, maybeOptions)
+      const { owner, repo } = resolveOwnerRepo(parsed, defaults)
+      const caseSensitive = toBoolean(parsed.options.caseSensitive, false)
+
+      const lookup = await findRepositoryLabelByName(api, owner, repo, parsed.name, { caseSensitive })
+      return withBody(lookup.context, {
+        found: lookup.match !== null,
+        label: lookup.match,
+      })
+    },
+
+    upsert: async (
+      labelName: unknown,
+      ownerOrOptions?: unknown,
+      repoOrOptions?: unknown,
+      maybeOptions?: unknown,
+    ): Promise<GitServiceApiExecutionResult<GitLabelUpsertBody>> => {
+      const parsed = normalizeNamedScopeArgs(labelName, ownerOrOptions, repoOrOptions, maybeOptions)
+      const { owner, repo } = resolveOwnerRepo(parsed, defaults)
+      const caseSensitive = toBoolean(parsed.options.caseSensitive, false)
+
+      const lookup = await findRepositoryLabelByName(api, owner, repo, parsed.name, { caseSensitive })
+      if (lookup.match) {
+        const payload = buildLabelUpsertPayload(parsed.name, parsed.options, 'update')
+        if (Object.keys(payload).length === 0) {
+          return withBody(lookup.context, {
+            action: 'unchanged',
+            label: lookup.match,
+          })
+        }
+
+        if (lookup.match.id === null) {
+          throw new Error(`Label "${parsed.name}" does not expose an id and cannot be updated.`)
+        }
+
+        const editMethod = resolveLabelMethod(api, 'edit')
+        const result = await executeLabelCall(editMethod, owner, repo, [lookup.match.id], { data: payload })
+        ensureOk(result, `Failed to update label "${parsed.name}" in ${owner}/${repo}`)
+
+        const updated = normalizeRepositoryLabel(result.body)
+        if (!updated) {
+          throw new Error(`Update label response invalid for "${parsed.name}" in ${owner}/${repo}.`)
+        }
+
+        return withBody(result, {
+          action: 'updated',
+          label: updated,
+        })
+      }
+
+      const payload = buildLabelUpsertPayload(parsed.name, parsed.options, 'create')
+      const createMethod = resolveLabelMethod(api, 'create')
+      const result = await executeLabelCall(createMethod, owner, repo, [], { data: payload })
+      ensureOk(result, `Failed to create label "${parsed.name}" in ${owner}/${repo}`)
+
+      const created = normalizeRepositoryLabel(result.body)
+      if (!created) {
+        throw new Error(`Create label response invalid for "${parsed.name}" in ${owner}/${repo}.`)
+      }
+
+      return withBody(result, {
+        action: 'created',
+        label: created,
+      })
+    },
+
+    deleteByName: async (
+      labelName: unknown,
+      ownerOrOptions?: unknown,
+      repoOrOptions?: unknown,
+      maybeOptions?: unknown,
+    ): Promise<GitServiceApiExecutionResult<GitLabelDeleteByNameBody>> => {
+      const parsed = normalizeNamedScopeArgs(labelName, ownerOrOptions, repoOrOptions, maybeOptions)
+      const { owner, repo } = resolveOwnerRepo(parsed, defaults)
+      const strict = toBoolean(parsed.options.strict, false)
+      const caseSensitive = toBoolean(parsed.options.caseSensitive, false)
+
+      const lookup = await findRepositoryLabelByName(api, owner, repo, parsed.name, { caseSensitive })
+      if (!lookup.match) {
+        if (strict) {
+          throw new Error(`Label "${parsed.name}" was not found in ${owner}/${repo}.`)
+        }
+
+        return withBody(lookup.context, {
+          deleted: false,
+          label: null,
+        })
+      }
+
+      if (lookup.match.id === null) {
+        throw new Error(`Label "${parsed.name}" does not expose an id and cannot be deleted.`)
+      }
+
+      const deleteMethod = resolveLabelMethod(api, 'delete')
+      const result = await executeLabelCall(deleteMethod, owner, repo, [lookup.match.id])
+      ensureOk(result, `Failed to delete label "${parsed.name}" in ${owner}/${repo}`)
+
+      return withBody(result, {
+        deleted: true,
+        label: lookup.match,
+      })
+    },
+  }
+}
+
+const ensureNamespace = (root: GitServiceApi, path: string[]): GitServiceApi => {
+  let cursor: GitServiceApi = root
+  for (const segment of path) {
+    const current = cursor[segment]
+    if (!isRecord(current)) {
+      cursor[segment] = {}
+    }
+    cursor = cursor[segment] as GitServiceApi
+  }
+  return cursor
+}
+
+export const attachGitLabelManagementApi = (
+  api: GitServiceApi,
+  defaults: GitLabelManagementDefaults = {},
+): void => {
+  const methods = createGitLabelManagementApi(api, defaults)
+  const targets = [
+    ensureNamespace(api, ['label']),
+    ensureNamespace(api, ['repo', 'label']),
+  ]
+
+  for (const target of targets) {
+    for (const [name, method] of Object.entries(methods)) {
+      if (!(name in target)) {
+        target[name] = method
+      }
+    }
+  }
+}
+

package/src/platform/config.ts

@@ -1,6 +1,3 @@
-import { existsSync, readFileSync } from 'node:fs'
-import { dirname, join } from 'node:path'
-
 export type PlatformName = 'GITEA' | 'GITHUB'
 
 export interface GitPlatformConfig {
@@ -11,79 +8,9 @@ export interface GitPlatformConfig {
   giteaSwaggerPath?: string
 }
 
-interface DotEnv {
-  [key: string]: string
-}
-
-const DEFAULT_GITEA_HOST = 'https://gitea.example.com'
 const DEFAULT_PLATFORM: PlatformName = 'GITEA'
 const DEFAULT_GITEA_SWAGGER_PATH = '/swagger.v1.json'
 
-const parseLine = (line: string): [string, string] | null => {
-  const trimmed = line.trim()
-  if (!trimmed || trimmed.startsWith('#')) {
-    return null
-  }
-
-  const index = trimmed.indexOf('=')
-  if (index < 0) {
-    return null
-  }
-
-  const key = trimmed.slice(0, index).trim()
-  const rawValue = trimmed.slice(index + 1).trim()
-  if (!key) {
-    return null
-  }
-
-  if (rawValue.length >= 2 && rawValue.startsWith('"') && rawValue.endsWith('"')) {
-    return [key, rawValue.slice(1, -1)]
-  }
-
-  if (rawValue.length >= 2 && rawValue.startsWith("'") && rawValue.endsWith("'")) {
-    return [key, rawValue.slice(1, -1)]
-  }
-
-  return [key, rawValue]
-}
-
-const readDotEnv = (filePath: string): DotEnv => {
-  if (!existsSync(filePath)) {
-    return {}
-  }
-
-  const env: DotEnv = {}
-
-  const contents = readFileSync(filePath, 'utf8')
-  for (const line of contents.split(/\r?\n/)) {
-    const parsed = parseLine(line)
-    if (!parsed) {
-      continue
-    }
-
-    const [key, value] = parsed
-    env[key] = value
-  }
-
-  return env
-}
-
-const searchDotEnv = (): DotEnv => {
-  const candidates = [
-    join(process.cwd(), '.env'),
-    join(dirname(process.cwd()), '.env'),
-  ]
-
-  for (const candidate of candidates) {
-    const values = readDotEnv(candidate)
-    if (Object.keys(values).length > 0) {
-      return values
-    }
-  }
-
-  return {}
-}
-
 const normalizePlatform = (value?: string): PlatformName => {
   const platform = (value ?? '').toUpperCase()
   if (platform === 'GITEA') {
@@ -98,41 +25,36 @@ const normalizePlatform = (value?: string): PlatformName => {
 }
 
 export const getGitPlatformConfig = (overrides: Partial<GitPlatformConfig> = {}): GitPlatformConfig => {
-  const env = searchDotEnv()
-
   const platform = normalizePlatform(
     overrides.platform ??
       process.env.PLATFORM ??
-      process.env.GIT_PLATFORM ??
-      env.PLATFORM ??
-      env.GIT_PLATFORM,
+      process.env.GIT_PLATFORM,
   )
 
   const giteaHost =
     overrides.giteaHost ??
-    process.env.GITEA_HOST ??
-    env.GITEA_HOST ??
-    DEFAULT_GITEA_HOST
+    process.env.GITEA_HOST
 
   const giteaToken =
     overrides.giteaToken ??
-    process.env.GITEA_TOKEN ??
-    env.GITEA_TOKEN
+    process.env.GITEA_TOKEN
 
   const giteaApiVersion =
     overrides.giteaApiVersion ??
-    process.env.GITEA_API_VERSION ??
-    env.GITEA_API_VERSION
+    process.env.GITEA_API_VERSION
 
   const giteaSwaggerPath =
     overrides.giteaSwaggerPath ??
     process.env.GITEA_SWAGGER_PATH ??
-    env.GITEA_SWAGGER_PATH ??
     DEFAULT_GITEA_SWAGGER_PATH
 
+  if (!giteaHost || giteaHost.trim().length === 0) {
+    throw new Error('GITEA_HOST is required. Set process.env.GITEA_HOST or pass config.giteaHost explicitly.')
+  }
+
   return {
     platform,
-    giteaHost,
+    giteaHost: giteaHost.trim(),
     giteaToken,
     giteaApiVersion,
     giteaSwaggerPath,