Merge branch 'main' into OCEAN-27-MULTIPLE-WORKERS-DOC-GITHUB-OCEAN

Author: hadar-co

.github/workflows/claude-pr-reviewer.yml

@@ -35,8 +35,8 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       contents: read
-      pull-requests: read
-      issues: read
+      pull-requests: write
+      issues: write
       id-token: write
     steps:
       - name: Checkout repository
@@ -49,6 +49,23 @@ jobs:
           git config --global user.name "Port Claude AI"
           git config --global user.email "port-claude-ai@port.io"
 
+      - name: Find and Delete Last Claude Comment
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          echo "Looking for the last Claude comment to delete..."
+          
+          # Get the last Claude comment ID (trying common patterns)
+          last_claude_comment=$(gh api repos/${{ github.repository }}/issues/${{ github.event.pull_request.number }}/comments \
+            --jq '.[] | select(.user.login | test("claude"; "i")) | .id' | tail -1)
+          
+          if [ ! -z "$last_claude_comment" ]; then
+            echo "Deleting last Claude comment ID: $last_claude_comment"
+            gh api repos/${{ github.repository }}/issues/comments/$last_claude_comment -X DELETE
+          else
+            echo "No Claude comments found to delete"
+          fi
+
       - name: Run Claude PR Action
         uses: anthropics/claude-code-action@beta
         with:

docs/actions-and-automations/define-automations/setup-trigger.md

@@ -247,8 +247,13 @@ The table below describes the fields in the JSON structure under the `trigger` k
 | **`type`** | The automation's trigger type. Should be set to `automation`. |
 | **`event`** | An object containing data about the event that triggers the automation. |
 | **`event.type`** | The [trigger event type](/actions-and-automations/define-automations/setup-trigger#available-triggers). |
-| **`event.blueprintIdentifier`**<br/>or<br/>**`event.actionIdentifier`** | If using an *entity trigger* - the identifier of the blueprint whose entities will trigger the automation.<br/>If using an *action run trigger* - the identifier of the action whose runs will trigger the automation. |
+| **`event.blueprintIdentifier`**<br/>or<br/>**`event.actionIdentifier`** | If using an *entity trigger* - the identifier of the blueprint whose entities will trigger the automation.<br/>If using an *action run trigger* - the identifier of the action/automation whose runs will trigger the automation. |
 | `condition` | An optional object containing `jq` expressions used to determine which entities the automation will be triggered for. |
 | `condition.type` | The type of condition. Should be set to `JQ`. |
 | `condition.expressions` | An array of expressions used to filter the entities for which the automation will be triggered. |
 | `condition.combinator` | The combinator used to combine the expressions. Should be set to `and` or `or`. |
+
+:::tip Automation action identifiers
+When using the `actionIdentifier` key, you can use an identifier that belongs to an automation as well.  
+This means that automations can be triggered by other automations and are not limited to self-service actions.
+:::

docs/ai-agents/port-mcp-server.md

@@ -8,6 +8,21 @@ import TabItem from "@theme/TabItem"
 
 # Port MCP server
 
+<center>
+<div className="video-container">
+  <iframe 
+    style={{borderRadius:'4px'}}
+    width="568"
+    height="320"
+    src="https://www.youtube.com/embed/hxUTTPSApQs" 
+    title="YouTube video player" 
+    frameborder="0" 
+    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" 
+    allowfullscreen>
+  </iframe>
+</div>
+</center>
+<br/>
 
 The Port Model Context Protocol (MCP) Server acts as a bridge, enabling Large Language Models (LLMs)—like those powering Claude, Cursor, or GitHub Copilot—to interact directly with your Port.io developer portal. This allows you to leverage natural language to query your software catalog, analyze service health, manage resources, and even streamline development workflows, all from your preferred interfaces.
 

docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/_azuredevops_exporter_example_monorepo_port_app_config.mdx

@@ -18,8 +18,8 @@ resources:
         mappings:
           identifier: .objectId
           title: .path
-          url: .__repository.url
-          blueprint: '"azureDevopsRepository"'
+          url: .__repository.remoteUrl
+          blueprint: '"service"'
           properties:
             defaultBranch: .__repository.defaultBranch
           relations:

docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/_azuredevops_exporter_example_port_app_config.mdx

@@ -26,11 +26,12 @@ resources:
     port:
       entity:
         mappings:
-          identifier: "\(.project.name | ascii_downcase | gsub("[ ();]"; ""))/\(.name | ascii_downcase | gsub("[ ();]"; ""))"
+          identifier: >-
+            "\(.project.name | ascii_downcase | gsub("[ ();]"; ""))/\(.name | ascii_downcase | gsub("[ ();]"; ""))"
           title: .name
-          blueprint: '"azureDevopsRepository"'
+          blueprint: '"service"'
           properties:
-            url: .url
+            url: .remoteUrl
             readme: file://README.md
           relations:
             project: .project.id | gsub(" "; "")
@@ -40,8 +41,9 @@ resources:
     port:
       entity:
         mappings:
-          identifier: '.__repository.project.name + "/" + .__repository.name | gsub(" "; "")'
-          blueprint: '"azureDevopsRepository"'
+          identifier: >-
+            "\(.__repository.project.name | ascii_downcase | gsub("[ ();]"; ""))/\(.__repository.name | ascii_downcase | gsub("[ ();]"; ""))"
+          blueprint: '"service"'
           properties:
             minimumApproverCount: .settings.minimumApproverCount
   - kind: repository-policy
@@ -50,8 +52,9 @@ resources:
     port:
       entity:
         mappings:
-          identifier: '.__repository.project.name + "/" + .__repository.name | gsub(" "; "")'
-          blueprint: '"azureDevopsRepository"'
+          identifier: >-
+            "\(.__repository.project.name | ascii_downcase | gsub("[ ();]"; ""))/\(.__repository.name | ascii_downcase | gsub("[ ();]"; ""))"
+          blueprint: '"service"'
           properties:
             workItemLinking: .isEnabled and .isBlocking
   - kind: pull-request
@@ -61,13 +64,10 @@ resources:
       entity:
         mappings:
           identifier: >-
-            .repository.project.name + "/" + .repository.name + (.pullRequestId
-            | tostring) | gsub(" "; "")
+            "\(.repository.project.name | ascii_downcase | gsub("[ ();]"; ""))/\(.repository.name | ascii_downcase | gsub("[ ();]"; ""))/\(.pullRequestId | tostring)"
           blueprint: '"azureDevopsPullRequest"'
           properties:
-            creator: .createdBy.uniqueName
             status: .status
-            reviewers: '[.reviewers[].uniqueName]'
             createdAt: .creationDate
             leadTimeHours: >-
               (.creationDate as $createdAt | .status as $status | .closedDate as $closedAt |
@@ -78,7 +78,10 @@ resources:
               (((($closedTimestamp - $createdTimestamp) / 3600) * 100 | floor) / 100)
               else null end)
           relations:
-            repository: '.repository.project.name + "/" + .repository.name | gsub(" "; "")'
+            service: >-
+              "\(.repository.project.name | ascii_downcase | gsub("[ ();]"; ""))/\(.repository.name | ascii_downcase | gsub("[ ();]"; ""))"
+            creator: .createdBy.uniqueName
+            reviewers: '[.reviewers[].uniqueName]'
 ```
 
 </details>

docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/_azuredevops_exporter_example_pull_request_blueprint.mdx

@@ -8,10 +8,6 @@
   "icon": "AzureDevops",
   "schema": {
     "properties": {
-      "creator": {
-        "title": "Creator",
-        "type": "string"
-      },
       "status": {
         "title": "Status",
         "type": "string",
@@ -26,14 +22,6 @@
           "active": "green"
         }
       },
-      "reviewers": {
-        "type": "array",
-        "title": "Reviewers",
-        "items": {
-          "type": "string",
-          "format": "user"
-        }
-      },
       "createdAt": {
         "title": "Create At",
         "type": "string",
@@ -55,11 +43,23 @@
   "calculationProperties": {},
   "aggregationProperties": {},
   "relations": {
-    "repository": {
-      "title": "Repository",
-      "target": "azureDevopsRepository",
+    "service": {
+      "title": "Service",
+      "target": "service",
       "required": false,
       "many": false
+    },
+    "creator": {
+      "title": "Creator",
+      "target": "azureDevopsUser",
+      "required": false,
+      "many": false
+    },
+    "reviewers": {
+      "title": "Reviewers",
+      "target": "azureDevopsUser",
+      "required": false,
+      "many": true
     }
   }
 }

docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/_azuredevops_exporter_example_repository_blueprint.mdx

@@ -3,8 +3,8 @@
 
 ```json showLineNumbers
   {
-    "identifier": "azureDevopsRepository",
-    "title": "Repository",
+    "identifier": "service",
+    "title": "Service",
     "icon": "AzureDevops",
     "schema": {
       "properties": {

docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md

@@ -53,7 +53,7 @@ resources:
     entity:
       mappings:
         identifier: .id | gsub(" "; "")
-        blueprint: '"azureDevopsProject"'
+        blueprint: '"project"'
         title: .name
         properties:
           state: .state
@@ -67,11 +67,12 @@ resources:
   port:
     entity:
       mappings:
-        identifier: .project.name + "/" + .name | gsub(" "; "")
+        identifier: >-
+          "\(.project.name | ascii_downcase | gsub("[ ();]"; ""))/\(.name | ascii_downcase | gsub("[ ();]"; ""))"
         title: .name
-        blueprint: '"azureDevopsRepository"'
+        blueprint: '"service"'
         properties:
-          url: .url
+          url: .remoteUrl
           readme: file://README.md
           id: .id
           last_activity: .project.lastUpdateTime
@@ -83,8 +84,9 @@ resources:
   port:
     entity:
       mappings:
-        identifier: .__repository.project.name + "/" + .__repository.name | gsub(" "; "")
-        blueprint: '"azureDevopsRepository"'
+        identifier: >-
+          "\(.__repository.project.name | ascii_downcase | gsub("[ ();]"; ""))/\(.__repository.name | ascii_downcase | gsub("[ ();]"; ""))"
+        blueprint: '"service"'
         properties:
           minimumApproverCount: .settings.minimumApproverCount
 - kind: repository-policy
@@ -93,8 +95,9 @@ resources:
   port:
     entity:
       mappings:
-        identifier: .__repository.project.name + "/" + .__repository.name | gsub(" "; "")
-        blueprint: '"azureDevopsRepository"'
+        identifier: >-
+          "\(.__repository.project.name | ascii_downcase | gsub("[ ();]"; ""))/\(.__repository.name | ascii_downcase | gsub("[ ();]"; ""))"
+        blueprint: '"service"'
         properties:
           workItemLinking: .isEnabled and .isBlocking
 - kind: user
@@ -131,7 +134,8 @@ resources:
   port:
     entity:
       mappings:
-        identifier: .repository.project.name + "/" + .repository.name + (.pullRequestId | tostring) | gsub(" "; "")
+        identifier: >-
+          "\(.repository.project.name | ascii_downcase | gsub("[ ();]"; ""))/\(.repository.name | ascii_downcase | gsub("[ ();]"; ""))/\(.pullRequestId | tostring)"
         blueprint: '"azureDevopsPullRequest"'
         properties:
           status: .status
@@ -159,11 +163,6 @@ resources:
               value: '[.reviewers[].uniqueName]'
           azure_devops_reviewers: '[.reviewers[].id]'
           azure_devops_creator: .createdBy.id
-
-
-
-
-
 ```
 
 </details>
@@ -888,9 +887,9 @@ The combination of the sample payload and the Ocean configuration generates the
 
 ```json showLineNumbers
 {
-  "identifier": "PortIntegration/final_project_to_project_test",
+  "identifier": "portintegration/final_project_to_project_test",
   "title": "final_project_to_project_test",
-  "blueprint": "azureDevopsRepository",
+  "blueprint": "service",
   "properties": {
     "url": "[REDACTED]/fd029361-7854-4cdd-8ace-bb033fca399c/_apis/git/repositories/43c319c8-5adc-41f8-8486-745fe2130cd6",
     "readme": "<README.md Content>",

docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-teams/_azuredevops_exporter_example_teams_port_app_config.mdx

@@ -26,11 +26,12 @@ resources:
     port:
       entity:
         mappings:
-          identifier: '.project.name + "/" + .name | gsub(" "; "")'
+          identifier: >-
+            "\(.project.name | ascii_downcase | gsub("[ ();]"; ""))/\(.name | ascii_downcase | gsub("[ ();]"; ""))"
           title: .name
-          blueprint: '"azureDevopsRepository"'
+          blueprint: '"service"'
           properties:
-            url: .url
+            url: .remoteUrl
             readme: file://README.md
           relations:
             project: .project.id | gsub(" "; "")
@@ -40,8 +41,9 @@ resources:
     port:
       entity:
         mappings:
-          identifier: '.__repository.project.name + "/" + .__repository.name | gsub(" "; "")'
-          blueprint: '"azureDevopsRepository"'
+          identifier: >-
+            "\(.__repository.project.name | ascii_downcase | gsub("[ ();]"; ""))/\(.__repository.name | ascii_downcase | gsub("[ ();]"; ""))"
+          blueprint: '"service"'
           properties:
             minimumApproverCount: .settings.minimumApproverCount
   - kind: repository-policy
@@ -50,8 +52,9 @@ resources:
     port:
       entity:
         mappings:
-          identifier: '.__repository.project.name + "/" + .__repository.name | gsub(" "; "")'
-          blueprint: '"azureDevopsRepository"'
+          identifier: >-
+            "\(.__repository.project.name | ascii_downcase | gsub("[ ();]"; ""))/\(.__repository.name | ascii_downcase | gsub("[ ();]"; ""))"
+          blueprint: '"service"'
           properties:
             workItemLinking: .isEnabled and .isBlocking
   - kind: team

docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/mapping_extensions.md

@@ -37,11 +37,12 @@ To do so, we will use the `file://` prefix with the path of the file to tell the
     port:
       entity:
         mappings:
-          identifier: .project.name + "/" + .name
+          identifier: >-
+            "\(.project.name | ascii_downcase | gsub("[ ();]"; ""))/\(.name | ascii_downcase | gsub("[ ();]"; ""))"
           title: .name
-          blueprint: '"azureDevopsRepository"'
+          blueprint: '"service"'
           properties:
-            url: .url
+            url: .remoteUrl
             // highlight-next-line
             readme: file://README.md
 ```