@aifabrix/builder 2.49.2 → 2.50.0

package/lib/programmatic/openapi-schema-descriptions-certify.js

@@ -0,0 +1,139 @@
+/**
+ * OpenAPI schema descriptions — certify, lifecycle, governance, trust.
+ *
+ * @fileoverview Request/result models for certification routes
+ * @author AI Fabrix Team
+ * @version 1.0.0
+ */
+
+'use strict';
+
+/** @type {Record<string, Object>} */
+const CERTIFY_SCHEMA_DESCRIPTIONS = {
+  CertifyRequest: {
+    _schema: 'Optional flags for certification pillar commands.',
+    noPublish: 'When true, skip publishing local files before verify commands.',
+    pack: 'Governance scenario pack key for verify-governance.',
+    lifecycleBody: 'Optional subject and dry-run options when pillar is lifecycle-run.'
+  },
+  LifecycleRunRequest: {
+    _schema: 'Options for lifecycle-run certification pillar.',
+    subjectEmail: 'Email of the subject user for lifecycle scenarios.',
+    dryRun: 'When true, execute lifecycle checks without persisting outcomes.'
+  },
+  CertificationSummary: {
+    _schema: 'Certification level and readiness status from Dataplane lifecycle.',
+    level: 'Certification tier (BRONZE through PLATINUM or NONE).',
+    status: 'Readiness label (e.g. AI_READY, NOT_CERTIFIED).'
+  },
+  OperationsCheckDetail: {
+    _schema: 'Single operational readiness check from verify-operations.',
+    key: 'Check identifier or rule key.',
+    passed: 'True when this check passed.',
+    message: 'Human-readable check outcome message.'
+  },
+  OperationsStepResult: {
+    _schema: 'Result of one step in the verify-operations ladder.',
+    step: 'Step name or command label.',
+    success: 'True when the step completed successfully.',
+    error: 'Error detail when success is false.'
+  },
+  CertifyOperationsResultData: {
+    _schema: 'verify-operations pillar result with readiness percentage.',
+    command: 'Always verify-operations for this variant.',
+    systemKey: 'Integration system key certified.',
+    verdict: 'Lifecycle verdict for operations pillar.',
+    operationalReadinessPercent: 'Operational readiness score 0–100.',
+    certification: 'Certification level and status summary.',
+    warnings: 'Non-blocking operational warnings.',
+    details: 'Per-check operational readiness details.',
+    stepResults: 'Ordered step outcomes for the operations ladder.'
+  },
+  TrustDatasourceRow: {
+    _schema: 'Trust verification row for one datasource from verify-trust.',
+    datasourceKey: 'Datasource key evaluated.',
+    verdict: 'Trust verdict for this datasource.',
+    trustDecision: 'Trust decision label from Dataplane.',
+    validationStatus: 'Validation status string from trust checks.',
+    error: 'Error detail when verdict is not VERIFIED.'
+  },
+  CertifyTrustResultData: {
+    _schema: 'verify-trust pillar result with AI trust percentages.',
+    command: 'Always verify-trust for this variant.',
+    systemKey: 'Integration system key certified.',
+    verdict: 'Aggregate trust verdict.',
+    aiTrustPercent: 'AI trust score 0–100, or null when not computed.',
+    accessConfidencePercent: 'Access confidence score, or null when not computed.',
+    businessConfidencePercent: 'Business confidence score, or null when not computed.',
+    findings: 'Trust findings and recommendations.',
+    datasourceRows: 'Per-datasource trust outcomes.'
+  },
+  GovernanceScenarioCount: {
+    _schema: 'Passed vs total governance enforcement scenarios.',
+    passed: 'Number of scenarios that passed.',
+    total: 'Total scenarios executed.'
+  },
+  GovernanceDatasourceRow: {
+    _schema: 'Governance verification row for one datasource.',
+    datasourceKey: 'Datasource key evaluated.',
+    verdict: 'Governance verdict for this datasource.',
+    policyCoveragePercent: 'Policy coverage percentage, or null when unavailable.',
+    dimensionCoveragePercent: 'Dimension coverage percentage, or null when unavailable.',
+    scenarios: 'Passed and total enforcement scenario counts.'
+  },
+  CertifyGovernanceResultData: {
+    _schema: 'verify-governance pillar result with policy and dimension coverage.',
+    command: 'Always verify-governance for this variant.',
+    systemKey: 'Integration system key certified.',
+    verdict: 'Aggregate governance verdict.',
+    policyCoveragePercent: 'System-level policy coverage percentage.',
+    dimensionCoveragePercent: 'System-level dimension coverage percentage.',
+    enforcementScenarios: 'Aggregate scenario pass counts.',
+    datasourceRows: 'Per-datasource governance outcomes.'
+  },
+  LifecycleRunStep: {
+    _schema: 'One pillar executed during lifecycle-run.',
+    pillar: 'Pillar name (operations, trust, governance, etc.).',
+    success: 'True when this pillar run succeeded.',
+    error: 'Error detail when success is false.'
+  },
+  LifecycleRunReport: {
+    _schema: 'Summary report embedded in lifecycle-run results.',
+    systemKey: 'Integration system key.',
+    certification: 'Certification level and status after lifecycle-run.'
+  },
+  CertifyLifecycleRunResultData: {
+    _schema: 'lifecycle-run pillar result executing multiple certification pillars.',
+    report: 'Lifecycle certification report summary.',
+    stepsRun: 'Ordered list of pillars executed and their outcomes.'
+  },
+  CertifyResultData: {
+    _schema: 'Discriminated union of certification pillar results (see command field).'
+  },
+  LifecycleReportData: {
+    _schema: 'Lifecycle report fetched from Dataplane for a systemKey.',
+    systemKey: 'Integration system key.',
+    certification: 'Current certification level and status.',
+    operationalReadinessPercent: 'Operational readiness when included in report.',
+    summary: 'True when response is summary-only.',
+    details: 'True when detailed sections are included.'
+  },
+  CertifyResultResponse: {
+    _schema: '200 response envelope for runCertifyPillar.',
+    success: 'Always true for successful builder-api JSON responses.',
+    data: 'Typed payload; see CertifyResultData.',
+    correlationId: 'UUID correlating logs for this request.',
+    requestId: 'Optional per-request UUID when emitted by the server.'
+  },
+  LifecycleReportResponse: {
+    _schema: '200 response envelope for getLifecycleReport.',
+    success: 'Always true for successful builder-api JSON responses.',
+    data: 'Typed payload; see LifecycleReportData.',
+    correlationId: 'UUID correlating logs for this request.',
+    requestId: 'Optional per-request UUID when emitted by the server.'
+  }
+};
+
+module.exports = {
+  CERTIFY_SCHEMA_DESCRIPTIONS
+};

package/lib/programmatic/openapi-schema-descriptions-core.js

@@ -0,0 +1,159 @@
+/**
+ * OpenAPI schema descriptions — core types, workspace, health, errors, envelopes.
+ *
+ * @fileoverview `_schema` = component description; property values = field descriptions
+ * @author AI Fabrix Team
+ * @version 1.0.0
+ */
+
+'use strict';
+
+/** @type {Record<string, Object>} */
+const CORE_SCHEMA_DESCRIPTIONS = {
+  SystemKey: {
+    _schema: 'External integration system key (lowercase alphanumeric, hyphen, underscore).'
+  },
+  CertifyPillar: {
+    _schema: 'Certification pillar: operations, trust, governance, or lifecycle-run.'
+  },
+  TestRunType: {
+    _schema: 'Test ladder stage: unit (local files), integration (Dataplane pipeline), or e2e (live APIs).'
+  },
+  RepositorySyncDirection: {
+    _schema: 'Repository sync direction: pull remote into workspace or push workspace to remote.'
+  },
+  ProblemDetails: {
+    _schema: 'RFC 7807 problem response for builder-api errors (application/problem+json).',
+    type: 'Problem type URI or identifier.',
+    title: 'Short human-readable error title.',
+    status: 'HTTP status code echoed in the body.',
+    detail: 'Actionable error detail safe for operators and agents.',
+    instance: 'Request path or instance identifier.',
+    correlationId: 'Correlation id for log lookup across services.',
+    errors: 'Field-level validation errors when status is 400.'
+  },
+  ProblemValidationError: {
+    _schema: 'Single field validation error inside ProblemDetails.errors.',
+    field: 'JSON pointer or field name that failed validation.',
+    message: 'Validation failure message.',
+    value: 'Rejected value when safe to echo (may be omitted for secrets).'
+  },
+  LifecycleVerdict: {
+    _schema: 'Lifecycle verification outcome: VERIFIED, FAILED, or NOT_VERIFIED.'
+  },
+  CertificationLevel: {
+    _schema: 'Certification tier: BRONZE through PLATINUM, or NONE when uncertified.'
+  },
+  CertificationStatus: {
+    _schema: 'Readiness label derived from certification level and pillar results.'
+  },
+  WorkspaceMeta: {
+    _schema: 'Persisted workspace metadata for one integration systemKey.',
+    ownerUserId: 'Authenticated user id owning the workspace folder.',
+    systemKey: 'Integration system key for this workspace.',
+    createdAt: 'ISO timestamp when the workspace was first created.',
+    lastModifiedAt: 'ISO timestamp of the last mutating workspace operation.',
+    lastOperation: 'Handler id or label of the last completed operation.',
+    lastUploadId: 'Dataplane upload id from the last successful dev publish, if any.'
+  },
+  WorkspaceSystemSummary: {
+    _schema: 'Summary row for one system in the user workspace list.',
+    systemKey: 'Integration system key.',
+    meta: 'Workspace metadata when the folder exists; null when only the key is reserved.'
+  },
+  WorkspaceManifestFileEntry: {
+    _schema: 'One file or directory entry in the workspace manifest listing.',
+    path: 'Relative path from the integration workspace root.',
+    isDirectory: 'True when the entry is a directory.',
+    sizeBytes: 'File size in bytes; omitted or zero for directories.',
+    redacted: 'True when content is omitted from listings for sensitivity.'
+  },
+  ListSystemsData: {
+    _schema: 'Payload for listSystems: integration keys under the authenticated user.',
+    systems: 'Workspace summaries ordered by systemKey.'
+  },
+  CreateSystemData: {
+    _schema: 'Payload after createSystem: new workspace folder and metadata.',
+    systemKey: 'Created integration system key.',
+    meta: 'Initial workspace metadata including owner and timestamps.'
+  },
+  SystemManifestData: {
+    _schema: 'Local workspace manifest: metadata plus file listing for one systemKey.',
+    systemKey: 'Integration system key.',
+    meta: 'Workspace metadata; null if folder exists but meta file is missing.',
+    files: 'Recursive file manifest under the integration workspace.'
+  },
+  DeleteSystemData: {
+    _schema: 'Confirmation payload after deleteSystem removes the local workspace.',
+    systemKey: 'Deleted integration system key.',
+    deleted: 'Always true when the workspace folder was removed.'
+  },
+  HealthData: {
+    _schema: 'Liveness probe payload when the builder-api process is running.',
+    status: 'Always ok for successful liveness checks.'
+  },
+  ReadyData: {
+    _schema: 'Readiness probe payload; does not verify Dataplane connectivity in V1.',
+    status: 'Always ready when the service accepts traffic.',
+    dataplaneUrl: 'Configured dev Dataplane base URL, or null when unset.'
+  },
+  EmptyResultData: {
+    _schema: 'Empty data object for operations with no structured payload.'
+  },
+  EmptyRequestBody: {
+    _schema: 'Optional empty JSON body for routes that accept {}.'
+  },
+  ListSystemsResponse: {
+    _schema: '200 response envelope for listSystems.',
+    success: 'Always true for successful builder-api JSON responses.',
+    data: 'Typed payload; see ListSystemsData.',
+    correlationId: 'UUID correlating logs for this request.',
+    requestId: 'Optional per-request UUID when emitted by the server.'
+  },
+  CreateSystemResponse: {
+    _schema: '200 response envelope for createSystem.',
+    success: 'Always true for successful builder-api JSON responses.',
+    data: 'Typed payload; see CreateSystemData.',
+    correlationId: 'UUID correlating logs for this request.',
+    requestId: 'Optional per-request UUID when emitted by the server.'
+  },
+  SystemManifestResponse: {
+    _schema: '200 response envelope for getSystemManifest.',
+    success: 'Always true for successful builder-api JSON responses.',
+    data: 'Typed payload; see SystemManifestData.',
+    correlationId: 'UUID correlating logs for this request.',
+    requestId: 'Optional per-request UUID when emitted by the server.'
+  },
+  DeleteSystemResponse: {
+    _schema: '200 response envelope for deleteSystem.',
+    success: 'Always true for successful builder-api JSON responses.',
+    data: 'Typed payload; see DeleteSystemData.',
+    correlationId: 'UUID correlating logs for this request.',
+    requestId: 'Optional per-request UUID when emitted by the server.'
+  },
+  HealthResponse: {
+    _schema: '200 response envelope for GET /health (no authentication).',
+    success: 'Always true for successful builder-api JSON responses.',
+    data: 'Typed payload; see HealthData.',
+    correlationId: 'UUID correlating logs for this request.',
+    requestId: 'Optional per-request UUID when emitted by the server.'
+  },
+  ReadyResponse: {
+    _schema: '200 response envelope for GET /health/ready.',
+    success: 'Always true for successful builder-api JSON responses.',
+    data: 'Typed payload; see ReadyData.',
+    correlationId: 'UUID correlating logs for this request.',
+    requestId: 'Optional per-request UUID when emitted by the server.'
+  },
+  EmptyResultResponse: {
+    _schema: '200 response envelope when data is an empty object.',
+    success: 'Always true for successful builder-api JSON responses.',
+    data: 'Empty object when no structured result is returned.',
+    correlationId: 'UUID correlating logs for this request.',
+    requestId: 'Optional per-request UUID when emitted by the server.'
+  }
+};
+
+module.exports = {
+  CORE_SCHEMA_DESCRIPTIONS
+};

package/lib/programmatic/openapi-schema-descriptions-help.js

@@ -0,0 +1,40 @@
+/**
+ * OpenAPI schema descriptions for builder-api help models (plan 154.5).
+ *
+ * @fileoverview MCP-friendly help schema descriptions
+ * @author AI Fabrix Team
+ * @version 1.0.0
+ */
+
+'use strict';
+
+/** @type {Record<string, Object>} */
+const HELP_SCHEMA_DESCRIPTIONS = Object.freeze({
+  BuilderHelpTopic: {
+    _schema:
+      'Help topic enum: overview, sections, section, dependencyGraph, repairRules, workflow, schemaCatalog, subscriptionGuide, cipOverview, goldenExamples, goldenExample, evidencePatterns, evidencePattern.'
+  },
+  BuilderHelpData: {
+    _schema: 'Deterministic LLM help payload for one topic (read-only product documentation).',
+    version: 'Help content release id (bump when topics or fixtures change).',
+    schemaVersion: 'Envelope and fixture JSON schema version.',
+    topic: 'Topic that produced this payload.',
+    key: 'Primary identifier (sectionKey, exampleKey, or topic name).',
+    title: 'Human-readable title for the topic payload.',
+    summary: 'Short summary suitable for MCP tool preambles.',
+    data: 'Topic-specific structured content (sections, graph, hooks, examples, or prose).',
+    related: 'Related help topic enum values (no URLs).',
+    recommendedNext: 'Suggested next help topics for agent bootstrap.'
+  },
+  BuilderHelpResponse: {
+    _schema: '200 response envelope for GET /help (no authentication).',
+    success: 'Always true for successful builder-api JSON responses.',
+    data: 'Typed payload; see BuilderHelpData.',
+    correlationId: 'UUID correlating logs for this request.',
+    requestId: 'Optional per-request UUID when emitted by the server.'
+  }
+});
+
+module.exports = {
+  HELP_SCHEMA_DESCRIPTIONS
+};

package/lib/programmatic/openapi-schema-descriptions-manifest.js

@@ -0,0 +1,143 @@
+/**
+ * OpenAPI schema descriptions — governed manifest section editing.
+ *
+ * @fileoverview Request/result models for manifest get/patch/repair routes
+ * @author AI Fabrix Team
+ * @version 1.0.0
+ */
+
+'use strict';
+
+/** @type {Record<string, Object>} */
+const MANIFEST_SCHEMA_DESCRIPTIONS = {
+  SectionKey: {
+    _schema: 'Governed manifest section key (e.g. datasource.metadata, system.basics).'
+  },
+  DatasourceKey: {
+    _schema: 'Datasource key within the external system workspace.'
+  },
+  MissingInput: {
+    _schema: 'Field the agent must ask the user for before patching (do not guess).',
+    field: 'Field name requiring user input.',
+    question: 'Question to ask the user verbatim.',
+    required: 'When true, AI must not guess — ask user first.'
+  },
+  SectionQuality: {
+    _schema: 'Deterministic quality assessment for a manifest section.',
+    score: 'Quality score 0–100 from rule-based checks.',
+    blockingIssues: {
+      _schema: 'Issues that block safe patch or upload.',
+      _arrayItems: {
+        severity: 'Issue severity (error, warning, info).',
+        message: 'Human-readable blocking issue description.'
+      }
+    },
+    warnings: 'Non-blocking quality warnings.',
+    missingInputs: 'Fields requiring explicit user input before patching.',
+    assumptions: 'Assumptions recorded during quality scoring.'
+  },
+  ManifestPatchSectionRequest: {
+    _schema: 'Governed patch body; requires prior GET sectionReadToken.',
+    intent: 'Why this patch is made — audit and repair hints.',
+    patch: 'Section-scoped merge or replace payload.',
+    mode: 'Merge into existing section value or replace entirely.',
+    sectionReadToken: 'Token from prior GET; stale token returns 409.',
+    dryRun: 'Validate patch without writing files.'
+  },
+  ManifestRepairRequest: {
+    _schema: 'Run named repair hooks after section patches.',
+    hooks: 'Repair hook names to execute in dependency order.',
+    sectionKey: 'Optional section context for targeted repair.',
+    datasourceKey: 'Optional datasource context when repairing datasource sections.',
+    dryRun: 'Preview hook execution without writing files.',
+    auth: 'Optional auth repair mode passed to repair command.'
+  },
+  ManifestSectionViewData: {
+    _schema: 'Governed section view for LLM/MCP editing workflows.',
+    sectionKey: 'Section key for this view.',
+    target: 'Whether the section applies to system or datasource scope.',
+    datasourceKey: 'Datasource key when target is datasource; null for system sections.',
+    currentValue: 'Current JSON value for the section.',
+    schemaFragment: 'JSON Schema fragment describing allowed shape.',
+    required: 'True when the section must be present for validation.',
+    mutable: 'True when PATCH is allowed for this section.',
+    sourceOfTruth: 'True when this section is authoritative over derived files.',
+    dependencyGraph: {
+      _schema: 'Downstream sections affected by changes to this section.',
+      downstreamFromThis: 'Section keys that may need repair after patching.'
+    },
+    repairHooks: 'Suggested repair hook names after patch.',
+    recommendedNextActions: 'Agent-facing next steps (validate, repair, ask user).',
+    sectionReadToken: 'Opaque token required for PATCH; obtained from this GET.',
+    quality: 'Deterministic quality score and blocking issues.'
+  },
+  ManifestPatchResultData: {
+    _schema: 'Result after governed section patch.',
+    sectionKey: 'Patched section key.',
+    datasourceKey: 'Datasource key when a datasource section was patched.',
+    intent: 'Echo of the patch intent from the request.',
+    changedPaths: 'JSON pointer paths modified by the patch.',
+    beforeHash: 'Content hash before patch.',
+    afterHash: 'Content hash after patch.',
+    derivedSectionsAffected: 'Section keys invalidated or updated downstream.',
+    repairRecommended: 'True when repair hooks should run next.',
+    repairHooks: 'Repair hook names recommended after this patch.',
+    validationPreview: 'Inline validation preview object when dryRun or post-patch.',
+    riskHints: 'Risk hints for agents (governance, auth, exposure).',
+    nextActions: 'Suggested next API calls or user questions.',
+    dryRun: 'True when no files were written.',
+    quality: 'Updated quality assessment for the section.'
+  },
+  ManifestSectionsListData: {
+    _schema: 'Catalog of governed sections and datasource keys for a systemKey.',
+    systemKey: 'Integration system key.',
+    sections: {
+      _schema: 'Governed sections available for GET/PATCH.',
+      _arrayItems: {
+        sectionKey: 'Section key identifier.',
+        target: 'system or datasource scope for this section.'
+      }
+    },
+    datasourceKeys: 'Datasource keys present in the workspace.'
+  },
+  ManifestRepairResultData: {
+    _schema: 'Result after manifest repair hooks execute.',
+    hooksRun: 'Repair hooks that were executed.',
+    derivedSectionsUpdated: 'Section keys refreshed by repair.',
+    repairResult: 'Opaque repair command result object.',
+    dryRun: 'True when hooks were previewed only.',
+    quality: 'Optional aggregate quality after repair; null when not computed.'
+  },
+  ManifestSectionViewResponse: {
+    _schema: '200 response envelope for getManifestSection / getDatasourceManifestSection.',
+    success: 'Always true for successful builder-api JSON responses.',
+    data: 'Typed payload; see ManifestSectionViewData.',
+    correlationId: 'UUID correlating logs for this request.',
+    requestId: 'Optional per-request UUID when emitted by the server.'
+  },
+  ManifestPatchResultResponse: {
+    _schema: '200 response envelope for patchManifestSection / patchDatasourceManifestSection.',
+    success: 'Always true for successful builder-api JSON responses.',
+    data: 'Typed payload; see ManifestPatchResultData.',
+    correlationId: 'UUID correlating logs for this request.',
+    requestId: 'Optional per-request UUID when emitted by the server.'
+  },
+  ManifestSectionsListResponse: {
+    _schema: '200 response envelope for listManifestSections.',
+    success: 'Always true for successful builder-api JSON responses.',
+    data: 'Typed payload; see ManifestSectionsListData.',
+    correlationId: 'UUID correlating logs for this request.',
+    requestId: 'Optional per-request UUID when emitted by the server.'
+  },
+  ManifestRepairResultResponse: {
+    _schema: '200 response envelope for runManifestRepair.',
+    success: 'Always true for successful builder-api JSON responses.',
+    data: 'Typed payload; see ManifestRepairResultData.',
+    correlationId: 'UUID correlating logs for this request.',
+    requestId: 'Optional per-request UUID when emitted by the server.'
+  }
+};
+
+module.exports = {
+  MANIFEST_SCHEMA_DESCRIPTIONS
+};

package/lib/programmatic/openapi-schema-descriptions-mcp.js

@@ -0,0 +1,118 @@
+/**
+ * OpenAPI schema descriptions — Enterprise MCP, repository, template, workspace remote.
+ *
+ * @fileoverview Request/result models for MCP-delegated routes
+ * @author AI Fabrix Team
+ * @version 1.0.0
+ */
+
+'use strict';
+
+/** @type {Record<string, Object>} */
+const MCP_SCHEMA_DESCRIPTIONS = {
+  TemplateMaterializeRequest: {
+    _schema: 'Materialize workspace files from an Enterprise MCP template.',
+    templateKey: 'Template identifier registered in Enterprise MCP.',
+    params: 'Optional branch and path filters for materialization.'
+  },
+  TemplateMaterializeParams: {
+    _schema: 'Optional parameters for template.materializeWorkspace.',
+    branch: 'Git branch or template branch to materialize from.',
+    paths: 'Restrict materialization to these workspace-relative paths.'
+  },
+  WorkspaceDiffRequest: {
+    _schema: 'Compare local workspace draft against a baseline via Enterprise MCP.',
+    baseline: 'Baseline label (e.g. remote, template, last-upload).',
+    paths: 'Optional path filter for the diff operation.'
+  },
+  WorkspaceResetRequest: {
+    _schema: 'Reset workspace from template via Enterprise MCP workspace.resetFromTemplate.',
+    templateKey: 'Template to reset from; defaults when omitted.',
+    confirm: 'Must be true to execute destructive reset.'
+  },
+  RepositorySyncRequest: {
+    _schema: 'Sync workspace with remote repository via Enterprise MCP repository.sync.',
+    direction: 'Pull remote changes or push local workspace.',
+    branch: 'Target branch for sync.',
+    paths: 'Optional path filter for partial sync.',
+    commitMessage: 'Commit message when direction is push.'
+  },
+  RepositoryCreateReviewRequest: {
+    _schema: 'Create or update a code review via Enterprise MCP repository.createReview.',
+    title: 'Review title (PR title or provider equivalent).',
+    body: 'Review description body.',
+    sourceBranch: 'Branch containing changes.',
+    targetBranch: 'Merge target branch.',
+    draft: 'When true, create as draft review.'
+  },
+  RepositoryDispatchPipelineRequest: {
+    _schema: 'Dispatch CI/CD workflow via Enterprise MCP repository.dispatchPipeline.',
+    workflow: 'Workflow file name or id to dispatch.',
+    ref: 'Git ref (branch or tag) to run the workflow on.',
+    inputs: 'Optional workflow inputs key-value map.'
+  },
+  RepositoryPipelineInputs: {
+    _schema: 'Named inputs passed to the dispatched pipeline workflow.',
+    environment: 'Target deployment environment input.',
+    ref: 'Git ref override input for the workflow.'
+  },
+  EnterpriseMcpToolOutput: {
+    _schema: 'Normalized result object from an Enterprise MCP tool invocation.',
+    success: 'True when the MCP tool reported success.',
+    status: 'Provider-specific status string.',
+    message: 'Human-readable outcome message.',
+    branch: 'Branch name affected by the operation.',
+    pullRequestUrl: 'URL to created or updated review when applicable.',
+    syncDirection: 'Pull or push when the tool was repository.sync.',
+    commitSha: 'Resulting commit SHA after sync or push.',
+    workflowRunId: 'CI workflow run id after dispatchPipeline.'
+  },
+  WorkspaceRemoteUnavailable: {
+    _schema: 'Placeholder when Enterprise MCP workspace.status is unavailable.',
+    unavailable: 'Always true for this variant.',
+    message: 'Reason remote status could not be fetched.'
+  },
+  WorkspaceRemoteStatus: {
+    _schema: 'Remote workspace status from MCP, unavailable marker, or null.'
+  },
+  EnterpriseMcpInvocationData: {
+    _schema: 'Wrapper for Enterprise MCP tool results returned by builder-api.',
+    capabilityKey: 'MCP capability key that was invoked (e.g. repository.sync).',
+    result: 'Normalized MCP tool output.'
+  },
+  WorkspaceStatusData: {
+    _schema: 'Combined local manifest and optional remote workspace status.',
+    local: 'Local workspace manifest (same shape as getSystemManifest).',
+    remote: 'Enterprise MCP workspace.status result, unavailable marker, or null.'
+  },
+  RepositoryStatusData: {
+    _schema: 'Enterprise MCP repository.status result for a systemKey.',
+    capabilityKey: 'Always repository.status for this route.',
+    result: 'Normalized MCP tool output for repository status.'
+  },
+  EnterpriseMcpInvocationResponse: {
+    _schema: '200 response envelope for MCP-delegated mutating or diff routes.',
+    success: 'Always true for successful builder-api JSON responses.',
+    data: 'Typed payload; see EnterpriseMcpInvocationData.',
+    correlationId: 'UUID correlating logs for this request.',
+    requestId: 'Optional per-request UUID when emitted by the server.'
+  },
+  WorkspaceStatusResponse: {
+    _schema: '200 response envelope for getWorkspaceStatus.',
+    success: 'Always true for successful builder-api JSON responses.',
+    data: 'Typed payload; see WorkspaceStatusData.',
+    correlationId: 'UUID correlating logs for this request.',
+    requestId: 'Optional per-request UUID when emitted by the server.'
+  },
+  RepositoryStatusResponse: {
+    _schema: '200 response envelope for getRepositoryStatus.',
+    success: 'Always true for successful builder-api JSON responses.',
+    data: 'Typed payload; see RepositoryStatusData.',
+    correlationId: 'UUID correlating logs for this request.',
+    requestId: 'Optional per-request UUID when emitted by the server.'
+  }
+};
+
+module.exports = {
+  MCP_SCHEMA_DESCRIPTIONS
+};