@typeship-ax/cli 0.20.0 → 0.21.0

package/src/schemas.ts

@@ -10,55 +10,52 @@ export const SCHEMAS: Record<string, { req?: unknown; res?: unknown; params?: Re
   "generate.downloadPackage": {"res":{"type":"string"},"params":{"query.token":{"type":"string","minLength":43,"maxLength":43,"pattern":"^[A-Za-z0-9_-]{43}$"}}},
   "projects.list": {"res":{"$ref":"res:ProjectList"},"params":{"query.limit":{"type":"integer","minimum":1,"maximum":100},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"}}},
   "projects.create": {"req":{"$ref":"req:CreateProjectRequest"},"res":{"$ref":"res:Project"},"params":{"header.Idempotency-Key":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]+$"}}},
-  "projects.retrieve": {"res":{"$ref":"res:Project"},"params":{"path.project_id":{"$ref":"req:ProjectId"}}},
+  "projects.get": {"res":{"$ref":"res:Project"},"params":{"path.project_id":{"$ref":"req:ProjectId"}}},
   "projects.delete": {"res":{"$ref":"res:DeletedProject"},"params":{"path.project_id":{"$ref":"req:ProjectId"},"header.If-Match":{"type":"string","minLength":1,"maxLength":1024}}},
   "projects.update": {"req":{"$ref":"req:UpdateProjectRequest"},"res":{"$ref":"res:Project"},"params":{"path.project_id":{"$ref":"req:ProjectId"},"header.If-Match":{"type":"string","minLength":1,"maxLength":1024}}},
-  "projects.retrieveDiagnostics": {"res":{"$ref":"res:DiagnosticReport"},"params":{"path.project_id":{"$ref":"req:ProjectId"}}},
-  "projects.refreshDiagnostics": {"res":{"$ref":"res:DiagnosticReport"},"params":{"path.project_id":{"$ref":"req:ProjectId"},"header.Idempotency-Key":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]+$"}}},
-  "projects.remediateDiagnostics": {"req":{"$ref":"req:DiagnosticRemediationRequest"},"res":{"$ref":"res:DiagnosticRemediation"},"params":{"path.project_id":{"$ref":"req:ProjectId"},"header.Idempotency-Key":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]+$"}}},
-  "projects.retrieveIntegrationHealth": {"res":{"$ref":"res:RepositoryIntegrationHealth"},"params":{"path.project_id":{"$ref":"req:ProjectId"}}},
-  "projects.listGenerations": {"res":{"$ref":"res:GenerationList"},"params":{"path.project_id":{"$ref":"req:ProjectId"},"query.limit":{"type":"integer","minimum":1,"maximum":100},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"},"query.target_id":{"$ref":"req:TargetId"}}},
   "projects.generate": {"req":{"$ref":"req:GenerateProjectRequest"},"res":{"$ref":"res:GenerationBatch"},"params":{"path.project_id":{"$ref":"req:ProjectId"},"header.Idempotency-Key":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]+$"}}},
-  "definitions.retrieve": {"res":{"$ref":"res:Definition"},"params":{"path.definition_id":{"$ref":"req:DefinitionId"}}},
-  "definitions.update": {"req":{"$ref":"req:DefinitionUpdateRequest"},"res":{"$ref":"res:Definition"},"params":{"path.definition_id":{"$ref":"req:DefinitionId"},"header.If-Match":{"type":"string","minLength":1,"maxLength":1024},"header.Idempotency-Key":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]+$"}}},
-  "targets.list": {"res":{"$ref":"res:TargetList"},"params":{"path.project_id":{"$ref":"req:ProjectId"},"query.limit":{"type":"integer","minimum":1,"maximum":100},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"}}},
-  "targets.create": {"req":{"$ref":"req:TargetFields"},"res":{"$ref":"res:TargetResponse"},"params":{"path.project_id":{"$ref":"req:ProjectId"},"header.Idempotency-Key":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]+$"}}},
-  "targets.retrieve": {"res":{"$ref":"res:TargetResponse"},"params":{"path.target_id":{"$ref":"req:TargetId"}}},
+  "specs.get": {"res":{"$ref":"res:Spec"},"params":{"path.spec_id":{"$ref":"req:SpecId"}}},
+  "specs.update": {"req":{"$ref":"req:SpecUpdateRequest"},"res":{"$ref":"res:Spec"},"params":{"path.spec_id":{"$ref":"req:SpecId"},"header.If-Match":{"type":"string","minLength":1,"maxLength":1024},"header.Idempotency-Key":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]+$"}}},
+  "specs.refresh": {"res":{"$ref":"res:Spec"},"params":{"path.spec_id":{"$ref":"req:SpecId"},"header.Idempotency-Key":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]+$"}}},
+  "specRevisions.list": {"res":{"$ref":"res:SpecRevisionList"},"params":{"query.limit":{"type":"integer","minimum":1,"maximum":100},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"},"query.spec_id":{"$ref":"req:SpecId"}}},
+  "specRevisions.get": {"res":{"$ref":"res:SpecRevisionResponse"},"params":{"path.spec_revision_id":{"$ref":"req:SpecRevisionId"},"query.include":{"type":"string","enum":["diagnostics"]}}},
+  "specRevisions.listFiles": {"res":{"$ref":"res:SpecRevisionFileList"},"params":{"path.spec_revision_id":{"$ref":"req:SpecRevisionId"},"query.limit":{"type":"integer","minimum":1,"maximum":100},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"}}},
+  "targets.list": {"res":{"$ref":"res:TargetList"},"params":{"query.limit":{"type":"integer","minimum":1,"maximum":100},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"},"query.project_id":{"$ref":"req:ProjectId"}}},
+  "targets.create": {"req":{"$ref":"req:TargetCreateRequest"},"res":{"$ref":"res:TargetResponse"},"params":{"header.Idempotency-Key":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]+$"}}},
+  "targets.get": {"res":{"$ref":"res:TargetResponse"},"params":{"path.target_id":{"$ref":"req:TargetId"}}},
   "targets.delete": {"res":{"$ref":"res:DeletedTarget"},"params":{"path.target_id":{"$ref":"req:TargetId"},"header.If-Match":{"type":"string","minLength":1,"maxLength":1024}}},
   "targets.update": {"req":{"$ref":"req:TargetUpdateRequest"},"res":{"$ref":"res:TargetResponse"},"params":{"path.target_id":{"$ref":"req:TargetId"},"header.If-Match":{"type":"string","minLength":1,"maxLength":1024}}},
-  "targets.listReleases": {"res":{"$ref":"res:TargetReleaseList"},"params":{"path.target_id":{"$ref":"req:TargetId"},"query.limit":{"type":"integer","minimum":1,"maximum":100},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"}}},
-  "targets.retrieveDraft": {"res":{"$ref":"res:TargetDraftResponse"},"params":{"path.target_id":{"$ref":"req:TargetId"}}},
-  "targets.updateDraft": {"req":{"$ref":"req:TargetDraftUpdate"},"res":{"$ref":"res:TargetDraftResponse"},"params":{"path.target_id":{"$ref":"req:TargetId"},"header.If-Match":{"type":"string","minLength":1,"maxLength":1024}}},
-  "targets.adoptRelease": {"req":{"$ref":"req:TargetAdoption"},"res":{"$ref":"res:TargetReleaseResponse"},"params":{"path.target_id":{"$ref":"req:TargetId"},"header.Idempotency-Key":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]+$"}}},
-  "targets.retrieveRelease": {"res":{"$ref":"res:TargetReleaseResponse"},"params":{"path.target_release_id":{"$ref":"req:TargetReleaseId"}}},
-  "targets.republishRelease": {"res":{"$ref":"res:TargetReleaseResponse"},"params":{"path.target_release_id":{"$ref":"req:TargetReleaseId"},"header.Idempotency-Key":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]+$"}}},
-  "targets.listDraftFiles": {"res":{"$ref":"res:DraftFileList"},"params":{"path.target_id":{"$ref":"req:TargetId"},"query.filter":{"type":"string","enum":["conflicted","customized","history"]},"query.limit":{"type":"integer","minimum":1,"maximum":100},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"}}},
-  "targets.retrieveDraftFileContent": {"res":{"$ref":"res:DraftFileContentResponse"},"params":{"path.target_id":{"$ref":"req:TargetId"},"query.path":{"type":"string","minLength":1},"query.side":{"$ref":"req:DraftFileSide"},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"}}},
-  "targets.resolveDraftConflicts": {"req":{"$ref":"req:ResolveDraftConflicts"},"res":{"$ref":"res:DraftConflictResolutionResponse"},"params":{"path.target_id":{"$ref":"req:TargetId"}}},
-  "targets.discardDraftCustomizations": {"req":{"$ref":"req:DiscardDraftCustomizations"},"res":{"$ref":"res:DraftCustomizationDiscardResponse"},"params":{"path.target_id":{"$ref":"req:TargetId"}}},
-  "targets.recoverDraftHistory": {"req":{"$ref":"req:RecoverDraftHistory"},"res":{"$ref":"res:DraftHistoryRecoveryResponse"},"params":{"path.target_id":{"$ref":"req:TargetId"}}},
-  "targets.retrieveDelivery": {"res":{"$ref":"res:DeliveryResponse"},"params":{"path.delivery_id":{"$ref":"req:DeliveryId"}}},
-  "targets.retrievePublication": {"res":{"$ref":"res:PublicationResponse"},"params":{"path.publication_id":{"$ref":"req:PublicationId"}}},
-  "generations.retrieve": {"res":{"$ref":"res:GenerationResponse"},"params":{"path.generation_id":{"$ref":"req:GenerationId"}}},
-  "generations.retrieveFile": {"res":{"type":"string"},"params":{"path.generation_id":{"$ref":"req:GenerationId"},"query.path":{"type":"string"}}},
-  "definitionRevisions.list": {"res":{"$ref":"res:DefinitionRevisionList"},"params":{"path.definition_id":{"$ref":"req:DefinitionId"},"query.limit":{"type":"integer","minimum":1,"maximum":100},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"}}},
-  "definitionRevisions.retrieve": {"res":{"$ref":"res:DefinitionRevisionResponse"},"params":{"path.definition_revision_id":{"$ref":"req:DefinitionRevisionId"}}},
-  "definitionRevisions.retrieveContent": {"res":{"type":"string"},"params":{"path.definition_revision_id":{"$ref":"req:DefinitionRevisionId"}}},
-  "definitionRevisions.retrieveDocumentContent": {"res":{"type":"string"},"params":{"path.definition_revision_id":{"$ref":"req:DefinitionRevisionId"},"path.document_id":{"$ref":"req:DefinitionDocumentId"}}},
-  "definitionRevisions.retrieveDocument": {"res":{"$ref":"res:DefinitionDocumentResponse"},"params":{"path.definition_document_id":{"$ref":"req:DefinitionDocumentId"}}},
-  "account.retrieve": {"res":{"$ref":"res:Account"}},
+  "targets.adopt": {"req":{"$ref":"req:TargetAdoption"},"res":{"$ref":"res:ReleaseResponse"},"params":{"path.target_id":{"$ref":"req:TargetId"},"header.Idempotency-Key":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]+$"}}},
+  "drafts.list": {"res":{"$ref":"res:DraftList"},"params":{"query.limit":{"type":"integer","minimum":1,"maximum":100},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"},"query.target_id":{"$ref":"req:TargetId"},"query.status":{"$ref":"req:DraftStatus"}}},
+  "drafts.get": {"res":{"$ref":"res:DraftResponse"},"params":{"path.draft_id":{"$ref":"req:DraftId"}}},
+  "drafts.update": {"req":{"$ref":"req:DraftUpdateRequest"},"res":{"$ref":"res:DraftResponse"},"params":{"path.draft_id":{"$ref":"req:DraftId"},"header.If-Match":{"type":"string","minLength":1,"maxLength":1024}}},
+  "drafts.listFiles": {"res":{"$ref":"res:DraftFileList"},"params":{"path.draft_id":{"$ref":"req:DraftId"},"query.filter":{"type":"string","enum":["conflicted","customized","history"]},"query.limit":{"type":"integer","minimum":1,"maximum":100},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"}}},
+  "drafts.resolve": {"req":{"$ref":"req:DraftResolveRequest"},"res":{"$ref":"res:DraftResponse"},"params":{"path.draft_id":{"$ref":"req:DraftId"}}},
+  "drafts.recover": {"req":{"$ref":"req:DraftRecoverRequest"},"res":{"$ref":"res:DraftResponse"},"params":{"path.draft_id":{"$ref":"req:DraftId"}}},
+  "releases.list": {"res":{"$ref":"res:ReleaseList"},"params":{"query.limit":{"type":"integer","minimum":1,"maximum":100},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"},"query.target_id":{"$ref":"req:TargetId"}}},
+  "releases.get": {"res":{"$ref":"res:ReleaseResponse"},"params":{"path.release_id":{"$ref":"req:ReleaseId"}}},
+  "releases.republish": {"res":{"$ref":"res:ReleaseResponse"},"params":{"path.release_id":{"$ref":"req:ReleaseId"},"header.Idempotency-Key":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]+$"}}},
+  "deliveries.list": {"res":{"$ref":"res:DeliveryList"},"params":{"query.limit":{"type":"integer","minimum":1,"maximum":100},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"},"query.target_id":{"$ref":"req:TargetId"}}},
+  "deliveries.get": {"res":{"$ref":"res:DeliveryResponse"},"params":{"path.delivery_id":{"$ref":"req:DeliveryId"}}},
+  "publications.list": {"res":{"$ref":"res:PublicationList"},"params":{"query.limit":{"type":"integer","minimum":1,"maximum":100},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"},"query.release_id":{"$ref":"req:ReleaseId"}}},
+  "publications.get": {"res":{"$ref":"res:PublicationResponse"},"params":{"path.publication_id":{"$ref":"req:PublicationId"}}},
+  "generations.list": {"res":{"$ref":"res:GenerationList"},"params":{"query.limit":{"type":"integer","minimum":1,"maximum":100},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"},"query.project_id":{"$ref":"req:ProjectId"},"query.target_id":{"$ref":"req:TargetId"},"query.status":{"$ref":"req:GenerationStatus"}}},
+  "generations.get": {"res":{"$ref":"res:GenerationResponse"},"params":{"path.generation_id":{"$ref":"req:GenerationId"}}},
+  "generations.listFiles": {"res":{"$ref":"res:FileList"},"params":{"path.generation_id":{"$ref":"req:GenerationId"},"query.limit":{"type":"integer","minimum":1,"maximum":100},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"}}},
+  "files.get": {"res":{"$ref":"res:FileResponse"},"params":{"path.file_id":{"$ref":"req:FileId"},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"}}},
+  "organization.get": {"res":{"$ref":"res:Organization"}},
   "apiKeys.list": {"res":{"$ref":"res:ApiKeyList"},"params":{"query.limit":{"type":"integer","minimum":1,"maximum":100},"query.cursor":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^[A-Za-z0-9_-]+$"}}},
-  "apiKeys.retrieve": {"res":{"$ref":"res:ApiKeyResponse"},"params":{"path.api_key_id":{"type":"string"}}},
+  "apiKeys.get": {"res":{"$ref":"res:ApiKeyResponse"},"params":{"path.api_key_id":{"type":"string"}}},
   "apiKeys.revoke": {"res":{"$ref":"res:ApiKeyResponse"},"params":{"path.api_key_id":{"type":"string"},"header.If-Match":{"type":"string","minLength":1,"maxLength":1024}}},
 };
 
 export const DEFS: Record<string, unknown> = {
-  "req:GenerateRequest": {"type":"object","additionalProperties":false,"properties":{"definition":{"$ref":"req:DefinitionInput"},"target":{"type":"object","additionalProperties":false,"properties":{"generator":{"$ref":"req:GeneratorKind"}},"required":["generator"]},"package_name":{"type":"string"},"module_path":{"type":"string"},"go_sdk":{"$ref":"req:GoSdkDescriptor"},"config":{"$ref":"req:Config"}},"required":["definition","target"]},
-  "req:DefinitionInput": {"anyOf":[{"$ref":"req:UrlDefinitionInput"},{"$ref":"req:InlineDefinitionInput"}]},
-  "req:UrlDefinitionInput": {"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","pattern":"^https?://"},"headers":{"type":"object"}},"required":["url"]},
-  "req:InlineDefinitionInput": {"type":"object","additionalProperties":false,"properties":{"inline":{"type":"string"}},"required":["inline"]},
-  "req:GeneratorKind": {"type":"string","enum":["typescript-sdk","python-sdk","go-sdk","cli","go-cli","mcp"]},
-  "req:GoSdkDescriptor": {"type":"object","additionalProperties":false,"properties":{"module_path":{"type":"string"},"version":{"type":"string"},"definition_digest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"edition":{"type":"string"},"package_name":{"type":"string"}},"required":["module_path","version","definition_digest","edition"]},
+  "req:GenerateRequest": {"type":"object","additionalProperties":false,"properties":{"spec":{"$ref":"req:SpecInput"},"target":{"type":"object","additionalProperties":false,"properties":{"type":{"$ref":"req:GeneratorKind"}},"required":["type"]},"package_name":{"type":"string"},"module_path":{"type":"string"},"go_sdk":{"$ref":"req:GoSdkDescriptor"},"config":{"$ref":"req:Config"}},"required":["spec","target"]},
+  "req:SpecInput": {"anyOf":[{"$ref":"req:UrlSpecInput"},{"$ref":"req:InlineSpecInput"}]},
+  "req:UrlSpecInput": {"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","pattern":"^https?://"},"headers":{"type":"object"}},"required":["url"]},
+  "req:InlineSpecInput": {"type":"object","additionalProperties":false,"properties":{"inline":{"type":"string"}},"required":["inline"]},
+  "req:GeneratorKind": {"type":"string","enum":["cli","go_cli","mcp","typescript_sdk","python_sdk","go_sdk"]},
+  "req:GoSdkDescriptor": {"type":"object","additionalProperties":false,"properties":{"module_path":{"type":"string"},"version":{"type":"string"},"spec_digest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"package_name":{"type":"string"}},"required":["module_path","version","spec_digest"]},
   "req:Config": {"type":"object","additionalProperties":false,"properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"req:RetryTuning"},"pagination":{"type":"object"},"graphql":{"$ref":"req:GraphqlSettings"},"auth":{"$ref":"req:AuthenticationConfig"},"cli":{"$ref":"req:CliBehavior"},"mcp":{"$ref":"req:McpBehavior"},"readme":{"$ref":"req:ReadmeBehavior"},"package":{"$ref":"req:PackageBehavior"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
   "req:RetryTuning": {"type":"object","additionalProperties":false,"properties":{"max_retries":{"type":"integer","minimum":0,"maximum":10},"statuses":{"type":"array","maxItems":20,"items":{"type":"integer"}},"initial_delay_ms":{"type":"integer","minimum":1},"max_delay_ms":{"type":"integer","minimum":1},"retry_non_idempotent":{"type":"boolean"},"disabled":{"type":"boolean"},"operations":{"type":"object"}}},
   "req:GraphqlSettings": {"type":"object","additionalProperties":false,"properties":{"endpoint":{"type":"string"},"environments":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"url":{"type":"string"}},"required":["name","url"]}},"auth":{"type":"string","enum":["bearer","basic","api_key","none"]},"api_key_header":{"type":"string"},"title":{"type":"string","maxLength":80},"scalars":{"type":"object"}}},
@@ -69,37 +66,40 @@ export const DEFS: Record<string, unknown> = {
   "req:McpBehavior": {"type":"object","additionalProperties":false,"properties":{"registry_name":{"type":["string","null"]},"access":{"type":"object","additionalProperties":false,"properties":{"issuer":{"type":"string"},"resource":{"type":"string"},"jwks_url":{"type":"string"},"scopes":{"type":"array","maxItems":20,"items":{"type":"string"}}},"required":["issuer","resource"]},"tool_mode":{"type":"string","enum":["auto","operations","meta"]},"instructions":{"type":["string","null"],"maxLength":2000},"tool_descriptions":{"type":"object"},"reference_resolvers":{"type":"object"}}},
   "req:ReadmeBehavior": {"type":"object","additionalProperties":false,"properties":{"quickstart_operation":{"type":["string","null"],"maxLength":500}}},
   "req:PackageBehavior": {"type":"object","additionalProperties":false,"properties":{"homepage":{"type":["string","null"]},"license":{"type":["string","null"],"maxLength":200},"license_text":{"type":["string","null"],"maxLength":100000},"copyright":{"type":["string","null"],"maxLength":200},"go_package_name":{"type":["string","null"]}}},
-  "res:GenerationResult": {"type":"object","properties":{"files":{"type":"array","items":{"$ref":"res:GeneratedFile"}},"download":{"$ref":"res:GenerationDownload"},"warnings":{"type":"array","items":{"type":"string"}},"meta":{"$ref":"res:GenerationMeta"},"limits":{"$ref":"res:GenerationLimits"},"claim":{"anyOf":[{"type":"null"},{"type":"object","properties":{"url":{"type":"string"},"expires_at":{"type":"string"}},"required":["url","expires_at"]}]},"request_id":{"$ref":"res:RequestId"}},"required":["files","warnings","meta","request_id"]},
+  "res:GenerationResult": {"type":"object","properties":{"files":{"type":"array","items":{"$ref":"res:GeneratedFile"}},"download":{"$ref":"res:GenerationDownload"},"warnings":{"type":"array","items":{"$ref":"res:GenerationWarning"}},"coverage":{"$ref":"res:GenerationCoverage"},"claim":{"anyOf":[{"type":"null"},{"type":"object","properties":{"url":{"type":"string"},"expires_at":{"type":"string"}},"required":["url","expires_at"]}]},"request_id":{"$ref":"res:RequestId"}},"required":["files","warnings","coverage","request_id"]},
   "res:GeneratedFile": {"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"},"mode":{"type":"string"}},"required":["path","content"]},
   "res:GenerationDownload": {"type":"object","properties":{"url":{"type":"string"},"expires_at":{"type":"string"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"size_bytes":{"type":"integer","minimum":0},"file_count":{"type":"integer","minimum":0}},"required":["url","expires_at","sha256","size_bytes","file_count"]},
-  "res:GenerationMeta": {"type":"object","properties":{"title":{"type":"string"},"api_version":{"type":"string"},"version":{"type":"string"},"spec_format":{"type":"string"},"oas_version":{"type":"string"},"converted":{"type":"boolean"},"artifact_name":{"type":"string"},"client_name":{"type":"string"},"generators":{"type":"array","items":{"$ref":"res:GeneratorKind"}},"go_sdk":{"type":"object","properties":{"module_path":{"type":"string"},"version":{"type":"string"},"package_name":{"type":"string"}},"required":["module_path","version"]},"resource_count":{"type":"integer"},"operation_count":{"type":"integer"},"schema_count":{"type":"integer"},"paginated_operation_count":{"type":"integer"},"omitted_operation_count":{"type":"integer"},"omitted_operations":{"type":"array","items":{"type":"string"}},"pr_url":{"type":["string","null"]},"pr_number":{"type":["integer","null"]},"pr_status":{"type":"string"},"changelog":{"type":"string"},"breaking_count":{"type":"integer"},"baseline":{"type":"string"},"api_compatibility":{"type":"string"},"package_compatibility":{"type":"string"},"version_correct":{"type":["boolean","null"]},"release_readiness":{"type":"string"},"release_readiness_note":{"type":"string"},"previous_version":{"type":"string"},"customer_change_count":{"type":"integer","minimum":0},"integration_state":{"type":"string"},"published_compatibility":{"type":"string"},"published_version":{"type":"string"},"file_count":{"type":"integer"},"total_lines":{"type":"integer"},"diagnostics":{"type":"object","properties":{"format":{"type":"string"},"summary":{"$ref":"res:DiagnosticSummary"}},"required":["format","summary"]}},"required":["title","api_version","version","oas_version","artifact_name","client_name","generators"]},
-  "res:GeneratorKind": {"type":"string"},
-  "res:DiagnosticSummary": {"type":"object","properties":{"diagnostics":{"type":"integer","minimum":0},"occurrences":{"type":"integer","minimum":0},"errors":{"type":"integer","minimum":0},"warnings":{"type":"integer","minimum":0},"suggestions":{"type":"integer","minimum":0},"auto_fixable":{"type":"integer","minimum":0}},"required":["diagnostics","occurrences","errors","warnings","suggestions","auto_fixable"]},
-  "res:GenerationLimits": {"type":"object","properties":{"max_operations":{"type":"integer"},"generated_operations":{"type":"integer"},"omitted_operations":{"type":"integer"},"total_operations":{"type":"integer"},"reason":{"type":"string"},"signup_url":{"type":"string"},"upgrade_url":{"type":"string"}},"required":["max_operations","generated_operations","omitted_operations","total_operations","reason","upgrade_url"]},
+  "res:GenerationWarning": {"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"operation":{"type":"string"}},"required":["code","message"]},
+  "res:GenerationCoverage": {"type":"object","properties":{"generated":{"type":"integer","minimum":0},"omitted":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0},"omitted_operations":{"type":"array","items":{"type":"string"}},"reason":{"type":"string"},"signup_url":{"type":"string"},"upgrade_url":{"type":"string"}},"required":["generated","omitted","total","omitted_operations"]},
   "res:RequestId": {"type":"string","pattern":"^req_[a-z0-9]{16}$"},
   "res:ProjectList": {"type":"object","properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:ProjectSummary"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
   "res:ListObject": {"type":"string"},
-  "res:ProjectSummary": {"type":"object","properties":{"id":{"$ref":"res:ProjectId"},"object":{"type":"string"},"name":{"type":"string","maxLength":80},"definition_id":{"$ref":"res:DefinitionId"},"auto_generate":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","name","definition_id","auto_generate","created_at","updated_at"]},
+  "res:ProjectSummary": {"type":"object","properties":{"id":{"$ref":"res:ProjectId"},"object":{"type":"string"},"name":{"type":"string","maxLength":80},"spec_id":{"$ref":"res:SpecId"},"auto_generate":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","name","spec_id","auto_generate","created_at","updated_at"]},
   "res:ProjectId": {"type":"string","pattern":"^prj_[a-z0-9]{16}$"},
-  "res:DefinitionId": {"type":"string","pattern":"^def_[a-z0-9]{16}$"},
-  "req:CreateProjectRequest": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"definition":{"$ref":"req:DefinitionFields"},"targets":{"type":"array","minItems":1,"items":{"$ref":"req:InitialTargetFields"}},"auto_generate":{"type":"boolean"},"relay_enabled":{"type":"boolean"},"config":{"anyOf":[{"$ref":"req:ProjectConfig"},{"type":"null"}]}},"required":["name","definition","targets"]},
-  "req:DefinitionFields": {"type":"object","additionalProperties":false,"properties":{"source":{"$ref":"req:DefinitionSourceInput"},"patches":{"type":"array","maxItems":50,"items":{"$ref":"req:DefinitionPatch"}},"graphql":{"anyOf":[{"$ref":"req:GraphqlSettings"},{"type":"null"}]},"diagnostic_policy":{"$ref":"req:DiagnosticPolicy"}},"required":["source"]},
-  "req:DefinitionSourceInput": {"anyOf":[{"$ref":"req:UrlDefinitionSourceInput"},{"$ref":"req:RepositoryDefinitionSourceInput"}]},
-  "req:UrlDefinitionSourceInput": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","const":"url"},"url":{"type":"string","maxLength":2048,"pattern":"^https?://"},"headers":{"anyOf":[{"type":"object"},{"type":"null"}]}},"required":["kind","url"]},
-  "req:RepositoryDefinitionSourceInput": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","const":"repository"},"repository":{"$ref":"req:RepositoryReference"},"path":{"type":"string","minLength":1,"maxLength":4096,"pattern":"^(?!/)(?!.*\\.\\.).+$"}},"required":["kind","repository","path"]},
-  "req:RepositoryReference": {"type":"object","additionalProperties":false,"properties":{"provider":{"type":"string","enum":["github"]},"identifier":{"type":"string","maxLength":512}},"required":["provider","identifier"]},
-  "req:DefinitionPatch": {"type":"object","additionalProperties":false,"properties":{"op":{"type":"string","enum":["set","append","remove","rename"]},"path":{"type":"string"},"value":{},"to":{"type":["string","null"]},"reason":{"type":["string","null"]}},"required":["op","path"]},
+  "res:SpecId": {"type":"string","pattern":"^spec_[a-z0-9]{16}$"},
+  "req:CreateProjectRequest": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"spec":{"$ref":"req:SpecFields"},"targets":{"type":"array","minItems":1,"items":{"$ref":"req:InitialTargetFields"}},"auto_generate":{"type":"boolean"},"config":{"anyOf":[{"$ref":"req:ProjectConfig"},{"type":"null"}]}},"required":["name","spec","targets"]},
+  "req:SpecFields": {"type":"object","additionalProperties":false,"properties":{"source":{"$ref":"req:SpecSourceInput"},"patches":{"type":"array","maxItems":50,"items":{"$ref":"req:SpecPatch"}},"graphql":{"anyOf":[{"$ref":"req:GraphqlSettings"},{"type":"null"}]},"diagnostic_policy":{"$ref":"req:DiagnosticPolicy"}},"required":["source"]},
+  "req:SpecSourceInput": {"anyOf":[{"$ref":"req:UrlSpecSourceInput"},{"$ref":"req:RepositorySpecSourceInput"}]},
+  "req:UrlSpecSourceInput": {"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","const":"url"},"url":{"$ref":"req:UrlSpecSourceSettingsInput"}},"required":["type","url"]},
+  "req:UrlSpecSourceSettingsInput": {"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","maxLength":2048,"pattern":"^https?://"},"headers":{"anyOf":[{"type":"object"},{"type":"null"}]}},"required":["url"]},
+  "req:RepositorySpecSourceInput": {"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","const":"repository"},"repository":{"$ref":"req:RepositorySpecSourceSettingsInput"}},"required":["type","repository"]},
+  "req:RepositorySpecSourceSettingsInput": {"type":"object","additionalProperties":false,"properties":{"provider":{"$ref":"req:RepositoryProvider"},"identifier":{"$ref":"req:RepositoryIdentifier"},"path":{"type":"string","minLength":1,"maxLength":4096,"pattern":"^(?!/)(?!.*\\.\\.).+$"}},"required":["provider","identifier","path"]},
+  "req:RepositoryProvider": {"type":"string","enum":["github"]},
+  "req:RepositoryIdentifier": {"type":"string","maxLength":512},
+  "req:SpecPatch": {"type":"object","additionalProperties":false,"properties":{"op":{"type":"string","enum":["set","append","remove","rename"]},"path":{"type":"string"},"value":{},"to":{"type":["string","null"]},"reason":{"type":["string","null"]}},"required":["op","path"]},
   "req:DiagnosticPolicy": {"type":"object","additionalProperties":false,"properties":{"fail_on":{"type":"string","enum":["never","error","warning"]},"only_new":{"type":"boolean"},"suppressions":{"type":"array","maxItems":100,"items":{"$ref":"req:DiagnosticSuppression"}}},"required":["fail_on","only_new","suppressions"]},
   "req:DiagnosticSuppression": {"type":"object","additionalProperties":false,"properties":{"rule_id":{"type":"string","maxLength":160},"path":{"type":"string","maxLength":4096},"reason":{"type":"string","minLength":1,"maxLength":500}},"required":["rule_id","reason"]},
-  "req:InitialTargetFields": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"generator":{"$ref":"req:GeneratorKind"},"state":{"type":"string","enum":["active","disabled"]},"edition":{"type":"string"},"release_channel":{"type":"string","enum":["stable","prerelease"]},"proposed_version":{"type":["string","null"]},"checks":{"$ref":"req:TargetChecks"},"config":{"anyOf":[{"$ref":"req:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"req:DeliveryInput"}}},"required":["name","generator"]},
+  "req:InitialTargetFields": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"type":{"$ref":"req:GeneratorKind"},"status":{"type":"string","enum":["active","disabled"]},"release_channel":{"type":"string","enum":["stable","prerelease"]},"checks":{"$ref":"req:TargetChecks"},"config":{"anyOf":[{"$ref":"req:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"req:DeliveryInput"}}},"required":["name","type"]},
   "req:TargetChecks": {"type":"object","additionalProperties":false,"properties":{"generated":{"type":"array","items":{"type":"string","enum":["build","package","public_entrypoint"]}},"repository_required":{"type":"array","maxItems":50,"items":{"type":"string","minLength":1,"maxLength":120}},"customer":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":120},"command":{"type":"string","minLength":1,"maxLength":2000}},"required":["name","command"]}}}},
-  "req:TargetConfig": {"type":"object","additionalProperties":false,"properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"req:RetryTuning"},"pagination":{"type":"object"},"auth":{"$ref":"req:TargetAuthenticationConfig"},"cli":{"$ref":"req:CliBehavior"},"mcp":{"$ref":"req:McpBehavior"},"readme":{"$ref":"req:ReadmeBehavior"},"package":{"$ref":"req:PackageBehavior"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
+  "req:TargetConfig": {"type":"object","additionalProperties":false,"properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"req:RetryTuning"},"pagination":{"type":"object"},"auth":{"$ref":"req:TargetAuthenticationConfig"},"cli":{"$ref":"req:TargetCliBehavior"},"mcp":{"$ref":"req:McpBehavior"},"readme":{"$ref":"req:ReadmeBehavior"},"package":{"$ref":"req:PackageBehavior"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
   "req:TargetAuthenticationConfig": {"type":"object","additionalProperties":false,"properties":{"oauth_application":{"type":["string","null"],"maxLength":64,"pattern":"^[a-z][a-z0-9_-]{0,63}$"},"environments":{"type":["object","null"]}}},
+  "req:TargetCliBehavior": {"type":"object","additionalProperties":false,"properties":{"command_name":{"type":["string","null"]},"update_notice":{"type":"boolean"},"changelog_url":{"type":["string","null"]},"support_url":{"type":["string","null"]},"mcp_url":{"type":["string","null"]},"skills_repo":{"type":["string","null"]},"relay":{"type":"boolean"}}},
   "req:DeliveryInput": {"anyOf":[{"$ref":"req:RepositoryDeliveryInput"},{"$ref":"req:HostedMcpDeliveryInput"}]},
-  "req:RepositoryDeliveryInput": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","const":"repository"},"repository":{"$ref":"req:RepositoryReference"},"directory":{"type":["string","null"]},"package_name":{"type":["string","null"]},"module_path":{"type":["string","null"]},"publish_on_merge":{"type":"boolean"}},"required":["kind","repository"]},
-  "req:HostedMcpDeliveryInput": {"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","const":"hosted_mcp"}},"required":["kind"]},
+  "req:RepositoryDeliveryInput": {"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","const":"repository"},"repository":{"$ref":"req:RepositoryDeliverySettingsInput"}},"required":["type","repository"]},
+  "req:RepositoryDeliverySettingsInput": {"type":"object","additionalProperties":false,"properties":{"provider":{"$ref":"req:RepositoryProvider"},"identifier":{"$ref":"req:RepositoryIdentifier"},"directory":{"type":["string","null"]},"package_name":{"type":["string","null"]},"module_path":{"type":["string","null"]},"publish_on_merge":{"type":"boolean"}},"required":["provider","identifier"]},
+  "req:HostedMcpDeliveryInput": {"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","const":"hosted_mcp"}},"required":["type"]},
   "req:ProjectConfig": {"type":"object","additionalProperties":false,"properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"req:RetryTuning"},"pagination":{"type":"object"},"auth":{"$ref":"req:AuthenticationConfig"},"cli":{"$ref":"req:CliBehavior"},"mcp":{"$ref":"req:McpBehavior"},"readme":{"$ref":"req:ReadmeBehavior"},"package":{"$ref":"req:PackageBehavior"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
-  "res:Project": {"type":"object","properties":{"id":{"$ref":"res:ProjectId"},"object":{"type":"string"},"name":{"type":"string","maxLength":80},"definition_id":{"$ref":"res:DefinitionId"},"auto_generate":{"type":"boolean"},"relay_enabled":{"type":"boolean"},"config":{"anyOf":[{"$ref":"res:ProjectConfigResponse"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","name","definition_id","auto_generate","relay_enabled","config","created_at","updated_at","request_id"]},
+  "res:Project": {"type":"object","properties":{"id":{"$ref":"res:ProjectId"},"object":{"type":"string"},"name":{"type":"string","maxLength":80},"spec_id":{"$ref":"res:SpecId"},"auto_generate":{"type":"boolean"},"config":{"anyOf":[{"$ref":"res:ProjectConfigResponse"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","name","spec_id","auto_generate","config","created_at","updated_at","request_id"]},
   "res:ProjectConfigResponse": {"type":"object","properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"res:RetryTuningResponse"},"pagination":{"type":"object"},"auth":{"$ref":"res:AuthenticationConfigResponse"},"cli":{"$ref":"res:CliBehaviorResponse"},"mcp":{"$ref":"res:McpBehaviorResponse"},"readme":{"$ref":"res:ReadmeBehaviorResponse"},"package":{"$ref":"res:PackageBehaviorResponse"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
   "res:RetryTuningResponse": {"type":"object","properties":{"max_retries":{"type":"integer","minimum":0,"maximum":10},"statuses":{"type":"array","maxItems":20,"items":{"type":"integer"}},"initial_delay_ms":{"type":"integer","minimum":1},"max_delay_ms":{"type":"integer","minimum":1},"retry_non_idempotent":{"type":"boolean"},"disabled":{"type":"boolean"},"operations":{"type":"object"}}},
   "res:AuthenticationConfigResponse": {"type":"object","properties":{"oauth_server":{"anyOf":[{"$ref":"res:OAuthServerResponse"},{"type":"null"}]},"oauth_applications":{"type":["object","null"]},"oauth_application":{"type":["string","null"],"maxLength":64,"pattern":"^[a-z][a-z0-9_-]{0,63}$"},"identity_verification":{"anyOf":[{"$ref":"res:IdentityVerificationResponse"},{"type":"null"}]},"approval_url":{"type":["string","null"]},"environments":{"type":["object","null"]}}},
@@ -111,126 +111,121 @@ export const DEFS: Record<string, unknown> = {
   "res:PackageBehaviorResponse": {"type":"object","properties":{"homepage":{"type":["string","null"]},"license":{"type":["string","null"],"maxLength":200},"license_text":{"type":["string","null"],"maxLength":100000},"copyright":{"type":["string","null"],"maxLength":200},"go_package_name":{"type":["string","null"]}}},
   "req:ProjectId": {"type":"string","pattern":"^prj_[a-z0-9]{16}$"},
   "res:DeletedProject": {"type":"object","properties":{"id":{"$ref":"res:ProjectId"},"object":{"type":"string"},"deleted":{"type":"boolean"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","deleted","request_id"]},
-  "req:UpdateProjectRequest": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"auto_generate":{"type":"boolean"},"relay_enabled":{"type":"boolean"},"config":{"anyOf":[{"$ref":"req:ProjectConfig"},{"type":"null"}]}}},
-  "res:DiagnosticReport": {"type":"object","properties":{"object":{"type":"string"},"format":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"definition_revision_id":{"$ref":"res:DefinitionRevisionId"},"source_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"analyzed_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"patch_diagnostics":{"type":"array","items":{"type":"string"}},"summary":{"$ref":"res:DiagnosticSummary"},"diagnostics":{"type":"array","items":{"$ref":"res:Diagnostic"}},"policy":{"$ref":"res:DiagnosticPolicyResponse"},"evaluation":{"$ref":"res:DiagnosticEvaluation"},"quality_signals":{"$ref":"res:DiagnosticQualitySignals"},"delta":{"$ref":"res:DiagnosticDelta"},"request_id":{"$ref":"res:RequestId"}},"required":["object","format","project_id","definition_revision_id","source_sha256","analyzed_sha256","patch_diagnostics","summary","diagnostics","policy","evaluation","quality_signals","delta","request_id"]},
-  "res:DefinitionRevisionId": {"type":"string","pattern":"^drev_[a-z0-9]{16}$"},
-  "res:Diagnostic": {"type":"object","properties":{"id":{"type":"string"},"severity":{"type":"string"},"category":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"impact":{"type":"string"},"surfaces":{"type":"array","items":{"type":"string"}},"evidence_basis":{"type":"string"},"owner_decision_required":{"type":"boolean"},"surface_impact":{"type":"string"},"locations":{"type":"array","minItems":1,"items":{"$ref":"res:DiagnosticLocation"}},"fix":{"$ref":"res:DiagnosticFix"},"authoring_brief":{"type":"string"}},"required":["id","severity","category","title","description","impact","surfaces","evidence_basis","owner_decision_required","locations","authoring_brief"]},
-  "res:DiagnosticLocation": {"type":"object","properties":{"document":{"type":"string"},"path":{"type":"string"},"operation":{"type":"string"},"evidence":{"type":"string"}},"required":["path"]},
-  "res:DiagnosticFix": {"type":"object","properties":{"title":{"type":"string"},"kind":{"type":"string"},"patches":{"type":"array","items":{"$ref":"res:DefinitionPatchResponse"}},"instructions":{"type":"string"}},"required":["title","kind"]},
-  "res:DefinitionPatchResponse": {"type":"object","properties":{"op":{"type":"string"},"path":{"type":"string"},"value":{},"to":{"type":["string","null"]},"reason":{"type":["string","null"]}},"required":["op","path"]},
-  "res:DiagnosticPolicyResponse": {"type":"object","properties":{"fail_on":{"type":"string"},"only_new":{"type":"boolean"},"suppressions":{"type":"array","maxItems":100,"items":{"$ref":"res:DiagnosticSuppressionResponse"}}},"required":["fail_on","only_new","suppressions"]},
-  "res:DiagnosticSuppressionResponse": {"type":"object","properties":{"rule_id":{"type":"string","maxLength":160},"path":{"type":"string","maxLength":4096},"reason":{"type":"string","minLength":1,"maxLength":500}},"required":["rule_id","reason"]},
-  "res:DiagnosticEvaluation": {"type":"object","properties":{"state":{"type":"string"},"blocking":{"type":"array","items":{"$ref":"res:DiagnosticReference"}},"considered_occurrences":{"type":"integer","minimum":0},"suppressed_occurrences":{"type":"integer","minimum":0}},"required":["state","blocking","considered_occurrences","suppressed_occurrences"]},
-  "res:DiagnosticReference": {"type":"object","properties":{"rule_id":{"type":"string"},"severity":{"type":"string"},"title":{"type":"string"},"locations":{"type":"array","minItems":1,"items":{"$ref":"res:DiagnosticLocation"}}},"required":["rule_id","severity","title","locations"]},
-  "res:DiagnosticQualitySignals": {"type":"object","properties":{"suppressed_by_rule":{"type":"array","items":{"$ref":"res:DiagnosticSuppressionSignal"}},"stale_suppressions":{"type":"array","items":{"$ref":"res:DiagnosticSuppressionResponse"}}},"required":["suppressed_by_rule","stale_suppressions"]},
-  "res:DiagnosticSuppressionSignal": {"type":"object","properties":{"rule_id":{"type":"string"},"active_occurrences":{"type":"integer","minimum":0},"suppressed_occurrences":{"type":"integer","minimum":1}},"required":["rule_id","active_occurrences","suppressed_occurrences"]},
-  "res:DiagnosticDelta": {"type":"object","properties":{"added":{"type":"array","items":{"$ref":"res:DiagnosticReference"}},"resolved":{"type":"array","items":{"$ref":"res:DiagnosticReference"}},"baseline_definition_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]}},"required":["added","resolved","baseline_definition_revision_id"]},
-  "req:DiagnosticRemediationRequest": {"type":"object","additionalProperties":false,"properties":{"diagnostic_ids":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"string"}}},"required":["diagnostic_ids"]},
-  "res:DiagnosticRemediation": {"type":"object","properties":{"object":{"type":"string"},"kind":{"type":"string"},"patches_applied":{"type":"integer","minimum":0},"review_url":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","kind","patches_applied","request_id"]},
-  "res:RepositoryIntegrationHealth": {"type":"object","properties":{"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"status":{"type":"string"},"repositories":{"type":"array","items":{"$ref":"res:RepositoryHealth"}},"required_checks":{"type":"object","properties":{"source":{"type":"array","items":{"type":"string"}},"destination":{"type":"array","items":{"type":"string"}}},"required":["source","destination"]},"last_event":{"anyOf":[{"$ref":"res:RepositoryEventHealth"},{"type":"null"}]},"request_id":{"$ref":"res:RequestId"}},"required":["object","project_id","status","repositories","required_checks","last_event","request_id"]},
-  "res:RepositoryHealth": {"type":"object","properties":{"repository":{"$ref":"res:RepositoryReferenceResponse"},"roles":{"type":"array","items":{"type":"string"}},"status":{"type":"string"},"default_branch":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string"}},"breaking_acknowledgement":{"type":["boolean","null"]},"definition":{"type":"string"},"issues":{"type":"array","items":{"$ref":"res:RepositoryHealthIssue"}}},"required":["repository","roles","status","issues"]},
-  "res:RepositoryReferenceResponse": {"type":"object","properties":{"provider":{"type":"string"},"identifier":{"type":"string","maxLength":512}},"required":["provider","identifier"]},
-  "res:RepositoryHealthIssue": {"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},
-  "res:RepositoryEventHealth": {"type":"object","properties":{"provider":{"type":"string"},"id":{"type":"string"},"event":{"type":"string"},"status":{"type":"string"},"error":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["provider","id","event","status","error","created_at"]},
-  "res:GenerationList": {"type":"object","properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:GenerationSummary"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
-  "res:GenerationSummary": {"type":"object","properties":{"id":{"$ref":"res:GenerationId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"definition_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]},"status":{"$ref":"res:GenerationStatus"},"trigger":{"$ref":"res:GenerationTrigger"},"target_id":{"anyOf":[{"$ref":"res:TargetId"},{"type":"null"}]},"generator":{"$ref":"res:GeneratorKind"},"provenance":{"$ref":"res:GenerationProvenance"},"meta":{"anyOf":[{"$ref":"res:GenerationMeta"},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}},"errors":{"type":"array","items":{"$ref":"res:DomainError"}},"created_at":{"type":"string"}},"required":["id","object","project_id","definition_revision_id","status","trigger","target_id","generator","provenance","meta","warnings","errors","created_at"]},
+  "req:UpdateProjectRequest": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"auto_generate":{"type":"boolean"},"config":{"anyOf":[{"$ref":"req:ProjectConfig"},{"type":"null"}]}}},
+  "req:GenerateProjectRequest": {"type":"object","additionalProperties":false,"properties":{"target_id":{"$ref":"req:TargetId"}}},
+  "req:TargetId": {"type":"string","pattern":"^tgt_[a-z0-9]{16}$"},
+  "res:GenerationBatch": {"type":"object","properties":{"data":{"type":"array","items":{"$ref":"res:GenerationSummary"}},"request_id":{"$ref":"res:RequestId"}},"required":["data","request_id"]},
+  "res:GenerationSummary": {"allOf":[{"$ref":"res:Generation"}]},
+  "res:Generation": {"type":"object","properties":{"id":{"$ref":"res:GenerationId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"spec_revision_id":{"anyOf":[{"$ref":"res:SpecRevisionId"},{"type":"null"}]},"status":{"$ref":"res:GenerationStatus"},"trigger":{"$ref":"res:GenerationTrigger"},"target_id":{"anyOf":[{"$ref":"res:TargetId"},{"type":"null"}]},"type":{"$ref":"res:GeneratorKind"},"name":{"type":["string","null"]},"version":{"type":["string","null"]},"warnings":{"type":"array","items":{"$ref":"res:GenerationWarning"}},"coverage":{"anyOf":[{"$ref":"res:GenerationCoverage"},{"type":"null"}]},"file_count":{"type":"integer","minimum":0},"errors":{"type":"array","items":{"$ref":"res:DomainError"}},"runtime_ms":{"type":["integer","null"],"minimum":0},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","project_id","spec_revision_id","status","trigger","target_id","type","name","version","warnings","coverage","file_count","errors","runtime_ms","created_at","updated_at"]},
   "res:GenerationId": {"type":"string","pattern":"^gen_[a-z0-9]{16}$"},
+  "res:SpecRevisionId": {"type":"string","pattern":"^srev_[a-z0-9]{16}$"},
   "res:GenerationStatus": {"type":"string"},
   "res:GenerationTrigger": {"type":"string"},
   "res:TargetId": {"type":"string","pattern":"^tgt_[a-z0-9]{16}$"},
-  "res:GenerationProvenance": {"type":"object","properties":{"generator_edition":{"type":"string"},"resolved_config":{"anyOf":[{"$ref":"res:ConfigResponse"},{"type":"null"}]},"package_version":{"type":["string","null"]}},"required":["generator_edition","resolved_config","package_version"]},
-  "res:ConfigResponse": {"type":"object","properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"res:RetryTuningResponse"},"pagination":{"type":"object"},"graphql":{"$ref":"res:GraphqlSettingsResponse"},"auth":{"$ref":"res:AuthenticationConfigResponse"},"cli":{"$ref":"res:CliBehaviorResponse"},"mcp":{"$ref":"res:McpBehaviorResponse"},"readme":{"$ref":"res:ReadmeBehaviorResponse"},"package":{"$ref":"res:PackageBehaviorResponse"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
-  "res:GraphqlSettingsResponse": {"type":"object","properties":{"endpoint":{"type":"string"},"environments":{"type":"array","maxItems":10,"items":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"}},"required":["name","url"]}},"auth":{"type":"string"},"api_key_header":{"type":"string"},"title":{"type":"string","maxLength":80},"scalars":{"type":"object"}}},
+  "res:GeneratorKind": {"type":"string"},
   "res:DomainError": {"allOf":[{"$ref":"res:ErrorDetail"},{"type":"object","properties":{"phase":{"$ref":"res:FailurePhase"}},"required":["phase"]}]},
   "res:ErrorDetail": {"type":"object","properties":{"type":{"$ref":"res:ErrorType"},"code":{"$ref":"res:ErrorCode"},"phase":{"$ref":"res:FailurePhase"},"target_id":{"$ref":"res:TargetId"},"field":{"type":"string"},"in":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"},"docs_url":{"type":"string"}},"required":["type","code","message","retryable","suggested_action","docs_url"]},
   "res:ErrorType": {"type":"string"},
   "res:ErrorCode": {"type":"string"},
   "res:FailurePhase": {"type":"string"},
-  "req:TargetId": {"type":"string","pattern":"^tgt_[a-z0-9]{16}$"},
-  "req:GenerateProjectRequest": {"type":"object","additionalProperties":false,"properties":{"target_id":{"$ref":"req:TargetId"}}},
-  "res:GenerationBatch": {"type":"object","properties":{"data":{"type":"array","items":{"$ref":"res:GenerationSummary"}},"request_id":{"$ref":"res:RequestId"}},"required":["data","request_id"]},
-  "res:Definition": {"type":"object","properties":{"id":{"$ref":"res:DefinitionId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"source":{"$ref":"res:DefinitionSource"},"format":{"type":["string","null"]},"patches":{"type":"array","items":{"$ref":"res:DefinitionPatchResponse"}},"graphql":{"anyOf":[{"$ref":"res:GraphqlSettingsResponse"},{"type":"null"}]},"diagnostic_policy":{"$ref":"res:DiagnosticPolicyResponse"},"latest_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","source","format","patches","graphql","diagnostic_policy","latest_revision_id","created_at","updated_at","request_id"]},
-  "res:DefinitionSource": {"anyOf":[{"$ref":"res:UrlDefinitionSource"},{"$ref":"res:RepositoryDefinitionSource"}],"responseDiscriminator":{"propertyName":"kind","mapping":{"url":{"$ref":"res:UrlDefinitionSource"},"repository":{"$ref":"res:RepositoryDefinitionSource"}}}},
-  "res:UrlDefinitionSource": {"type":"object","properties":{"kind":{"type":"string"},"url":{"type":"string","maxLength":2048,"pattern":"^https?://"},"headers_configured":{"type":"boolean"}},"required":["kind","url","headers_configured"]},
-  "res:RepositoryDefinitionSource": {"type":"object","properties":{"kind":{"type":"string"},"repository":{"$ref":"res:RepositoryReferenceResponse"},"path":{"type":"string","minLength":1,"maxLength":4096,"pattern":"^(?!/)(?!.*\\.\\.).+$"}},"required":["kind","repository","path"]},
-  "req:DefinitionId": {"type":"string","pattern":"^def_[a-z0-9]{16}$"},
-  "req:DefinitionUpdateRequest": {"type":"object","additionalProperties":false,"properties":{"source":{"$ref":"req:DefinitionSourceInput"},"patches":{"type":"array","maxItems":50,"items":{"$ref":"req:DefinitionPatch"}},"graphql":{"anyOf":[{"$ref":"req:GraphqlSettings"},{"type":"null"}]},"diagnostic_policy":{"$ref":"req:DiagnosticPolicy"}}},
+  "res:Spec": {"type":"object","properties":{"id":{"$ref":"res:SpecId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"source":{"$ref":"res:SpecSource"},"format":{"type":["string","null"]},"patches":{"type":"array","items":{"$ref":"res:SpecPatchResponse"}},"graphql":{"anyOf":[{"$ref":"res:GraphqlSettingsResponse"},{"type":"null"}]},"diagnostic_policy":{"$ref":"res:DiagnosticPolicyResponse"},"revision_latest_id":{"anyOf":[{"$ref":"res:SpecRevisionId"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","source","format","patches","graphql","diagnostic_policy","revision_latest_id","created_at","updated_at","request_id"]},
+  "res:SpecSource": {"anyOf":[{"$ref":"res:UrlSpecSource"},{"$ref":"res:RepositorySpecSource"}],"responseDiscriminator":{"propertyName":"type","mapping":{"url":{"$ref":"res:UrlSpecSource"},"repository":{"$ref":"res:RepositorySpecSource"}}}},
+  "res:UrlSpecSource": {"type":"object","properties":{"type":{"type":"string"},"url":{"$ref":"res:UrlSpecSourceSettings"}},"required":["type","url"]},
+  "res:UrlSpecSourceSettings": {"type":"object","properties":{"url":{"type":"string","maxLength":2048,"pattern":"^https?://"},"headers_configured":{"type":"boolean"}},"required":["url","headers_configured"]},
+  "res:RepositorySpecSource": {"type":"object","properties":{"type":{"type":"string"},"repository":{"$ref":"res:RepositorySpecSourceSettings"}},"required":["type","repository"]},
+  "res:RepositorySpecSourceSettings": {"type":"object","properties":{"provider":{"$ref":"res:RepositoryProvider"},"identifier":{"$ref":"res:RepositoryIdentifier"},"path":{"type":"string","minLength":1,"maxLength":4096,"pattern":"^(?!/)(?!.*\\.\\.).+$"}},"required":["provider","identifier","path"]},
+  "res:RepositoryProvider": {"type":"string"},
+  "res:RepositoryIdentifier": {"type":"string","maxLength":512},
+  "res:SpecPatchResponse": {"type":"object","properties":{"op":{"type":"string"},"path":{"type":"string"},"value":{},"to":{"type":["string","null"]},"reason":{"type":["string","null"]}},"required":["op","path"]},
+  "res:GraphqlSettingsResponse": {"type":"object","properties":{"endpoint":{"type":"string"},"environments":{"type":"array","maxItems":10,"items":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"}},"required":["name","url"]}},"auth":{"type":"string"},"api_key_header":{"type":"string"},"title":{"type":"string","maxLength":80},"scalars":{"type":"object"}}},
+  "res:DiagnosticPolicyResponse": {"type":"object","properties":{"fail_on":{"type":"string"},"only_new":{"type":"boolean"},"suppressions":{"type":"array","maxItems":100,"items":{"$ref":"res:DiagnosticSuppressionResponse"}}},"required":["fail_on","only_new","suppressions"]},
+  "res:DiagnosticSuppressionResponse": {"type":"object","properties":{"rule_id":{"type":"string","maxLength":160},"path":{"type":"string","maxLength":4096},"reason":{"type":"string","minLength":1,"maxLength":500}},"required":["rule_id","reason"]},
+  "req:SpecId": {"type":"string","pattern":"^spec_[a-z0-9]{16}$"},
+  "req:SpecUpdateRequest": {"type":"object","additionalProperties":false,"properties":{"source":{"$ref":"req:SpecSourceInput"},"patches":{"type":"array","maxItems":50,"items":{"$ref":"req:SpecPatch"}},"graphql":{"anyOf":[{"$ref":"req:GraphqlSettings"},{"type":"null"}]},"diagnostic_policy":{"$ref":"req:DiagnosticPolicy"}}},
+  "res:SpecRevisionList": {"type":"object","properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:SpecRevision"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
+  "res:SpecRevision": {"type":"object","properties":{"id":{"$ref":"res:SpecRevisionId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"spec_id":{"$ref":"res:SpecId"},"format":{"type":"string"},"file_count":{"type":"integer","minimum":1},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"size_bytes":{"type":"integer","minimum":0},"source":{"anyOf":[{"$ref":"res:SpecRevisionSource"},{"type":"null"}]},"diagnostic_summary":{"$ref":"res:DiagnosticSummary"},"diagnostics":{"type":"array","items":{"$ref":"res:Diagnostic"}},"patch_diagnostics":{"type":"array","items":{"$ref":"res:DiagnosticWarning"}},"created_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","spec_id","format","file_count","sha256","size_bytes","source","created_at"]},
+  "res:SpecRevisionSource": {"anyOf":[{"$ref":"res:UrlSpecRevisionSource"},{"$ref":"res:RepositorySpecRevisionSource"}],"responseDiscriminator":{"propertyName":"type","mapping":{"url":{"$ref":"res:UrlSpecRevisionSource"},"repository":{"$ref":"res:RepositorySpecRevisionSource"}}}},
+  "res:UrlSpecRevisionSource": {"type":"object","properties":{"type":{"type":"string"},"url":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]}},"required":["type","url"]},
+  "res:RepositorySpecRevisionSource": {"type":"object","properties":{"type":{"type":"string"},"repository":{"type":"object","properties":{"provider":{"$ref":"res:RepositoryProvider"},"identifier":{"$ref":"res:RepositoryIdentifier"},"path":{"type":"string"},"ref":{"type":["string","null"]},"commit_sha":{"type":["string","null"]}},"required":["provider","identifier","path"]}},"required":["type","repository"]},
+  "res:DiagnosticSummary": {"type":"object","properties":{"status":{"type":"string"},"error_count":{"type":"integer","minimum":0},"warning_count":{"type":"integer","minimum":0},"suggestion_count":{"type":"integer","minimum":0},"blocking_count":{"type":"integer","minimum":0},"baseline_spec_revision_id":{"anyOf":[{"$ref":"res:SpecRevisionId"},{"type":"null"}]}},"required":["status","error_count","warning_count","suggestion_count","blocking_count","baseline_spec_revision_id"]},
+  "res:Diagnostic": {"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string"},"blocking":{"type":"boolean"},"introduced":{"type":"boolean"},"severity":{"type":"string"},"category":{"type":"string"},"title":{"type":"string"},"message":{"type":"string"},"surfaces":{"type":"array","items":{"type":"string"}},"owner_decision_required":{"type":"boolean"},"locations":{"type":"array","minItems":1,"items":{"$ref":"res:DiagnosticLocation"}},"fix":{"$ref":"res:DiagnosticFix"},"authoring_brief":{"type":"string"}},"required":["id","object","severity","category","title","message","surfaces","owner_decision_required","blocking","introduced","locations","authoring_brief"]},
+  "res:DiagnosticLocation": {"type":"object","properties":{"file_path":{"type":"string"},"file_id":{"$ref":"res:FileId"},"path":{"type":"string"},"operation":{"type":"string"},"evidence":{"type":"string"}},"required":["path"]},
+  "res:FileId": {"type":"string","pattern":"^file_[a-z0-9]{16}$"},
+  "res:DiagnosticFix": {"type":"object","properties":{"title":{"type":"string"},"type":{"type":"string"},"patches":{"type":"array","items":{"$ref":"res:SpecPatchResponse"}},"instructions":{"type":"string"}},"required":["title","type"]},
+  "res:DiagnosticWarning": {"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},
+  "res:SpecRevisionResponse": {"allOf":[{"$ref":"res:SpecRevision"},{"$ref":"res:ResponseMetadata"}]},
+  "res:ResponseMetadata": {"type":"object","properties":{"request_id":{"$ref":"res:RequestId"}},"required":["request_id"]},
+  "req:SpecRevisionId": {"type":"string","pattern":"^srev_[a-z0-9]{16}$"},
+  "res:SpecRevisionFileList": {"type":"object","properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:SpecRevisionFile"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
+  "res:SpecRevisionFile": {"allOf":[{"$ref":"res:File"},{"type":"object","properties":{"role":{"type":"string"}},"required":["role"]}]},
+  "res:File": {"type":"object","properties":{"id":{"$ref":"res:FileId"},"object":{"type":"string"},"path":{"type":"string"},"size_bytes":{"type":"integer","minimum":0},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"encoding":{"type":"string"},"mode":{"anyOf":[{"$ref":"res:GitFileMode"},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","object","path","size_bytes","sha256","encoding","mode","created_at"]},
+  "res:GitFileMode": {"type":"string"},
   "res:TargetList": {"type":"object","properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:Target"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
-  "res:Target": {"type":"object","properties":{"id":{"$ref":"res:TargetId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"definition_id":{"$ref":"res:DefinitionId"},"name":{"type":"string"},"generator":{"$ref":"res:GeneratorKind"},"dependency":{"anyOf":[{"$ref":"res:TargetDependency"},{"type":"null"}]},"state":{"type":"string"},"edition":{"type":"string"},"release_channel":{"type":"string"},"version_policy":{"type":"object","properties":{"mode":{"type":"string"},"pre1_breaking":{"type":"string"}},"required":["mode","pre1_breaking"]},"current_version":{"type":["string","null"]},"proposed_version":{"type":["string","null"]},"proposed_version_source":{"type":["string","null"]},"checks":{"$ref":"res:TargetChecksResponse"},"config":{"anyOf":[{"$ref":"res:TargetConfigResponse"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"res:Delivery"}},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","definition_id","name","generator","dependency","state","edition","release_channel","version_policy","current_version","proposed_version","proposed_version_source","checks","config","deliveries","created_at","updated_at"]},
-  "res:TargetDependency": {"type":"object","properties":{"kind":{"type":"string"},"target_id":{"$ref":"res:TargetId"}},"required":["kind","target_id"]},
+  "res:Target": {"type":"object","properties":{"id":{"$ref":"res:TargetId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"spec_id":{"$ref":"res:SpecId"},"name":{"type":"string"},"type":{"$ref":"res:GeneratorKind"},"dependency":{"anyOf":[{"$ref":"res:TargetDependency"},{"type":"null"}]},"status":{"type":"string"},"release_channel":{"type":"string"},"version_current":{"type":["string","null"]},"draft_id":{"$ref":"res:DraftId"},"checks":{"$ref":"res:TargetChecksResponse"},"config":{"anyOf":[{"$ref":"res:TargetConfigResponse"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"res:Delivery"}},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","spec_id","name","type","dependency","status","release_channel","version_current","draft_id","checks","config","deliveries","created_at","updated_at"]},
+  "res:TargetDependency": {"type":"object","properties":{"type":{"type":"string"},"target_id":{"$ref":"res:TargetId"}},"required":["type","target_id"]},
+  "res:DraftId": {"type":"string","pattern":"^drf_[a-z0-9]{16}$"},
   "res:TargetChecksResponse": {"type":"object","properties":{"generated":{"type":"array","items":{"type":"string"}},"repository_required":{"type":"array","maxItems":50,"items":{"type":"string","minLength":1,"maxLength":120}},"customer":{"type":"array","maxItems":20,"items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"command":{"type":"string","minLength":1,"maxLength":2000}},"required":["name","command"]}}}},
-  "res:TargetConfigResponse": {"type":"object","properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"res:RetryTuningResponse"},"pagination":{"type":"object"},"auth":{"$ref":"res:TargetAuthenticationConfigResponse"},"cli":{"$ref":"res:CliBehaviorResponse"},"mcp":{"$ref":"res:McpBehaviorResponse"},"readme":{"$ref":"res:ReadmeBehaviorResponse"},"package":{"$ref":"res:PackageBehaviorResponse"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
+  "res:TargetConfigResponse": {"type":"object","properties":{"globals":{"type":"array","maxItems":20,"items":{"type":"string"}},"retries":{"$ref":"res:RetryTuningResponse"},"pagination":{"type":"object"},"auth":{"$ref":"res:TargetAuthenticationConfigResponse"},"cli":{"$ref":"res:TargetCliBehaviorResponse"},"mcp":{"$ref":"res:McpBehaviorResponse"},"readme":{"$ref":"res:ReadmeBehaviorResponse"},"package":{"$ref":"res:PackageBehaviorResponse"},"docs_url":{"type":["string","null"]},"docs_index_url":{"type":["string","null"]}}},
   "res:TargetAuthenticationConfigResponse": {"type":"object","properties":{"oauth_application":{"type":["string","null"],"maxLength":64,"pattern":"^[a-z][a-z0-9_-]{0,63}$"},"environments":{"type":["object","null"]}}},
-  "res:Delivery": {"anyOf":[{"$ref":"res:RepositoryDelivery"},{"$ref":"res:HostedMcpDelivery"}],"responseDiscriminator":{"propertyName":"kind","mapping":{"repository":{"$ref":"res:RepositoryDelivery"},"hosted_mcp":{"$ref":"res:HostedMcpDelivery"}}}},
-  "res:RepositoryDelivery": {"type":"object","properties":{"id":{"$ref":"res:DeliveryId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"kind":{"type":"string"},"state":{"type":"string"},"repository":{"$ref":"res:RepositoryReferenceResponse"},"directory":{"type":["string","null"]},"package_name":{"type":["string","null"]},"module_path":{"type":["string","null"]},"publish_on_merge":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","target_id","kind","state","repository","directory","package_name","module_path","publish_on_merge","created_at","updated_at"]},
+  "res:TargetCliBehaviorResponse": {"type":"object","properties":{"command_name":{"type":["string","null"]},"update_notice":{"type":"boolean"},"changelog_url":{"type":["string","null"]},"support_url":{"type":["string","null"]},"mcp_url":{"type":["string","null"]},"skills_repo":{"type":["string","null"]},"relay":{"type":"boolean"}}},
+  "res:Delivery": {"anyOf":[{"$ref":"res:RepositoryDelivery"},{"$ref":"res:HostedMcpDelivery"}],"responseDiscriminator":{"propertyName":"type","mapping":{"repository":{"$ref":"res:RepositoryDelivery"},"hosted_mcp":{"$ref":"res:HostedMcpDelivery"}}}},
+  "res:RepositoryDelivery": {"type":"object","properties":{"id":{"$ref":"res:DeliveryId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"type":{"type":"string"},"status":{"type":"string"},"repository":{"$ref":"res:RepositoryDeliverySettings"},"issues":{"type":"array","items":{"$ref":"res:RepositoryDeliveryIssue"}},"required_checks":{"type":"array","items":{"type":"string"}},"last_event":{"anyOf":[{"$ref":"res:RepositoryDeliveryEvent"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","target_id","type","status","repository","issues","required_checks","last_event","created_at","updated_at"]},
   "res:DeliveryId": {"type":"string","pattern":"^dlv_[a-z0-9]{16}$"},
-  "res:HostedMcpDelivery": {"type":"object","properties":{"id":{"$ref":"res:DeliveryId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"kind":{"type":"string"},"state":{"type":"string"},"url":{"type":["string","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","target_id","kind","state","url","created_at","updated_at"]},
-  "req:TargetFields": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"definition_id":{"$ref":"req:DefinitionId"},"generator":{"$ref":"req:GeneratorKind"},"state":{"type":"string","enum":["active","disabled"]},"edition":{"type":"string"},"release_channel":{"type":"string","enum":["stable","prerelease"]},"proposed_version":{"type":["string","null"]},"checks":{"$ref":"req:TargetChecks"},"config":{"anyOf":[{"$ref":"req:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"req:DeliveryInput"}}},"required":["name","definition_id","generator"]},
+  "res:RepositoryDeliverySettings": {"type":"object","properties":{"provider":{"$ref":"res:RepositoryProvider"},"identifier":{"$ref":"res:RepositoryIdentifier"},"directory":{"type":["string","null"]},"package_name":{"type":["string","null"]},"module_path":{"type":["string","null"]},"publish_on_merge":{"type":"boolean"}},"required":["provider","identifier","directory","package_name","module_path","publish_on_merge"]},
+  "res:RepositoryDeliveryIssue": {"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},
+  "res:RepositoryDeliveryEvent": {"type":"object","properties":{"event":{"type":"string"},"status":{"type":"string"},"created_at":{"type":"string"}},"required":["event","status","created_at"]},
+  "res:HostedMcpDelivery": {"type":"object","properties":{"id":{"$ref":"res:DeliveryId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"type":{"type":"string"},"status":{"type":"string"},"hosted_mcp":{"$ref":"res:HostedMcpDeliverySettings"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","target_id","type","status","hosted_mcp","created_at","updated_at"]},
+  "res:HostedMcpDeliverySettings": {"type":"object","properties":{"url":{"type":["string","null"]}},"required":["url"]},
+  "req:TargetCreateRequest": {"type":"object","additionalProperties":false,"properties":{"project_id":{"$ref":"req:ProjectId"},"name":{"type":"string","minLength":1,"maxLength":80},"spec_id":{"$ref":"req:SpecId"},"type":{"$ref":"req:GeneratorKind"},"status":{"type":"string","enum":["active","disabled"]},"release_channel":{"type":"string","enum":["stable","prerelease"]},"checks":{"$ref":"req:TargetChecks"},"config":{"anyOf":[{"$ref":"req:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"req:DeliveryInput"}}},"required":["project_id","name","spec_id","type"]},
   "res:TargetResponse": {"allOf":[{"$ref":"res:Target"},{"$ref":"res:ResponseMetadata"}]},
-  "res:ResponseMetadata": {"type":"object","properties":{"request_id":{"$ref":"res:RequestId"}},"required":["request_id"]},
   "res:DeletedTarget": {"type":"object","properties":{"id":{"$ref":"res:TargetId"},"object":{"type":"string"},"deleted":{"type":"boolean"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","deleted","request_id"]},
-  "req:TargetUpdateRequest": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"state":{"type":"string","enum":["active","disabled"]},"edition":{"type":"string"},"release_channel":{"type":"string","enum":["stable","prerelease"]},"proposed_version":{"type":["string","null"]},"checks":{"$ref":"req:TargetChecks"},"config":{"anyOf":[{"$ref":"req:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"req:DeliveryInput"}}}},
-  "res:TargetReleaseList": {"type":"object","properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:TargetRelease"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
-  "res:TargetRelease": {"type":"object","properties":{"id":{"$ref":"res:TargetReleaseId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"generation_id":{"anyOf":[{"$ref":"res:GenerationId"},{"type":"null"}]},"origin":{"type":"string"},"version":{"type":"string"},"channel":{"type":"string"},"provider":{"type":"string"},"repository":{"anyOf":[{"$ref":"res:RepositoryReferenceResponse"},{"type":"null"}]},"definition_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]},"delivery_revision":{"type":"string"},"source_digest":{"type":["string","null"]},"checks":{"type":"array","items":{"$ref":"res:PackageCheck"}},"accepted_risks":{"type":"array","items":{"$ref":"res:AcceptedCompatibilityRisk"}},"import_provenance":{"type":["object","null"],"properties":{"tag":{"type":["string","null"]},"registry_url":{"type":["string","null"]},"artifact_digest":{"type":["string","null"]},"imported_at":{"type":["string","null"]}},"required":["tag","registry_url","artifact_digest","imported_at"]},"publications":{"type":"array","items":{"$ref":"res:Publication"}},"created_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","target_id","generation_id","version","channel","origin","provider","repository","definition_revision_id","delivery_revision","source_digest","checks","accepted_risks","import_provenance","publications","created_at"]},
-  "res:TargetReleaseId": {"type":"string","pattern":"^rel_[a-z0-9]{16}$"},
-  "res:PackageCheck": {"type":"object","properties":{"name":{"type":"string"},"source":{"type":"string"},"required":{"type":"boolean"},"state":{"type":"string"},"reason":{"type":"string"},"revision":{"type":"string"},"url":{"type":["string","null"]},"observed_at":{"type":["string","null"]}},"required":["name","source","required","state","reason","revision","url","observed_at"]},
-  "res:AcceptedCompatibilityRisk": {"type":"object","properties":{"comparison":{"type":"string"},"reason":{"type":"string"},"approved_by":{"type":"string"},"approved_revision":{"type":"string"},"approved_at":{"type":"string"}},"required":["comparison","reason","approved_by","approved_revision","approved_at"]},
-  "res:Publication": {"type":"object","properties":{"id":{"$ref":"res:PublicationId"},"object":{"type":"string"},"target_release_id":{"$ref":"res:TargetReleaseId"},"destination":{"type":"string"},"state":{"type":"string"},"attempt":{"type":"integer","minimum":0},"run_url":{"type":["string","null"]},"registry_url":{"type":["string","null"]},"artifact_digest":{"type":["string","null"]},"errors":{"type":"array","items":{"$ref":"res:DomainError"}},"started_at":{"type":["string","null"]},"finished_at":{"type":["string","null"]},"updated_at":{"type":"string"}},"required":["id","object","target_release_id","destination","state","attempt","run_url","registry_url","artifact_digest","errors","started_at","finished_at","updated_at"]},
+  "req:TargetUpdateRequest": {"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"status":{"type":"string","enum":["active","disabled"]},"release_channel":{"type":"string","enum":["stable","prerelease"]},"checks":{"$ref":"req:TargetChecks"},"config":{"anyOf":[{"$ref":"req:TargetConfig"},{"type":"null"}]},"deliveries":{"type":"array","maxItems":2,"items":{"$ref":"req:DeliveryInput"}}}},
+  "req:TargetAdoption": {"type":"object","additionalProperties":false,"properties":{"version":{"type":"string"},"tag":{"type":"string","minLength":1,"maxLength":255}},"required":["version","tag"]},
+  "res:ReleaseResponse": {"allOf":[{"$ref":"res:Release"},{"$ref":"res:ResponseMetadata"}]},
+  "res:Release": {"type":"object","properties":{"id":{"$ref":"res:ReleaseId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"generation_id":{"anyOf":[{"$ref":"res:GenerationId"},{"type":"null"}]},"origin":{"type":"string"},"version":{"type":"string"},"channel":{"type":"string"},"repository":{"anyOf":[{"$ref":"res:RepositoryReferenceResponse"},{"type":"null"}]},"spec_revision_id":{"anyOf":[{"$ref":"res:SpecRevisionId"},{"type":"null"}]},"commit_sha":{"type":"string","pattern":"^[0-9a-fA-F]{40}$"},"checks":{"type":"array","items":{"$ref":"res:PackageCheck"}},"approvals":{"type":"array","items":{"$ref":"res:CompatibilityApproval"}},"import_provenance":{"type":["object","null"],"properties":{"tag":{"type":["string","null"]},"registry_url":{"type":["string","null"]},"artifact_digest":{"type":["string","null"]},"imported_at":{"type":["string","null"]}},"required":["tag","registry_url","artifact_digest","imported_at"]},"publications":{"type":"array","items":{"$ref":"res:Publication"}},"created_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","target_id","generation_id","version","channel","origin","repository","spec_revision_id","commit_sha","checks","approvals","import_provenance","publications","created_at"]},
+  "res:ReleaseId": {"type":"string","pattern":"^rel_[a-z0-9]{16}$"},
+  "res:RepositoryReferenceResponse": {"type":"object","properties":{"provider":{"$ref":"res:RepositoryProvider"},"identifier":{"$ref":"res:RepositoryIdentifier"}},"required":["provider","identifier"]},
+  "res:PackageCheck": {"type":"object","properties":{"name":{"type":"string"},"source":{"type":"string"},"required":{"type":"boolean"},"status":{"type":"string"},"reason":{"type":"string"},"commit_sha":{"type":"string"},"url":{"type":["string","null"]},"observed_at":{"type":["string","null"]}},"required":["name","source","required","status","reason","commit_sha","url","observed_at"]},
+  "res:CompatibilityApproval": {"type":"object","properties":{"source":{"type":"string"},"reason":{"type":"string"},"approved_by":{"type":"string"},"approved_sha":{"type":"string"},"approved_at":{"type":"string"}},"required":["source","reason","approved_by","approved_sha","approved_at"]},
+  "res:Publication": {"type":"object","properties":{"id":{"$ref":"res:PublicationId"},"object":{"type":"string"},"release_id":{"$ref":"res:ReleaseId"},"destination":{"type":"string"},"status":{"type":"string"},"attempt":{"type":"integer","minimum":0},"run_url":{"type":["string","null"]},"registry_url":{"type":["string","null"]},"artifact_digest":{"type":["string","null"]},"errors":{"type":"array","items":{"$ref":"res:DomainError"}},"started_at":{"type":["string","null"]},"finished_at":{"type":["string","null"]},"runtime_ms":{"type":["integer","null"],"minimum":0},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","release_id","destination","status","attempt","run_url","registry_url","artifact_digest","errors","started_at","finished_at","runtime_ms","created_at","updated_at"]},
   "res:PublicationId": {"type":"string","pattern":"^pub_[a-z0-9]{16}$"},
-  "res:TargetDraftResponse": {"allOf":[{"$ref":"res:TargetDraft"},{"$ref":"res:ResponseMetadata"}]},
-  "res:TargetDraft": {"type":"object","properties":{"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"project_id":{"$ref":"res:ProjectId"},"status":{"$ref":"res:DraftStatus"},"current_version":{"type":["string","null"]},"version":{"type":["string","null"]},"selection":{"$ref":"res:TargetDraftSelection"},"readiness":{"anyOf":[{"$ref":"res:TargetDraftReadiness"},{"type":"null"}]},"changes":{"type":["object","null"],"properties":{"changelog":{"type":["string","null"]},"breaking_count":{"type":["integer","null"],"minimum":0},"previous_version":{"type":["string","null"]}}},"head_revision":{"type":["string","null"]},"pull_request_url":{"type":["string","null"]},"generation_id":{"anyOf":[{"$ref":"res:GenerationId"},{"type":"null"}]},"conflicts":{"anyOf":[{"$ref":"res:TargetDraftConflicts"},{"type":"null"}]},"customized_files":{"type":["integer","null"],"minimum":0},"history_recovery":{"anyOf":[{"$ref":"res:TargetDraftHistoryRecovery"},{"type":"null"}]},"request_id":{"$ref":"res:RequestId"},"checks":{"type":"array","items":{"$ref":"res:PackageCheck"}}},"required":["object","target_id","project_id","status","current_version","version","selection","readiness","checks","changes","head_revision","pull_request_url","generation_id","conflicts","customized_files","history_recovery"]},
+  "res:DraftList": {"type":"object","properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:Draft"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
+  "res:Draft": {"type":"object","properties":{"id":{"$ref":"res:DraftId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"project_id":{"$ref":"res:ProjectId"},"status":{"$ref":"res:DraftStatus"},"reason":{"$ref":"res:DraftActionReason"},"version_next":{"type":["string","null"]},"version_source":{"type":["string","null"]},"readiness":{"anyOf":[{"$ref":"res:DraftReadiness"},{"type":"null"}]},"changes":{"type":["object","null"],"properties":{"changelog":{"type":["string","null"]},"breaking_count":{"type":["integer","null"],"minimum":0},"version_previous":{"type":["string","null"]}}},"head_sha":{"type":["string","null"]},"pull_request":{"anyOf":[{"type":"object","properties":{"url":{"type":"string"},"number":{"type":"integer","minimum":1}},"required":["url","number"]},{"type":"null"}]},"generation_id":{"anyOf":[{"$ref":"res:GenerationId"},{"type":"null"}]},"release_id":{"anyOf":[{"$ref":"res:ReleaseId"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"conflicts":{"anyOf":[{"$ref":"res:DraftConflicts"},{"type":"null"}]},"customized_files":{"type":["integer","null"],"minimum":0},"history_recovery":{"anyOf":[{"$ref":"res:DraftHistoryRecovery"},{"type":"null"}]},"request_id":{"$ref":"res:RequestId"},"checks":{"type":"array","items":{"$ref":"res:PackageCheck"}}},"required":["id","object","target_id","project_id","status","version_next","version_source","readiness","checks","changes","head_sha","pull_request","generation_id","release_id","conflicts","customized_files","history_recovery","created_at","updated_at"]},
   "res:DraftStatus": {"type":"string"},
-  "res:TargetDraftSelection": {"anyOf":[{"type":"object","properties":{"mode":{"type":"string"}},"required":["mode"]},{"type":"object","properties":{"mode":{"type":"string"},"version":{"type":"string"},"source":{"type":["string","null"]}},"required":["mode","version","source"]}]},
-  "res:TargetDraftReadiness": {"type":"object","properties":{"state":{"type":"string"},"description":{"type":"string"},"api_compatibility":{"type":"string"},"package_compatibility":{"type":"string"},"version_correct":{"type":["boolean","null"]},"required_bump":{"type":["string","null"]},"previous_version":{"type":["string","null"]},"title_error":{"type":["string","null"]}},"required":["state","description","api_compatibility","package_compatibility","version_correct","required_bump","previous_version","title_error"]},
-  "res:TargetDraftConflicts": {"type":"object","properties":{"total":{"type":"integer","minimum":1},"decided":{"type":"integer","minimum":0}},"required":["total","decided"]},
-  "res:TargetDraftHistoryRecovery": {"type":"object","properties":{"default_revision":{"type":"string"},"head_revision":{"type":["string","null"]},"preserved_branch":{"type":["string","null"]}},"required":["default_revision","head_revision","preserved_branch"]},
-  "req:TargetDraftUpdate": {"type":"object","additionalProperties":false,"properties":{"version":{"type":["string","null"]}},"required":["version"]},
-  "req:TargetAdoption": {"type":"object","additionalProperties":false,"properties":{"version":{"type":"string"},"tag":{"type":"string","minLength":1,"maxLength":255}},"required":["version","tag"]},
-  "res:TargetReleaseResponse": {"allOf":[{"$ref":"res:TargetRelease"},{"$ref":"res:ResponseMetadata"}]},
-  "req:TargetReleaseId": {"type":"string","pattern":"^rel_[a-z0-9]{16}$"},
+  "res:DraftActionReason": {"type":"string"},
+  "res:DraftReadiness": {"type":"object","properties":{"status":{"type":"string"},"description":{"type":"string"},"compatibility_api":{"type":"string"},"compatibility_package":{"type":"string"},"version_correct":{"type":["boolean","null"]},"bump_required":{"type":["string","null"]},"version_previous":{"type":["string","null"]},"title_error":{"type":["string","null"]}},"required":["status","description","compatibility_api","compatibility_package","version_correct","bump_required","version_previous","title_error"]},
+  "res:DraftConflicts": {"type":"object","properties":{"total":{"type":"integer","minimum":1},"decided":{"type":"integer","minimum":0}},"required":["total","decided"]},
+  "res:DraftHistoryRecovery": {"type":"object","properties":{"default_sha":{"type":"string"},"head_sha":{"type":["string","null"]},"preserved_branch":{"type":["string","null"]}},"required":["default_sha","head_sha","preserved_branch"]},
+  "req:DraftStatus": {"type":"string","enum":["none","working","action_required","ready","merged"]},
+  "res:DraftResponse": {"allOf":[{"$ref":"res:Draft"},{"$ref":"res:ResponseMetadata"}]},
+  "req:DraftId": {"type":"string","pattern":"^drf_[a-z0-9]{16}$"},
+  "req:DraftUpdateRequest": {"type":"object","additionalProperties":false,"properties":{"version_next":{"type":["string","null"]}},"required":["version_next"]},
   "res:DraftFileList": {"type":"object","properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:DraftFile"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
-  "res:DraftFile": {"type":"object","properties":{"object":{"type":"string"},"path":{"type":"string"},"customization":{"type":["string","null"]},"conflict":{"anyOf":[{"$ref":"res:DraftFileConflict"},{"type":"null"}]},"history":{"anyOf":[{"$ref":"res:DraftFileHistory"},{"type":"null"}]},"sides":{"type":"array","items":{"$ref":"res:DraftFileSideSummary"}}},"required":["object","path","customization","conflict","history","sides"]},
-  "res:DraftFileConflict": {"type":"object","properties":{"kind":{"type":"string"},"source":{"type":"string"},"decision":{"type":["string","null"]}},"required":["kind","source","decision"]},
+  "res:DraftFile": {"type":"object","properties":{"object":{"type":"string"},"path":{"type":"string"},"customization":{"type":["string","null"]},"conflict":{"anyOf":[{"$ref":"res:DraftFileConflict"},{"type":"null"}]},"history":{"anyOf":[{"$ref":"res:DraftFileHistory"},{"type":"null"}]},"sides":{"anyOf":[{"$ref":"res:DraftFileSides"},{"type":"null"}]}},"required":["object","path","customization","conflict","history","sides"]},
+  "res:DraftFileConflict": {"type":"object","properties":{"type":{"type":"string"},"source":{"type":"string"},"decision":{"type":["string","null"]}},"required":["type","source","decision"]},
   "res:DraftFileHistory": {"type":"object","properties":{"change":{"type":["string","null"]},"draft_differs":{"type":"boolean"}},"required":["change","draft_differs"]},
-  "res:DraftFileSideSummary": {"type":"object","properties":{"side":{"$ref":"res:DraftFileSide"},"mode":{"$ref":"res:GitFileMode"},"size_bytes":{"type":"integer","minimum":0},"encoding":{"type":"string"}},"required":["side","mode","size_bytes","encoding"]},
-  "res:DraftFileSide": {"type":"string"},
-  "res:GitFileMode": {"type":"string"},
-  "res:DraftFileContentResponse": {"allOf":[{"$ref":"res:DraftFileContent"},{"$ref":"res:ResponseMetadata"}]},
-  "res:DraftFileContent": {"type":"object","properties":{"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"path":{"type":"string"},"side":{"$ref":"res:DraftFileSide"},"encoding":{"type":"string"},"content":{"type":"string"},"mode":{"$ref":"res:GitFileMode"},"size_bytes":{"type":"integer","minimum":0},"offset":{"type":"integer","minimum":0},"next_cursor":{"type":["string","null"]}},"required":["object","target_id","path","side","encoding","content","mode","size_bytes","offset","next_cursor"]},
-  "req:DraftFileSide": {"type":"string","enum":["base","repository","incoming","accepted","default","draft"]},
-  "req:ResolveDraftConflicts": {"type":"object","additionalProperties":false,"properties":{"expected_head_revision":{"type":"string","pattern":"^[0-9a-fA-F]{40}$"},"resolutions":{"type":"array","minItems":1,"maxItems":1000,"items":{"$ref":"req:DraftConflictDecision"}},"dry_run":{"type":"boolean"}},"required":["expected_head_revision","resolutions"]},
-  "req:DraftConflictDecision": {"anyOf":[{"type":"object","additionalProperties":false,"properties":{"path":{"type":"string","minLength":1},"keep":{"type":"string","enum":["repository","incoming"]}},"required":["path","keep"]},{"type":"object","additionalProperties":false,"properties":{"path":{"type":"string","minLength":1},"keep":{"type":"string","const":"content"},"content":{"type":"string"},"mode":{"$ref":"req:GitFileMode"}},"required":["path","keep","content","mode"]},{"type":"object","additionalProperties":false,"properties":{"path":{"type":"string","minLength":1},"keep":{"type":"string","const":"content"},"content_base64":{"type":"string"},"mode":{"$ref":"req:GitFileMode"}},"required":["path","keep","content_base64","mode"]},{"type":"object","additionalProperties":false,"properties":{"path":{"type":"string","minLength":1},"keep":{"type":"string","const":"content"},"content":{"type":"null"}},"required":["path","keep","content"]}]},
+  "res:DraftFileSides": {"type":"object","properties":{"base":{"anyOf":[{"$ref":"res:FileId"},{"type":"null"}]},"yours":{"anyOf":[{"$ref":"res:FileId"},{"type":"null"}]},"generated":{"anyOf":[{"$ref":"res:FileId"},{"type":"null"}]}},"required":["base","yours","generated"]},
+  "req:DraftResolveRequest": {"type":"object","additionalProperties":false,"properties":{"expected_head_sha":{"type":"string","pattern":"^[0-9a-fA-F]{40}$"},"resolutions":{"type":"array","minItems":1,"maxItems":1000,"items":{"$ref":"req:DraftConflictDecision"}}},"required":["expected_head_sha","resolutions"]},
+  "req:DraftConflictDecision": {"anyOf":[{"type":"object","additionalProperties":false,"properties":{"path":{"type":"string","minLength":1},"keep":{"type":"string","enum":["yours","generated"]}},"required":["path","keep"]},{"type":"object","additionalProperties":false,"properties":{"path":{"type":"string","minLength":1},"keep":{"type":"string","const":"content"},"content":{"type":"string"},"mode":{"$ref":"req:GitFileMode"}},"required":["path","keep","content","mode"]},{"type":"object","additionalProperties":false,"properties":{"path":{"type":"string","minLength":1},"keep":{"type":"string","const":"content"},"content_base64":{"type":"string"},"mode":{"$ref":"req:GitFileMode"}},"required":["path","keep","content_base64","mode"]},{"type":"object","additionalProperties":false,"properties":{"path":{"type":"string","minLength":1},"keep":{"type":"string","const":"content"},"content":{"type":"null"}},"required":["path","keep","content"]}]},
   "req:GitFileMode": {"type":"string","enum":["100644","100755","120000"]},
-  "res:DraftConflictResolutionResponse": {"allOf":[{"$ref":"res:DraftConflictResolution"},{"$ref":"res:ResponseMetadata"}]},
-  "res:DraftConflictResolution": {"type":"object","properties":{"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"head_revision":{"type":"string"},"status":{"type":"string"},"files":{"type":"array","maxItems":1000,"items":{"$ref":"res:DraftPlannedFile"}},"remaining_conflicts":{"type":"integer","minimum":0}},"required":["object","target_id","head_revision","status","files","remaining_conflicts"]},
-  "res:DraftPlannedFile": {"type":"object","properties":{"path":{"type":"string"},"action":{"type":"string"},"mode":{"anyOf":[{"$ref":"res:GitFileMode"},{"type":"null"}]},"size_bytes":{"type":["integer","null"],"minimum":0}},"required":["path","action","mode","size_bytes"]},
-  "req:DiscardDraftCustomizations": {"type":"object","additionalProperties":false,"properties":{"expected_head_revision":{"type":"string","pattern":"^[0-9a-fA-F]{40}$"},"paths":{"type":"array","minItems":1,"maxItems":1000,"items":{"type":"string","minLength":1}},"dry_run":{"type":"boolean"}},"required":["expected_head_revision","paths"]},
-  "res:DraftCustomizationDiscardResponse": {"allOf":[{"$ref":"res:DraftCustomizationDiscard"},{"$ref":"res:ResponseMetadata"}]},
-  "res:DraftCustomizationDiscard": {"type":"object","properties":{"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"head_revision":{"type":"string"},"status":{"type":"string"},"files":{"type":"array","maxItems":1000,"items":{"$ref":"res:DraftPlannedFile"}}},"required":["object","target_id","head_revision","status","files"]},
-  "req:RecoverDraftHistory": {"type":"object","additionalProperties":false,"properties":{"expected_default_revision":{"type":"string","pattern":"^[a-fA-F0-9]{40}$"},"expected_head_revision":{"type":["string","null"],"pattern":"^[a-fA-F0-9]{40}$"}},"required":["expected_default_revision","expected_head_revision"]},
-  "res:DraftHistoryRecoveryResponse": {"allOf":[{"$ref":"res:DraftHistoryRecovery"},{"$ref":"res:ResponseMetadata"}]},
-  "res:DraftHistoryRecovery": {"type":"object","properties":{"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"status":{"type":"string"},"default_revision":{"type":"string"},"head_revision":{"type":["string","null"]},"preserved_branch":{"type":["string","null"]}},"required":["object","target_id","status","default_revision","head_revision","preserved_branch"]},
-  "res:DeliveryResponse": {"type":"object","properties":{"id":{"$ref":"res:DeliveryId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"kind":{"type":"string"},"state":{"type":"string"},"repository":{"$ref":"res:RepositoryReferenceResponse"},"directory":{"type":["string","null"]},"package_name":{"type":["string","null"]},"module_path":{"type":["string","null"]},"publish_on_merge":{"type":"boolean"},"url":{"type":["string","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","target_id","kind","state","created_at","updated_at","request_id"]},
+  "req:DraftRecoverRequest": {"type":"object","additionalProperties":false,"properties":{"expected_default_sha":{"type":"string","pattern":"^[a-fA-F0-9]{40}$"},"expected_head_sha":{"type":["string","null"],"pattern":"^[a-fA-F0-9]{40}$"}},"required":["expected_default_sha","expected_head_sha"]},
+  "res:ReleaseList": {"type":"object","properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:Release"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
+  "req:ReleaseId": {"type":"string","pattern":"^rel_[a-z0-9]{16}$"},
+  "res:DeliveryList": {"type":"object","properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:Delivery"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
+  "res:DeliveryResponse": {"type":"object","properties":{"id":{"$ref":"res:DeliveryId"},"object":{"type":"string"},"target_id":{"$ref":"res:TargetId"},"type":{"type":"string"},"status":{"type":"string"},"repository":{"$ref":"res:RepositoryDeliverySettings"},"issues":{"type":"array","items":{"$ref":"res:RepositoryDeliveryIssue"}},"required_checks":{"type":"array","items":{"type":"string"}},"last_event":{"anyOf":[{"$ref":"res:RepositoryDeliveryEvent"},{"type":"null"}]},"hosted_mcp":{"$ref":"res:HostedMcpDeliverySettings"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","target_id","type","status","created_at","updated_at","request_id"]},
   "req:DeliveryId": {"type":"string","pattern":"^dlv_[a-z0-9]{16}$"},
-  "res:PublicationResponse": {"allOf":[{"$ref":"res:Publication"},{"type":"object","properties":{"created_at":{"type":"string"}},"required":["created_at"]},{"$ref":"res:ResponseMetadata"}]},
+  "res:PublicationList": {"type":"object","properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:Publication"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
+  "res:PublicationResponse": {"allOf":[{"$ref":"res:Publication"},{"$ref":"res:ResponseMetadata"}]},
   "req:PublicationId": {"type":"string","pattern":"^pub_[a-z0-9]{16}$"},
+  "res:GenerationList": {"type":"object","properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:GenerationSummary"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
+  "req:GenerationStatus": {"type":"string","enum":["queued","running","completed","failed"]},
   "res:GenerationResponse": {"allOf":[{"$ref":"res:Generation"},{"$ref":"res:ResponseMetadata"}]},
-  "res:Generation": {"type":"object","properties":{"id":{"$ref":"res:GenerationId"},"object":{"type":"string"},"files_omitted":{"type":"boolean"},"files_index":{"type":"array","items":{"$ref":"res:FileStub"}},"project_id":{"$ref":"res:ProjectId"},"definition_revision_id":{"anyOf":[{"$ref":"res:DefinitionRevisionId"},{"type":"null"}]},"status":{"$ref":"res:GenerationStatus"},"trigger":{"$ref":"res:GenerationTrigger"},"target_id":{"anyOf":[{"$ref":"res:TargetId"},{"type":"null"}]},"generator":{"$ref":"res:GeneratorKind"},"provenance":{"$ref":"res:GenerationProvenance"},"meta":{"anyOf":[{"$ref":"res:GenerationMeta"},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}},"files":{"type":"array","items":{"$ref":"res:GeneratedFile"}},"errors":{"type":"array","items":{"$ref":"res:DomainError"}},"created_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","definition_revision_id","status","trigger","target_id","generator","provenance","meta","warnings","errors","created_at"]},
-  "res:FileStub": {"type":"object","properties":{"path":{"type":"string"},"bytes":{"type":"integer"},"mode":{"type":"string"}},"required":["path","bytes","mode"]},
   "req:GenerationId": {"type":"string","pattern":"^gen_[a-z0-9]{16}$"},
-  "res:DefinitionRevisionList": {"type":"object","properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:DefinitionRevision"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
-  "res:DefinitionRevision": {"type":"object","properties":{"id":{"$ref":"res:DefinitionRevisionId"},"object":{"type":"string"},"project_id":{"$ref":"res:ProjectId"},"definition_id":{"$ref":"res:DefinitionId"},"format":{"type":"string"},"document_count":{"type":"integer","minimum":1},"documents":{"type":"array","items":{"$ref":"res:DefinitionDocument"}},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"size_bytes":{"type":"integer","minimum":0},"source":{"anyOf":[{"$ref":"res:DefinitionRevisionSource"},{"type":"null"}]},"created_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","project_id","definition_id","format","document_count","sha256","size_bytes","source","created_at"]},
-  "res:DefinitionDocument": {"type":"object","properties":{"id":{"$ref":"res:DefinitionDocumentId"},"role":{"type":"string"},"coordinate":{"type":"string"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"size_bytes":{"type":"integer","minimum":0}},"required":["id","role","coordinate","sha256","size_bytes"]},
-  "res:DefinitionDocumentId": {"type":"string","pattern":"^doc_[a-z0-9]{16}$"},
-  "res:DefinitionRevisionSource": {"anyOf":[{"$ref":"res:UrlDefinitionRevisionSource"},{"$ref":"res:RepositoryDefinitionRevisionSource"}],"responseDiscriminator":{"propertyName":"kind","mapping":{"url":{"$ref":"res:UrlDefinitionRevisionSource"},"repository":{"$ref":"res:RepositoryDefinitionRevisionSource"}}}},
-  "res:UrlDefinitionRevisionSource": {"type":"object","properties":{"kind":{"type":"string"},"url":{"type":"string"}},"required":["kind","url"]},
-  "res:RepositoryDefinitionRevisionSource": {"type":"object","properties":{"kind":{"type":"string"},"repository":{"$ref":"res:RepositoryReferenceResponse"},"path":{"type":"string"},"ref":{"type":["string","null"]},"commit_sha":{"type":["string","null"]}},"required":["kind","repository","path"]},
-  "res:DefinitionRevisionResponse": {"allOf":[{"$ref":"res:DefinitionRevision"},{"$ref":"res:ResponseMetadata"}]},
-  "req:DefinitionRevisionId": {"type":"string","pattern":"^drev_[a-z0-9]{16}$"},
-  "req:DefinitionDocumentId": {"type":"string","pattern":"^doc_[a-z0-9]{16}$"},
-  "res:DefinitionDocumentResponse": {"type":"object","properties":{"id":{"$ref":"res:DefinitionDocumentId"},"object":{"type":"string"},"definition_revision_id":{"$ref":"res:DefinitionRevisionId"},"role":{"type":"string"},"coordinate":{"type":"string"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"size_bytes":{"type":"integer","minimum":0},"created_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","definition_revision_id","role","coordinate","sha256","size_bytes","created_at","request_id"]},
-  "res:Account": {"type":"object","properties":{"id":{"type":"string","pattern":"^org_[A-Za-z0-9]+$"},"object":{"type":"string"},"name":{"type":"string"},"plan":{"type":"string"},"created_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","name","plan","created_at","request_id"]},
+  "res:FileList": {"type":"object","properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:File"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
+  "res:FileResponse": {"allOf":[{"$ref":"res:File"},{"type":"object","properties":{"content":{"type":"string"},"offset":{"type":"integer","minimum":0},"next_cursor":{"type":["string","null"]}},"required":["content","offset","next_cursor"]},{"$ref":"res:ResponseMetadata"}]},
+  "req:FileId": {"type":"string","pattern":"^file_[a-z0-9]{16}$"},
+  "res:Organization": {"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string"},"name":{"type":"string"},"plan":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","name","plan","created_at","updated_at","request_id"]},
   "res:ApiKeyList": {"type":"object","properties":{"object":{"$ref":"res:ListObject"},"data":{"type":"array","items":{"$ref":"res:ApiKey"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"$ref":"res:RequestId"}},"required":["object","data","has_more","next_cursor","request_id"]},
-  "res:ApiKey": {"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string"},"name":{"type":"string"},"last4":{"type":"string"},"revoked":{"type":"boolean"},"last_used_at":{"type":["string","null"]},"created_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","name","last4","revoked","last_used_at","created_at"]},
+  "res:ApiKey": {"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string"},"name":{"type":"string"},"last4":{"type":"string"},"revoked":{"type":"boolean"},"last_used_at":{"type":["string","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"request_id":{"$ref":"res:RequestId"}},"required":["id","object","name","last4","revoked","last_used_at","created_at","updated_at"]},
   "res:ApiKeyResponse": {"allOf":[{"$ref":"res:ApiKey"},{"$ref":"res:ResponseMetadata"}]},
 };