Merge branch 'main' into fine/add-readfile-filter

Author: PavelLinearB

.cm/ask-ai.cm

@@ -18,7 +18,7 @@ automations:
           comment: |
             # 📜 PR Summary 📜
             {{ source | askAI("
-              Summarize in simple terms the changes in this PR using bullet points.", env.OPEN_AI_TOKEN) | encode }}
+              Summarize in simple terms the changes in this PR using bullet points.", env.OPEN_AI_TOKEN) }}
 
   cr_code_changes:
     if:
@@ -33,7 +33,7 @@ automations:
               - Finding bugs, security risks, and performance issues
               - Verify best practices and style guide violations
               - Specific improvement suggestions based on the changes",
-              env.OPEN_AI_TOKEN) | encode }}
+              env.OPEN_AI_TOKEN) }}
 
 
 

README.md

@@ -61,7 +61,7 @@ Our research shows that code reviews are [the most consistent bottleneck in the
 
 ## 🚀 Get Started
 
-gitStream is a GitHub / GitLab app that processes automations defined in Continuous Merge (CM) automation files contained in your git repos. You can test gitStream automations on your own PRs via the [gitStream playground](https://app.gitstream.cm/playground).
+gitStream is a GitHub / GitLab / Bitbucket app that processes automations defined in Continuous Merge (CM) automation files contained in your git repos. You can test gitStream automations on your own PRs via the [gitStream playground](https://app.gitstream.cm/playground).
 
 If you're ready to install gitStream, or want to explore its automation capabilities, [head over to the docs](https://docs.gitstream.cm). You can have your first automation up and running in as little as 2 minutes.
 
@@ -92,4 +92,4 @@ gitStream is a free product from the team at [LinearB](https://linearb.io/?utm_s
     <img alt="Novu Logo" src="https://raw.githubusercontent.com/linear-b/gitstream/a5d4aca7b923e5cd70c813df06dc70de97382d8c/docs/downloads/images/LinearB-logo-dark.png" width="280"/>
   </picture>
   </a>
-</div>
+</div>

docs/automation-actions.md

@@ -12,31 +12,32 @@ Actions are the end results of the automation described in your `.cm` file.
 
     - :fontawesome-brands-github: Supported on GitHub
     - :fontawesome-brands-gitlab: Supported on GitLab
+    - :fontawesome-brands-bitbucket: Supported on Bitbucket
     - :fontawesome-solid-flask: Open beta - Feature is under development and currently available for all
 
 ## Overview
 
 [`send-http-request`](#send-http-request) is executed immediately after the evaluation of the condition.
 For all other actions, gitStream executes the actions in the order they are listed per automation. If an action result fails, the following actions will not be executed.
 
-- [`add-comment`](#add-comment) :fontawesome-brands-github: :fontawesome-brands-gitlab:
+- [`add-comment`](#add-comment) :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
 - [`add-github-check`](#add-github-check) :fontawesome-brands-github:
 - [`add-label`](#add-label) :fontawesome-brands-github: :fontawesome-brands-gitlab:
 - [`add-labels`](#add-labels) :fontawesome-brands-github: :fontawesome-brands-gitlab:
-- [`add-reviewers`](#add-reviewers) :fontawesome-brands-github: :fontawesome-brands-gitlab:
+- [`add-reviewers`](#add-reviewers) :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
 - [`add-thread`](#add-thread) :fontawesome-brands-gitlab:
-- [`approve`](#approve) :fontawesome-brands-github: :fontawesome-brands-gitlab:
-- [`close`](#close) :fontawesome-brands-github: :fontawesome-brands-gitlab:
-- [`explain-code-experts`](#explain-code-experts) :fontawesome-brands-github: :fontawesome-brands-gitlab:
-- [`merge`](#merge) :fontawesome-brands-github: :fontawesome-brands-gitlab:
-- [`request-changes`](#request-changes) :fontawesome-brands-github: :fontawesome-brands-gitlab:
+- [`approve`](#approve) :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
+- [`close`](#close) :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
+- [`explain-code-experts`](#explain-code-experts) :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
+- [`merge`](#merge) :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
+- [`request-changes`](#request-changes) :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
 - [`require-reviewers`](#require-reviewers) :fontawesome-brands-github:
 - [`run-github-workflow`](#run-github-workflow) :fontawesome-brands-github:
-- [`send-http-request`](#send-http-request) :fontawesome-brands-github:
-- [`send-slack-message`](#send-slack-message) :fontawesome-brands-github:
+- [`send-http-request`](#send-http-request) :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
+- [`send-slack-message`](#send-slack-message) :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
 - [`set-required-approvals`](#set-required-approvals) :fontawesome-brands-github:
-- [`update-description`](#update-description) :fontawesome-brands-github:
-- [`update-title`](#update-title) :fontawesome-brands-github:
+- [`update-description`](#update-description) :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
+- [`update-title`](#update-title) :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
 
 !!! note
 
@@ -60,7 +61,7 @@ automations:
 
 ## Reference
 
-#### `add-comment` :fontawesome-brands-github: :fontawesome-brands-gitlab:
+#### `add-comment` :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
 
 This action, once triggered, adds a comment to the PR.
 
@@ -156,7 +157,7 @@ This is a managed action, when a PR updates existing labels that were added by g
 </div>
 
 
-#### `add-reviewers` :fontawesome-brands-github: :fontawesome-brands-gitlab:
+#### `add-reviewers` :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
 
 This action, once triggered, sets a specific reviewer.
 
@@ -211,7 +212,7 @@ automations:
           comment: "Please make sure this change request is documented before merging"
 ```
 
-#### `explain-code-experts` :fontawesome-brands-github: :fontawesome-brands-gitlab:
+#### `explain-code-experts` :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
 
 This action, shall add a comment with codeExperts suggestion. If the comment already exists, the comment shall be edited.
 
@@ -236,7 +237,7 @@ automations:
           gt: 10
 ```
 
-#### `approve` :fontawesome-brands-github: :fontawesome-brands-gitlab:
+#### `approve` :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
 
 This action, once triggered, approves the PR for merge.
 
@@ -251,7 +252,7 @@ automations:
       - action: approve@v1
 ```
 
-#### `close` :fontawesome-brands-github: :fontawesome-brands-gitlab:
+#### `close` :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
 
 This action, once triggered, close the PR without merging.
 
@@ -269,7 +270,7 @@ automations:
       - action: close@v1
 ```
 
-#### `merge` :fontawesome-brands-github: :fontawesome-brands-gitlab:
+#### `merge` :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
 
 Once triggered, merge the PR if possible. It can be set to wait for all checks to pass or only required ones.
 
@@ -294,7 +295,7 @@ automations:
           rebase_on_merge: true
 ```
 
-#### `request-changes` :fontawesome-brands-github: :fontawesome-brands-gitlab:
+#### `request-changes` :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
 
 This action, once triggered, requests changes on the PR. As long as request change is set, gitStream will block the PR merge.
 
@@ -401,7 +402,7 @@ has:
   	* We encourage you to use this action with [custom triggers](./execution-model.md#explicit-triggers)
    	* To manually test the webhook dispatch, please [run the workflow](https://docs.github.com/en/actions/managing-workflow-runs-and-deployments/managing-workflow-runs/manually-running-a-workflow#running-a-workflow){:target="_blank"} before using it with gitStream.
 
-#### `send-http-request` :fontawesome-brands-github:
+#### `send-http-request` :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
 
 The action, once triggered, sends an HTTP request to the specified URL
 <div class="filter-details" markdown=1>
@@ -431,7 +432,7 @@ automations:
           body: '{"text": "Hello, world!"}'
 ```
 
-#### `send-slack-message` :fontawesome-brands-github:
+#### `send-slack-message` :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
 
 The action, once triggered, sends a webhook with a message content to a Slack app.
 To use this action, [create a Slack app](https://api.slack.com/messaging/webhooks#getting_started) with Incoming Webhooks enabled. gitStream uses the webhook URL to send the message.
@@ -485,7 +486,7 @@ automations:
 
     To allow this action to block merge, you should enable branch protection, and gitStream has to be set as required check in GitHub.
 
-#### `update-description` :fontawesome-brands-github:
+#### `update-description` :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
 This action, when triggered, updates the PR description with new content.
 
 This is a managed action. When a PR updates, the existing comments that were added by gitStream are re-evaluated, and those that are not applicable are removed.
@@ -520,7 +521,7 @@ jira_ticket_from_title: {{ pr.title | capture(regex=r/\b[A-Za-z]+-\d+\b/) }}
 ```
 
 
-#### `update-title` :fontawesome-brands-github:
+#### `update-title` :fontawesome-brands-github: :fontawesome-brands-gitlab: :fontawesome-brands-bitbucket:
 This action, when triggered, updates the PR title with new content.
 
 This is a managed action. When a PR updates, the existing comments that were added by gitStream are re-evaluated, and those that are not applicable are removed.

docs/automations/integrations/askAI/add-tests/README.md

@@ -2,6 +2,7 @@
 title: Automation - Ask AI to Suggest Tests
 description: Use gitStream's integration with AI services to suggests additional tests
 category: [quality, genai, copilot, tests, efficiency]
+starter_kits: [genai]
 ---
 # Ask AI to Suggest Tests
 

docs/automations/integrations/askAI/add-tests/askAI-tests.svg

@@ -0,0 +1,41 @@
+---
+title: Automation - Ask AI to Summarize the Changes in a PR
+description: Use gitStream's integration with AI services to generate a summary of the changes in the PR.
+category: [quality, genai, copilot, tests, efficiency]
+---
+# Ask AI to Summarize the Changes in a PR
+
+<!-- --8<-- [start:example]-->
+Use AI to generate a concise bullet-point summary of the changes in the pull request.
+
+!!! info "Configuration Description"
+
+    Conditions (all must be true):
+
+    * A PR is created or new code has been committed to the PR.
+    * The PR has a label "askai summarize"
+
+    Automation Actions:
+
+    * Add a comment with a summary of the PR
+
+!!! example "Configuration Example"
+    ```yaml+jinja
+    --8<-- "docs/downloads/automation-library/integrations/askAI/askAI_summarize.cm"
+    ```
+    <div class="result" markdown>
+        <span>
+        [:octicons-download-24: Download this example as a CM file.](/downloads/automation-library/integrations/askAI/askAI_summarize.cm){ .md-button }
+        </span>
+    </div>
+<!-- --8<-- [end:example]-->
+
+## Additional Resources
+
+--8<-- "docs/snippets/general.md"
+
+**Related Automations**:
+
+--8<-- "docs/snippets/context-automation.md"
+
+--8<-- "docs/snippets/automation-footer.md"

docs/automations/integrations/askAI/ask-anything/README.md_tmp

@@ -2,6 +2,7 @@
 title: Automation - Ask AI for a Code Review
 description: Use gitStream's integration with AI services to perform a comprehensive code review to your code
 category: [quickstart, quality, genai, copilot, tests, efficiency]
+starter_kits: [genai]
 ---
 # Ask AI for a Code Review