API Evangelist conversational phrasing for TextQL Ontology Management Service API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for TextQL Ontology Management Service API
  version: 1.0.0
extends: openapi/textql-ontologymanagementservice-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 69
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/AddOntologySubmodule'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a git submodule to the Ontology
      effect: write
      questions:
      - Can I pull another git repository into my TextQL Ontology as a submodule?
      - Which branch does an Ontology submodule track when I mount an external repo?
      instructions:
      - text: Add the repo at {url} as an Ontology submodule mounted at {path}.
        slots:
          url: requestBody.url
          path: requestBody.path
      - text: Mount submodule {url} at {path} tracking branch {branch}.
        slots:
          url: requestBody.url
          path: requestBody.path
          branch: requestBody.branch
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ApprovePatch'].post
  update:
    x-apievangelist-phrasing:
      intent: Approve a pending Ontology patch
      effect: write
      questions:
      - What do I need to sign off on a patch someone proposed to the Ontology?
      - Why does approving an Ontology patch ask for the expected git ref?
      instructions:
      - text: Approve Ontology patch {patchId} at git ref {expectedGitRef}.
        slots:
          patchId: requestBody.patchId
          expectedGitRef: requestBody.expectedGitRef
      - text: Give my approval to patch {patchId} so it can merge.
        slots:
          patchId: requestBody.patchId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ConfigureOntologyRemote'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect the Ontology to a remote git repository
      effect: write
      questions:
      - How do I link my Ontology to a hosted git repo so changes sync both ways?
      - 'Which auth methods can the Ontology git remote use: access token, SSH key or an app installation?'
      - Can I sign commits that the Ontology pushes to its remote?
      instructions:
      - text: Set the Ontology git remote to {remoteUrl} with default branch {defaultBranch}.
        slots:
          remoteUrl: requestBody.remoteUrl
          defaultBranch: requestBody.defaultBranch
      - text: Connect the Ontology to {remoteUrl} using auth type {authType} and push mode {pushMode}.
        slots:
          remoteUrl: requestBody.remoteUrl
          authType: requestBody.authType
          pushMode: requestBody.pushMode
      - text: Configure remote {remoteUrl} through the hosted git app integration.
        slots:
          remoteUrl: requestBody.remoteUrl
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/CreateApprovalRule'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an Ontology approval rule
      effect: write
      questions:
      - Can I require a certain number of reviewers before Ontology patches merge?
      - What does a new approval rule for Ontology folders look like?
      instructions:
      - text: Create a new Ontology approval rule defined as {rule}.
        slots:
          rule: requestBody.rule
      - text: Add approval rule {rule} to govern patch merges.
        slots:
          rule: requestBody.rule
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/CreateContextPatchAutoApproveRule'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a rule that auto-approves context patches
      effect: write
      questions:
      - Can some context patches merge automatically without a human reviewer?
      - How do I set up auto-approval for low-risk context changes?
      instructions:
      - text: 'Create a context patch auto-approve rule: {rule}.'
        slots:
          rule: requestBody.rule
      - text: Add auto-approve rule {rule} so matching context patches skip review.
        slots:
          rule: requestBody.rule
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/CreateOntologyDirectory'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a folder in the Ontology
      effect: write
      questions:
      - How do I add a new folder to the Ontology library?
      - Does creating an Ontology directory produce a commit with a message?
      instructions:
      - text: Create Ontology directory {path}.
        slots:
          path: requestBody.path
      - text: Make folder {path} in the Ontology with commit message {commitMessage}.
        slots:
          path: requestBody.path
          commitMessage: requestBody.commitMessage
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/CreateOntologyFileUploadUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get an upload URL for a new Ontology file
      effect: write
      questions:
      - How do I upload a large binary file into the Ontology?
      - Do I need to state the MIME type and size before uploading an Ontology file?
      instructions:
      - text: Get an upload URL for Ontology file {path} of type {mimeType} and {sizeBytes} bytes.
        slots:
          path: requestBody.path
          mimeType: requestBody.mimeType
          sizeBytes: requestBody.sizeBytes
      - text: Start an upload for {path} into the Ontology.
        slots:
          path: requestBody.path
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/DeleteApprovalRule'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete an Ontology approval rule
      effect: destructive
      questions:
      - How do I remove an approval rule that patches no longer need to satisfy?
      - What happens to merge requirements when I delete an approval rule?
      instructions:
      - text: Delete Ontology approval rule {id}.
        slots:
          id: requestBody.id
      - text: Remove the merge approval requirement with rule id {id}.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/DeleteContextPatchAutoApproveRule'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a context patch auto-approve rule
      effect: destructive
      questions:
      - How do I stop context patches from being auto-approved?
      - Can I drop a single auto-approve rule and keep the others?
      instructions:
      - text: Delete context patch auto-approve rule {id}.
        slots:
          id: requestBody.id
      - text: Turn off auto-approval by removing rule {id}.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/DeleteOntologyDirectory'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a folder from the Ontology
      effect: destructive
      questions:
      - Can I delete an Ontology folder along with everything inside it?
      - What happens if I remove a non-empty Ontology directory without the recursive flag?
      instructions:
      - text: Delete Ontology directory {path} recursively.
        slots:
          path: requestBody.path
      - text: Remove folder {path} from the Ontology with commit message {commitMessage}.
        slots:
          path: requestBody.path
          commitMessage: requestBody.commitMessage
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/DeleteOntologyFile'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a file from the Ontology
      effect: destructive
      questions:
      - How do I delete a single file from the Ontology library?
      - Is deleting an Ontology file recorded as a commit?
      instructions:
      - text: Delete Ontology file {path}.
        slots:
          path: requestBody.path
      - text: Remove file {path} from the Ontology, committing with {commitMessage}.
        slots:
          path: requestBody.path
          commitMessage: requestBody.commitMessage
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/DenyPatch'].post
  update:
    x-apievangelist-phrasing:
      intent: Deny a pending Ontology patch
      effect: write
      questions:
      - How do I reject a patch someone proposed to the Ontology?
      - Can a denied Ontology patch be brought back later?
      instructions:
      - text: Deny Ontology patch {patchId} at git ref {expectedGitRef}.
        slots:
          patchId: requestBody.patchId
          expectedGitRef: requestBody.expectedGitRef
      - text: Reject proposed patch {patchId}.
        slots:
          patchId: requestBody.patchId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ExchangeOntologyGithubCode'].post
  update:
    x-apievangelist-phrasing:
      intent: Finish GitHub OAuth for the Ontology remote
      effect: write
      questions:
      - After the git host redirects back, how do I complete the Ontology connection with the auth code?
      - Does finishing the Ontology git OAuth flow need a PKCE code verifier?
      instructions:
      - text: Exchange OAuth code {code} with state {state} to finish linking the Ontology repo.
        slots:
          code: requestBody.code
          state: requestBody.state
      - text: Complete the Ontology repo OAuth using code {code} and verifier {codeVerifier}.
        slots:
          code: requestBody.code
          codeVerifier: requestBody.codeVerifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/FinalizeOntologyFileUpload'].post
  update:
    x-apievangelist-phrasing:
      intent: Commit an uploaded file into the Ontology
      effect: write
      questions:
      - Once my file is uploaded, how do I commit it into the Ontology?
      - What upload key do I pass to finalize an Ontology file upload?
      instructions:
      - text: Finalize the upload {uploadKey} as Ontology file {path}.
        slots:
          uploadKey: requestBody.uploadKey
          path: requestBody.path
      - text: Commit uploaded file {path} with message {commitMessage}.
        slots:
          path: requestBody.path
          commitMessage: requestBody.commitMessage
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetCodeownerCoverage'].post
  update:
    x-apievangelist-phrasing:
      intent: Check how much of the Ontology has owners
      effect: read
      questions:
      - Which parts of my Ontology have no code owners assigned?
      - How much of the Ontology is covered by OWNERS rules?
      instructions:
      - text: Show the Ontology's codeowner coverage.
      - text: Report OWNERS coverage across the Ontology, timing out after {timeout_ms} ms.
        slots:
          timeout_ms: header.Connect-Timeout-Ms
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetConfigExportCapabilities'].post
  update:
    x-apievangelist-phrasing:
      intent: See which objects can be exported as config
      effect: read
      questions:
      - Which object types can I save into the Ontology as config files?
      - Am I allowed to export dashboards and playbooks as config?
      instructions:
      - text: List my config export capabilities.
      - text: Check config export permissions with a {timeout_ms} ms timeout.
        slots:
          timeout_ms: header.Connect-Timeout-Ms
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetEffectiveOntologyOwners'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the owners that actually apply to a path
      effect: read
      questions:
      - Who effectively owns this Ontology path once inherited OWNERS rules are applied?
      - Which owners govern a file that has no OWNERS entry of its own?
      instructions:
      - text: Show the effective owners for Ontology path {path}.
        slots:
          path: requestBody.path
      - text: Resolve inherited ownership for {path}.
        slots:
          path: requestBody.path
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetFileUsage'].post
  update:
    x-apievangelist-phrasing:
      intent: Rank Ontology files by usage
      effect: read
      questions:
      - Which Ontology files get used the most in chats?
      - Can I see file usage for just one folder over a chosen period?
      instructions:
      - text: Rank Ontology files under {pathPrefix} by usage over {observationPeriod}.
        slots:
          pathPrefix: requestBody.pathPrefix
          observationPeriod: requestBody.observationPeriod
      - text: List file usage sorted {order}, {pageSize} per page.
        slots:
          order: requestBody.order
          pageSize: requestBody.pageSize
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetFileUsageTimeline'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart Ontology file usage over time
      effect: read
      questions:
      - How has usage of files in an Ontology folder trended over time?
      - Is there a day-by-day timeline of Ontology file usage?
      instructions:
      - text: Show the usage timeline for files under {pathPrefix}.
        slots:
          pathPrefix: requestBody.pathPrefix
      - text: Chart file usage under {pathPrefix} across {observationPeriod}.
        slots:
          pathPrefix: requestBody.pathPrefix
          observationPeriod: requestBody.observationPeriod
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologyAnaConfig'].post
  update:
    x-apievangelist-phrasing:
      intent: Read the Ana config for an Ontology folder
      effect: read
      questions:
      - What Ana configuration is set on this Ontology folder?
      - Is auto-attach turned on for a given Ontology path?
      instructions:
      - text: Get the Ana config at Ontology path {path}.
        slots:
          path: requestBody.path
      - text: Show auto-attach and codeowner settings for {path}.
        slots:
          path: requestBody.path
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologyFile'].post
  update:
    x-apievangelist-phrasing:
      intent: Read a file from the Ontology
      effect: read
      questions:
      - How do I fetch the contents of one Ontology file?
      - Can I read a context file straight from the Ontology library?
      instructions:
      - text: Open Ontology file {path}.
        slots:
          path: requestBody.path
      - text: Show me the current contents of {path} in the Ontology.
        slots:
          path: requestBody.path
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologyGithubOAuthURL'].post
  update:
    x-apievangelist-phrasing:
      intent: Start GitHub OAuth for the Ontology remote
      effect: read
      questions:
      - Where do I send a user to authorize repo access for the Ontology?
      - Does the Ontology repo authorize link support a PKCE code challenge?
      instructions:
      - text: Get the repo OAuth authorize URL for the Ontology with state {state}.
        slots:
          state: requestBody.state
      - text: Build the Ontology repo authorize link using challenge {codeChallenge}.
        slots:
          codeChallenge: requestBody.codeChallenge
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologyHistoryFileDiff'].post
  update:
    x-apievangelist-phrasing:
      intent: Show a file's diff in a past Ontology commit
      effect: read
      questions:
      - What changed in a specific file in an earlier Ontology commit?
      - Can I see the diff for one path in Ontology history?
      instructions:
      - text: Show the diff of {path} in Ontology commit {commitId}.
        slots:
          path: requestBody.path
          commitId: requestBody.commitId
      - text: Show the file diff from Ontology commit {commitId}.
        slots:
          commitId: requestBody.commitId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologyOwners'].post
  update:
    x-apievangelist-phrasing:
      intent: Read the OWNERS entries set on a path
      effect: read
      questions:
      - What OWNERS entries are defined directly on this Ontology folder?
      - How do I check who is listed as owner of a specific Ontology path?
      instructions:
      - text: Get the OWNERS entries declared on {path}.
        slots:
          path: requestBody.path
      - text: List owners configured on Ontology folder {path}.
        slots:
          path: requestBody.path
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologyRemote'].post
  update:
    x-apievangelist-phrasing:
      intent: Show the Ontology's git remote settings
      effect: read
      questions:
      - Which git repository is my Ontology connected to?
      - What push mode and default branch does the Ontology remote use?
      instructions:
      - text: Show the Ontology git remote configuration.
      - text: Fetch remote settings for the Ontology within {timeout_ms} ms.
        slots:
          timeout_ms: header.Connect-Timeout-Ms
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologySizeTimeline'].post
  update:
    x-apievangelist-phrasing:
      intent: Track the Ontology's size over time
      effect: read
      questions:
      - How has the number of files in my Ontology grown?
      - Is there a size history for the Ontology over a chosen period?
      instructions:
      - text: Show the Ontology size timeline for {observationPeriod}.
        slots:
          observationPeriod: requestBody.observationPeriod
      - text: Chart how big the Ontology has gotten.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologySyncConflicts'].post
  update:
    x-apievangelist-phrasing:
      intent: List git sync conflicts in the Ontology
      effect: read
      questions:
      - Are there merge conflicts blocking my Ontology from syncing with its remote?
      - Which files conflict between the Ontology and the remote repo?
      instructions:
      - text: Show outstanding Ontology sync conflicts.
      - text: Check for remote sync conflicts with a {timeout_ms} ms deadline.
        slots:
          timeout_ms: header.Connect-Timeout-Ms
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologyUsageSummary'].post
  update:
    x-apievangelist-phrasing:
      intent: Summarize Ontology usage
      effect: read
      questions:
      - How heavily is the Ontology being used overall?
      - Can I get a headline usage summary of the Ontology for the last period?
      instructions:
      - text: Summarize Ontology usage over {observationPeriod}.
        slots:
          observationPeriod: requestBody.observationPeriod
      - text: Give me the overall Ontology usage summary.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetPatch'].post
  update:
    x-apievangelist-phrasing:
      intent: Get an Ontology patch by id
      effect: read
      questions:
      - How do I look up an Ontology patch using its id?
      - Can I view an older revision of an Ontology patch?
      instructions:
      - text: Get Ontology patch {patchId}.
        slots:
          patchId: requestBody.patchId
      - text: Show revision {revision} of patch {patchId}.
        slots:
          revision: requestBody.revision
          patchId: requestBody.patchId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetPatchByNumber'].post
  update:
    x-apievangelist-phrasing:
      intent: Get an Ontology patch by its number
      effect: read
      questions:
      - Can I open an Ontology patch using its short number instead of the id?
      - Where do I find patch number 42 from the review list?
      instructions:
      - text: Open Ontology patch number {number}.
        slots:
          number: requestBody.number
      - text: Look up the patch numbered {number}.
        slots:
          number: requestBody.number
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetPatchCapabilities'].post
  update:
    x-apievangelist-phrasing:
      intent: See what actions I can take on a patch
      effect: read
      questions:
      - Am I allowed to approve, deny or revert this Ontology patch?
      - Which review actions are open to me on a given patch?
      instructions:
      - text: Check my capabilities on patch {patchId}.
        slots:
          patchId: requestBody.patchId
      - text: Tell me which actions I can take on Ontology patch {patchId}.
        slots:
          patchId: requestBody.patchId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetRawPatch'].post
  update:
    x-apievangelist-phrasing:
      intent: Download the raw diff of an Ontology patch
      effect: read
      questions:
      - Can I get the raw git patch text for an Ontology change?
      - How do I export a patch as a plain diff?
      instructions:
      - text: Get the raw patch text for patch number {patchNumber}.
        slots:
          patchNumber: requestBody.patchNumber
      - text: Export patch {patchNumber} as a unified diff.
        slots:
          patchNumber: requestBody.patchNumber
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetUsageDetailsForFile'].post
  update:
    x-apievangelist-phrasing:
      intent: Get usage details for one Ontology file
      effect: read
      questions:
      - How often is a particular Ontology file used, and by whom?
      - Can I drill into the usage of a single file over a period?
      instructions:
      - text: Show usage details for Ontology file {filePath}.
        slots:
          filePath: requestBody.filePath
      - text: Break down usage of {filePath} over {observationPeriod}.
        slots:
          filePath: requestBody.filePath
          observationPeriod: requestBody.observationPeriod
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListApprovalRules'].post
  update:
    x-apievangelist-phrasing:
      intent: List Ontology approval rules
      effect: read
      questions:
      - What approval rules currently gate Ontology patch merges?
      - Which folders require reviewers before patches can merge?
      instructions:
      - text: List all Ontology approval rules.
      - text: Show the approval rules, waiting at most {timeout_ms} ms.
        slots:
          timeout_ms: header.Connect-Timeout-Ms
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListChatsForFile'].post
  update:
    x-apievangelist-phrasing:
      intent: List chats that used an Ontology file
      effect: read
      questions:
      - Which chats pulled in a given Ontology file?
      - Can I see the conversations that referenced a context file recently?
      instructions:
      - text: List chats that used {filePath}.
        slots:
          filePath: requestBody.filePath
      - text: Show up to {limit} chats referencing {filePath} during {observationPeriod}.
        slots:
          limit: requestBody.limit
          filePath: requestBody.filePath
          observationPeriod: requestBody.observationPeriod
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListContextPatchAutoApproveRules'].post
  update:
    x-apievangelist-phrasing:
      intent: List context patch auto-approve rules
      effect: read
      questions:
      - Which rules let context patches merge without review?
      - What auto-approve rules exist for context patches today?
      instructions:
      - text: List the context patch auto-approve rules.
      - text: Show all auto-approve rules with a {timeout_ms} ms timeout.
        slots:
          timeout_ms: header.Connect-Timeout-Ms
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListGoldenFiles'].post
  update:
    x-apievangelist-phrasing:
      intent: List Ontology files marked golden (deprecated)
      effect: read
      questions:
      - Which Ontology files are flagged as golden?
      - Is the golden files list still supported now that OWNERS exists?
      instructions:
      - text: List the golden Ontology files.
      - text: Fetch the legacy golden file list within {timeout_ms} ms.
        slots:
          timeout_ms: header.Connect-Timeout-Ms
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListOntologyEntries'].post
  update:
    x-apievangelist-phrasing:
      intent: Browse files and folders in the Ontology
      effect: read
      questions:
      - How do I browse the contents of an Ontology folder?
      - Can I list everything under an Ontology path recursively, including debug files?
      instructions:
      - text: List the entries in Ontology folder {path}.
        slots:
          path: requestBody.path
      - text: Recursively list everything under {path} in the Ontology.
        slots:
          path: requestBody.path
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListOntologyHistory'].post
  update:
    x-apievangelist-phrasing:
      intent: List the Ontology's commit history
      effect: read
      questions:
      - What is the recent commit history of my Ontology?
      - Can I see the change history for just one Ontology path?
      instructions:
      - text: Show the Ontology commit history for {path}.
        slots:
          path: requestBody.path
      - text: List the last {pageSize} Ontology commits.
        slots:
          pageSize: requestBody.pageSize
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListOntologyImports'].post
  update:
    x-apievangelist-phrasing:
      intent: List imports into the Ontology
      effect: read
      questions:
      - What has been imported into my Ontology?
      - Is there a record of Ontology imports I can review?
      instructions:
      - text: List Ontology imports.
      - text: Show the Ontology import list, waiting up to {timeout_ms} ms.
        slots:
          timeout_ms: header.Connect-Timeout-Ms
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListOntologySubmodules'].post
  update:
    x-apievangelist-phrasing:
      intent: List git submodules in the Ontology
      effect: read
      questions:
      - Which external repos are mounted as submodules in the Ontology?
      - Where are the Ontology submodules mounted and which branches do they track?
      instructions:
      - text: List the Ontology's submodules.
      - text: Show every mounted submodule with a {timeout_ms} ms timeout.
        slots:
          timeout_ms: header.Connect-Timeout-Ms
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListOntologySyncRuns'].post
  update:
    x-apievangelist-phrasing:
      intent: List past Ontology sync runs
      effect: read
      questions:
      - When did the Ontology last sync with its git remote, and did it succeed?
      - Can I page through the history of Ontology sync runs?
      instructions:
      - text: List recent Ontology sync runs.
      - text: Show {pageSize} sync runs starting from page token {pageToken}.
        slots:
          pageSize: requestBody.pageSize
          pageToken: requestBody.pageToken
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListPatchObjects'].post
  update:
    x-apievangelist-phrasing:
      intent: List the config objects in a patch
      effect: read
      questions:
      - Which playbooks and dashboards does a patch's config touch?
      - Can I see the display names and types of objects at a patch's git ref?
      instructions:
      - text: List the config objects in patch ref {patchRef}.
        slots:
          patchRef: requestBody.patchRef
      - text: Show object types and Library paths at {patchRef}.
        slots:
          patchRef: requestBody.patchRef
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListPatchReviewers'].post
  update:
    x-apievangelist-phrasing:
      intent: List reviewers on an Ontology patch
      effect: read
      questions:
      - Who has been asked to review this Ontology patch?
      - Which reviewers are assigned to a given patch?
      instructions:
      - text: List reviewers for patch {patchId}.
        slots:
          patchId: requestBody.patchId
      - text: Show who is reviewing Ontology patch {patchId}.
        slots:
          patchId: requestBody.patchId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListPatches'].post
  update:
    x-apievangelist-phrasing:
      intent: List Ontology patches
      effect: read
      questions:
      - What Ontology patches are open and waiting for review?
      - Can I filter Ontology patches by status and hide auto-approved ones?
      instructions:
      - text: List Ontology patches with status {statuses}.
        slots:
          statuses: requestBody.statuses
      - text: Show the {pageSize} most recent patches, including auto-approved ones.
        slots:
          pageSize: requestBody.pageSize
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListSkills'].post
  update:
    x-apievangelist-phrasing:
      intent: List skills available in the Ontology
      effect: read
      questions:
      - Which skills can I invoke with the slash autocomplete in chat?
      - Can I include unlisted skills when listing Ontology skills?
      instructions:
      - text: List the Ontology skills I can read.
      - text: List skills with include unlisted set to {includeUnlisted}.
        slots:
          includeUnlisted: requestBody.includeUnlisted
      method: generated
      generated: '2026-10-01'


# --- truncated at 32 KB (47 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/textql/refs/heads/main/overlays/textql-ontologymanagementservice-api-phrasing-overlay.yaml