[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-atlassian-forge-connector":3,"mdc--jysatx-key":39,"related-org-atlassian-forge-connector":10252,"related-repo-atlassian-forge-connector":10423},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":22,"repoUrl":23,"updatedAt":24,"license":25,"forks":26,"topics":27,"repo":34,"sourceUrl":37,"mdContent":38},"forge-connector","build Atlassian Forge Teamwork Graph connectors","Guides building and deploying Atlassian Forge Teamwork Graph connector apps that ingest external data into Atlassian's Teamwork Graph, making it searchable in Rovo Search and surfaced in Rovo Chat. Use when the user wants to build a Forge connector, ingest external data into Atlassian, connect a third-party tool (e.g. Google Drive, ServiceNow, Salesforce) to Atlassian, make external content searchable in Rovo, build a graph:connector module, use the @forge\u002Fteamwork-graph SDK, or implement onConnectionChange \u002F validateConnection functions.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"atlassian","Atlassian","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fatlassian.png",[12,16,19],{"name":13,"slug":14,"type":15},"Enterprise Search","enterprise-search","tag",{"name":17,"slug":18,"type":15},"Engineering","engineering",{"name":20,"slug":21,"type":15},"API Development","api-development",14,"https:\u002F\u002Fgithub.com\u002Fatlassian\u002Fforge-skills","2026-07-12T07:58:48.520248","Apache-2.0",7,[28,29,30,31,32,33],"agent-skills","ai-agents","claude-code-plugin","claude-code-skills","gemini-cli-extension","mcp",{"repoUrl":23,"stars":22,"forks":26,"topics":35,"description":36},[28,29,30,31,32,33],"The Forge Skills Plugin bundles several Forge-focused skills plus MCP-backed tooling so your agent can scaffold apps, review them before deploy, debug production issues, and stay current on Forge APIs and the Atlassian Design System.","https:\u002F\u002Fgithub.com\u002Fatlassian\u002Fforge-skills\u002Ftree\u002FHEAD\u002Fskills\u002Fforge-connector","---\n\nname: forge-connector\ndescription: >\n  Guides building and deploying Atlassian Forge Teamwork Graph connector apps that ingest\n  external data into Atlassian's Teamwork Graph, making it searchable in Rovo Search and\n  surfaced in Rovo Chat. Use when the user wants to build a Forge connector, ingest external\n  data into Atlassian, connect a third-party tool (e.g. Google Drive, ServiceNow, Salesforce)\n  to Atlassian, make external content searchable in Rovo, build a graph:connector module,\n  use the @forge\u002Fteamwork-graph SDK, or implement onConnectionChange \u002F validateConnection\n  functions.\nlicense: Apache-2.0\nlabels:\n  - forge\n  - rovo\n  - jira\n  - atlassian\n  - teamwork-graph\n  - connector\nmaintainer: mbanjan94\nnamespace: cloud\n---\n\n# Forge Connector\n\nBuilds a `graph:connector` Forge app that ingests external data into Atlassian's Teamwork Graph so it appears in **Rovo Search** and **Rovo Chat**.\n\n## Critical Rules\n\n1. **Must install in Jira** — Apps using Teamwork Graph modules must be installed on a Jira site. Confluence-only installs will not work.\n2. **Never ask for credentials in chat** — Direct users to run `forge login` in their own terminal.\n3. **Always run the scaffold script yourself** — Do not only give manual instructions; run `scripts\u002Fscaffold_connector.py` to generate the boilerplate.\n4. **Always ask the user for their Atlassian site URL** when install is needed — never discover or guess it.\n5. **Atlassian deletes data on disconnect** — When `action = 'DELETED'`, the app only needs to clean up local state; Atlassian removes the Teamwork Graph data automatically.\n6. **Handler arguments are passed directly** — Forge passes the request object as the first argument to handlers, NOT nested under `event.payload`. Config values are at `request.configProperties`, NOT `event.payload.config`. This is the most common source of `TypeError: Cannot destructure property of undefined` errors.\n7. **Use `@forge\u002Fkvs` for storage** — Import `kvs` from `@forge\u002Fkvs`. Do NOT use `@forge\u002Fstorage` — its `storage` export is `undefined` at runtime in connector functions.\n8. **Use `graph` named export from `@forge\u002Fteamwork-graph`** — The correct import is `const { graph } = require('@forge\u002Fteamwork-graph')`. Call `graph.setObjects({ objects, connectionId })`. Do NOT import `setObjects` as a named export directly.\n9. **`validateConnectionHandler` must return `{ success, message }`** — Do NOT throw an Error. Return `{ success: false, message: '...' }` to reject, `{ success: true }` to accept.\n10. **`function` declarations belong under `modules`** — In `manifest.yml`, `function:` is a key under `modules:`, not a top-level key. Placing it at the top level causes a lint error.\n11. **`formConfiguration` uses `form` array with `type: header`** — Do NOT use `fields:` or `beforeYouBegin:`. The correct format uses `form: [{ key, type: header, title, description, properties: [...] }]`.\n12. **Scopes are `read\u002Fwrite\u002Fdelete:object:jira`** — Use `read:object:jira`, `write:object:jira`, `delete:object:jira`. The scopes `read:graph:teamwork` and `write:graph:teamwork` are invalid and will fail `forge lint`.\n13. **Set `ATL_FORGE_ATTRIBUTION_SKILL_NAME=forge-connector` on `forge` commands run for this skill** — prefix `forge` invocations with this env var: ones you run in the shell (e.g. `forge lint`, `forge logs`, `forge deploy`) **and the interactive `forge create` command you hand the user as a fallback**. The bundled scripts set it automatically; other commands shown in this skill omit it for brevity — add it when you run them. The only exclusions are `forge login` and `forge tunnel` (user-run auth \u002F live-dev commands).\n\n## MCP Prerequisites\n\n\n| MCP Server    | Purpose                                           |\n| ------------- | ------------------------------------------------- |\n| **Forge MCP** | Manifest syntax, module config, deployment guides |\n| **ADS MCP**   | Atlaskit components (only if adding Custom UI)    |\n\n\n---\n\n## Agent Workflow — Complete Steps 0–7 in Order\n\n### Step 0: Prerequisites\n\nCheck Node.js (`node -v`, requires 22+), Forge CLI (`forge --version`), and login (`forge whoami`). Install missing tools:\n\n```bash\nnpm install -g @forge\u002Fcli\n```\n\nTell the user to run `forge login` in their terminal if not authenticated.\n\n### Step 1: Discover Developer Spaces\n\n> **Note:** `forge developer-spaces list` does NOT exist in Forge CLI 12.x. You cannot list developer spaces non-interactively.\n\n`forge create` requires an interactive TTY to select a developer space. Ask the user to run it themselves:\n\n```\nTell the user:\n  cd \u003Cparent-directory>\n  ATL_FORGE_ATTRIBUTION_SKILL_NAME=forge-connector forge create --template blank \u003Capp-name>\n\n  When prompted, select a Developer Space and let it complete.\n  Come back when done.\n```\n\nThe `--dev-space-id` flag in the scaffold script is optional and can be omitted — the script has been updated to skip it when not provided.\n\n### Step 1.5: Discover Data & Map to Object Types\n\n**Do this before scaffolding.** Ask the user the following questions to determine the correct Teamwork Graph object type(s). Do not assume or default to `atlassian:document`.\n\n#### Questions to ask the user\n\n1. **What external system or tool are you connecting?**\n   e.g. Google Drive, ServiceNow, Salesforce, GitHub, Confluence, Slack, Figma, Zendesk\n\n2. **What kind of content do you want to make searchable in Rovo?**\n   Prompt with examples to help them identify it:\n   - Files, pages, wiki articles, reports, PDFs → likely `atlassian:document`\n   - Tasks, tickets, issues, bugs, stories → likely `atlassian:work-item`\n   - Chat messages, emails, comments → likely `atlassian:message` or `atlassian:comment`\n   - Projects, workspaces, boards → likely `atlassian:project`\n   - Code repositories → likely `atlassian:repository`\n   - Pull requests \u002F merge requests → likely `atlassian:pull-request`\n   - Git commits → likely `atlassian:commit`\n   - Design files (Figma, Sketch) → likely `atlassian:design`\n   - Video recordings → likely `atlassian:video`\n   - Calendar events, meetings → likely `atlassian:calendar-event`\n   - Threads, channels → likely `atlassian:conversation`\n   - Customer accounts or organisations → likely `atlassian:customer-organization`\n   - Team spaces or org units → likely `atlassian:space`\n\n3. **Is the content a single type or a mix?**\n   If mixed (e.g. a project management tool with tasks *and* documents), plan to ingest each as its own object type. The scaffold supports one primary type — you can add more `objectTypes` entries in `manifest.yml` later.\n\n4. **Does the admin need to supply credentials (API key, URL, OAuth token) to connect?**\n   Yes → use `--has-form-config` in the scaffold command.\n   No (data comes entirely from within Atlassian) → omit the flag.\n\n5. **How often does the source data change?**\n   Frequently (hourly) → plan a `scheduledTrigger` with `interval: hour`.\n   Daily or less → `interval: day`.\n   Static \u002F one-off → no scheduled trigger needed.\n\n6. **Who should be able to see the ingested content in Rovo Search?**\n   This determines the `permissions.accessControls` on each object. Ask:\n   - \"Is all this content publicly accessible, or does the source system restrict who can see what?\"\n   - \"Do you want Rovo Search results to respect those source-system permissions?\"\n\n   Map the answer to the correct principal model:\n\n   | Source system access model | `accessControls` to use |\n   |---|---|\n   | Publicly accessible, no restrictions | `principals: [{ type: 'EVERYONE' }]` |\n   | Specific named users have access | `principals: [{ type: 'user', id: '\u003Catlassian-account-id>' }]` — one entry per user |\n   | Team or group based (e.g. Confluence space, Google Workspace group) | `principals: [{ type: 'group', id: '\u003Cgroup-id>' }]` — one entry per group |\n   | Private \u002F owner only | single `user` principal with the owner's Atlassian account ID |\n   | Mixed (per-object ACLs from the source) | fetch ACLs per item during ingestion and map each to a `user` or `group` principal |\n\n   **Do NOT default to `EVERYONE`** unless the user explicitly confirms content is publicly accessible. Using `EVERYONE` on restricted content leaks data to users who shouldn't see it in Rovo Search.\n\n   Record the chosen permission model before proceeding to Step 2. Reference it when writing the `setObjects` call in Step 3.\n\n#### Mapping decision\n\nBased on the answers, select the best-fit type from the Object Types table below. Only fall back to `atlassian:document` if the content genuinely has no better match (e.g. arbitrary file attachments). For types marked ❌ in the \"Indexed in Rovo\" column (`atlassian:build`, `atlassian:deployment`, `atlassian:test`), warn the user that those objects will not appear in Rovo Search or Rovo Chat.\n\nRecord the chosen object type(s) and permission model before proceeding to Step 2.\n\n### Step 2: Scaffold the Connector App\n\nRun from the **skill directory** (the directory containing this SKILL.md). Replace `\u003Cobject-type>` with the type determined in Step 1.5. `--dev-space-id` is optional:\n\n```bash\npython3 -m scripts.scaffold_connector \\\n  --name \u003Capp-name> \\\n  --connector-name \"\u003CHuman Readable Name>\" \\\n  --object-type \u003Cobject-type> \\\n  --directory \u003Cparent-directory>\n```\n\nAdd `--dev-space-id \u003Cid>` only if you have the ID from a previous step.\n\n**Object type** — use the type chosen in Step 1.5. Do NOT default to `atlassian:document` without first completing the discovery questions above.\n\n**Form config flag** — add `--has-form-config` if the admin must provide API credentials or connection details (determined in Step 1.5 question 4). Omit it for apps that operate entirely within Atlassian (no external credentials needed).\n\n> **If scaffold fails because `forge create` needs a TTY:** The scaffold script will print a manual fallback command. Have the user run `forge create` interactively, then continue from Step 3 — the scaffold script only needs to write `manifest.yml` and `src\u002Findex.js` after the directory exists.\n\n### Step 3: Customize the Generated Code\n\nAfter scaffolding (or after the user runs `forge create` interactively):\n\n```bash\ncd \u003Capp-name>\nnpm install\n```\n\nThe blank template generates `src\u002Findex.js` (JavaScript, not TypeScript). Edit it to add your API calls. The scaffold generates working handler skeletons; fill in your business logic.\n\n#### Key files to edit\n\n| File           | What to change                                                          |\n| -------------- | ----------------------------------------------------------------------- |\n| `src\u002Findex.js` | `fetchExternalData()` — replace with your API calls                     |\n| `manifest.yml` | Add `permissions.external.fetch.backend` URLs for any external APIs     |\n| `package.json` | Add `@forge\u002Fapi`, `@forge\u002Fkvs`, `@forge\u002Fteamwork-graph` as dependencies |\n\n\n#### setObjects — ingest data into Teamwork Graph\n\nUse the `graph` named export — do NOT destructure `setObjects` directly:\n\n```javascript\nconst { graph } = require('@forge\u002Fteamwork-graph');\n\nconst result = await graph.setObjects({\n  connectionId,          \u002F\u002F required — the connectionId from the handler request\n  objects: [\n    {\n      schemaVersion: '1.0',\n      id: 'unique-id-from-source',      \u002F\u002F unique per connectionId\n      updateSequenceNumber: 1,\n      displayName: 'My Document Title',\n      url: 'https:\u002F\u002Fsource-system.example.com\u002Fdoc\u002F123',\n      createdAt: '2024-01-15T10:00:00Z',        \u002F\u002F ISO 8601\n      lastUpdatedAt: '2024-01-20T14:30:00Z',\n      \u002F\u002F Use the permission model chosen in Step 1.5 question 6.\n      \u002F\u002F EVERYONE only if content is confirmed publicly accessible.\n      \u002F\u002F For user-restricted content: { type: 'user', id: '\u003Catlassian-account-id>' }\n      \u002F\u002F For group-restricted content: { type: 'group', id: '\u003Cgroup-id>' }\n      permissions: [{\n        accessControls: [{\n          principals: [{ type: 'EVERYONE' }],\n        }],\n      }],\n      'atlassian:document': {\n        type: {\n          category: 'DOCUMENT',   \u002F\u002F see Document Categories table below\n          mimeType: 'application\u002Fvnd.google-apps.document',\n        },\n        content: {\n          mimeType: 'application\u002Fvnd.google-apps.document',\n          text: 'document title or snippet for search indexing',\n        },\n      },\n    },\n  ],\n});\n\nif (!result.success) {\n  console.error('setObjects error:', result.error);\n}\n```\n\n- Max **100 objects per call** — batch large datasets with a loop\n- `id` must be unique per `connectionId`\n- `connectionId` is required in every `graph.setObjects()` call\n\n#### Document Categories (for `atlassian:document.type.category`)\n\n| MIME type | Category |\n|---|---|\n| `application\u002Fvnd.google-apps.document` | `DOCUMENT` |\n| `application\u002Fvnd.google-apps.spreadsheet` | `SPREADSHEET` |\n| `application\u002Fvnd.google-apps.presentation` | `PRESENTATION` |\n| `application\u002Fvnd.google-apps.folder` | `FOLDER` |\n| `application\u002Fpdf` | `PDF` |\n| `image\u002F*` | `IMAGE` |\n| `video\u002F*` | `VIDEO` |\n| `audio\u002F*` | `AUDIO` |\n| Other | `OTHER` |\n\n#### getObjectByExternalId — look up a single object\n\n```javascript\nconst { graph } = require('@forge\u002Fteamwork-graph');\n\nconst data = await graph.getObjectByExternalId({\n  externalId: 'unique-id-from-source',\n  objectType: 'atlassian:document',\n  connectionId,\n});\nif (data.success) console.log(data.object);\n```\n\n### Step 4: Deploy and Install\n\n**You MUST run the deploy script** — do not only give the user manual `forge deploy` commands.\n\nThe deploy script lives in the **forge-app-builder** skill, not in this skill. Derive its directory from the path of this SKILL.md: go up two levels (`skills\u002Fforge-connector\u002F` → `skills\u002F`) then into `forge-app-builder\u002F`. Run all commands below from that directory.\n\n```bash\n# Derive forge-app-builder skill dir from this SKILL.md's path:\n# e.g. if this file is at \u002Fpath\u002Fto\u002Fskills\u002Fforge-connector\u002FSKILL.md\n# then the deploy script dir is: \u002Fpath\u002Fto\u002Fskills\u002Fforge-app-builder\u002F\n\n# If you have the site URL:\npython3 -m scripts.deploy_forge_app \\\n  --app-dir \u003Capp-directory> \\\n  --site \u003Csite-url> \\\n  --product jira\n\n# If you don't have the site URL yet, deploy first then ask:\npython3 -m scripts.deploy_forge_app \\\n  --app-dir \u003Capp-directory> \\\n  --product jira \\\n  --deploy-only\n# Ask: \"What is your Atlassian site URL (e.g. yourcompany.atlassian.net)?\"\npython3 -m scripts.deploy_forge_app \\\n  --app-dir \u003Capp-directory> \\\n  --site \u003Csite-url> \\\n  --product jira \\\n  --skip-deps\n```\n\n### Step 5: Connect via Atlassian Administration\n\nAfter deployment, tell the user to:\n\n1. Go to **Atlassian Administration** → **Apps** → **[site]** → **Connected apps**\n2. Find the app → **View app details** → **Connections** tab\n3. Click **Connect** under the connector\n4. Fill in any configuration fields (if `formConfiguration` was defined)\n5. Click **Connect** — this triggers `onConnectionChange` with `action: CREATED` and starts data ingestion\n\n### Step 6: Monitor with forge tunnel\n\nUse `forge tunnel` during development to stream live logs directly to your terminal as the connector functions execute. This is the fastest way to catch errors in `onConnectionChangeHandler`, `validateConnectionHandler`, and `setObjects` calls without waiting for `forge logs`.\n\nTell the user to run this in their own terminal (it requires an interactive session):\n\n```bash\ncd \u003Capp-directory>\nforge tunnel\n```\n\nWith the tunnel active, any invocation of the connector functions (e.g. clicking \"Connect\" in Atlassian Admin, or triggering a scheduled re-ingestion) will stream output immediately. Look for:\n\n- `[connector] Fetched N items` — confirms `fetchExternalData()` ran\n- `[connector] Batch 1: N accepted, 0 rejected` — confirms `setObjects` succeeded\n- Any uncaught errors or thrown exceptions from `validateConnectionHandler`\n\nIf the tunnel is not running, use `forge logs` instead to inspect past invocations:\n\n```bash\n# Most recent 50 log lines from development environment\nforge logs -e development --limit 50\n\n# Production logs for a specific site\nforge logs -e production --site \u003Cyour-site> --limit 50\n```\n\n**Tunnel vs logs — when to use which:**\n\n| Situation | Use |\n|---|---|\n| Actively developing \u002F testing the connection flow | `forge tunnel` — live streaming |\n| Debugging a past invocation or production issue | `forge logs` |\n| Connector function timed out before tunnel caught it | `forge logs` with `--limit 100` |\n\n> **Note:** `forge tunnel` must be run by the user in an interactive terminal — do not attempt to run it via the agent.\n\n### Step 7: End-to-End Verification (optional)\n\nBefore running any checks, ask the user:\n\n> \"Would you like to run end-to-end verification checks before deploying to production? This confirms the connection, ingestion, Rovo Search visibility, and permission boundaries are all working correctly.\"\n\nIf the user says **no** or wants to skip, move on — do not run or describe the checks.\nIf the user says **yes**, work through every check below in order.\n\n#### Check 1 — Connection established\n\nIn **Atlassian Administration → Apps → Connected apps**, the connector should show status **Connected**. If it shows an error or pending state, go back to Step 6 and inspect `forge tunnel` or `forge logs` output.\n\n#### Check 2 — `validateConnection` passed (if configured)\n\nIf the app has a `validateConnection` function, confirm the admin saw a success message when clicking **Connect**. If not, check logs for the return value — it must be `{ success: true }`, not a thrown error.\n\n#### Check 3 — `onConnectionChange` fired and ingestion ran\n\nIn `forge logs` or the tunnel output, confirm:\n\n```bash\nforge logs -e development --limit 50\n```\n\nLook for all three signals:\n- Handler was invoked: log line from `onConnectionChangeHandler` with `action: CREATED`\n- Data was fetched: e.g. `[connector] Fetched N items`\n- `setObjects` succeeded: e.g. `[connector] Batch 1: N accepted, 0 rejected`\n\nIf `setObjects` returned `{ success: false }`, the error detail is in `result.error` — surface it to the user and fix before continuing.\n\n#### Check 4 — Objects visible in Rovo Search\n\n1. Open Rovo Search on the Jira site (allow up to **5 minutes** for indexing after ingestion)\n2. Search for a word that appears in at least one ingested object's `displayName` or content text\n3. Filter by the connector's nickname (set by admin at connection time)\n\nAt least one result from the connector should appear. If nothing shows up after 5 minutes:\n- Confirm `setObjects` logged `N accepted` with N > 0 (Check 3)\n- Confirm the object's `permissions` match the logged-in user (an `EVERYONE` principal or a `user`\u002F`group` principal that includes the test user)\n- Re-check that `write:object:jira` scope is present in `manifest.yml` and the app was redeployed after any scope change\n\n#### Check 5 — Permission boundary (skip only if `EVERYONE` was used)\n\nIf the connector uses `user` or `group` principals:\n1. Log in as a user who **should** have access → confirm the object appears in Rovo Search\n2. Log in as a user who **should not** have access → confirm the object does **not** appear\n\nIf a restricted object is visible to an unauthorised user, re-check the `accessControls` principals in `setObjects` and redeploy.\n\n#### Check 6 — Rovo Chat references connector data\n\nAsk Rovo Chat a question whose answer exists only in the ingested content, e.g.:\n\n> \"What is the status of [title of an ingested item]?\"\n\nRovo Chat should cite the connector as a source. If it cannot find the content, Checks 3 and 4 likely have an unresolved issue.\n\n#### Check 7 — Scheduled re-ingestion fires (if configured)\n\nIf a `scheduledTrigger` was added:\n1. Temporarily set `interval: fiveMinutes` in `manifest.yml`, redeploy, and wait one cycle\n2. Confirm `forge logs` shows a fresh ingestion run from `refreshIngestionHandler`\n3. Restore the original interval and redeploy before going to production\n\n#### Production readiness gate\n\nIf the user chose to run verification, only proceed to a production deploy (`forge deploy -e production`) when **all applicable checks above pass**:\n\n| Check | Required for production |\n|---|---|\n| 1 — Connection established | Always |\n| 2 — validateConnection passed | Only if `validateConnection` is configured |\n| 3 — Ingestion ran without errors | Always |\n| 4 — Objects visible in Rovo Search | Always |\n| 5 — Permission boundary | Only if using `user`\u002F`group` principals |\n| 6 — Rovo Chat cites connector | Always |\n| 7 — Scheduled re-ingestion fires | Only if `scheduledTrigger` is configured |\n\n---\n\n## Manifest Reference\n\n> **Key rules:**\n> - Scopes are `read:object:jira`, `write:object:jira`, `delete:object:jira` — NOT `read:graph:teamwork` \u002F `write:graph:teamwork` (those fail `forge lint`)\n> - `function:` is declared **under `modules:`**, not at the top level\n> - Egress uses `address:` not a bare string (run `forge lint --fix` to auto-correct)\n> - `formConfiguration` uses `form: [{ type: header, properties: [...] }]` — NOT `fields:` or `beforeYouBegin:`\n\n### Minimal connector (no admin config, no OAuth)\n\nUse when the app operates entirely within Atlassian — no external credentials needed.\n\n```yaml\napp:\n  id: \u003Cgenerated-by-forge-create>\n  runtime:\n    name: nodejs24.x\n    memoryMB: 256\n    architecture: arm64\n\npermissions:\n  scopes:\n    - read:object:jira\n    - write:object:jira\n    - delete:object:jira\n    - storage:app\n\nmodules:\n  graph:connector:\n    - key: my-connector\n      name: My Service\n      icons:\n        light: https:\u002F\u002Fcdn.example.com\u002Flogo.png\n        dark: https:\u002F\u002Fcdn.example.com\u002Flogo.png\n      objectTypes:\n        - atlassian:document\n      datasource:\n        onConnectionChange:\n          function: on-connection-change\n\n  function:\n    - key: on-connection-change\n      handler: index.onConnectionChangeHandler\n```\n\n### Connector with admin form config (API key \u002F URL)\n\nUse when the admin must provide credentials to connect to an external system.\n\n```yaml\napp:\n  id: \u003Cgenerated-by-forge-create>\n  runtime:\n    name: nodejs24.x\n    memoryMB: 256\n    architecture: arm64\n\npermissions:\n  scopes:\n    - read:object:jira\n    - write:object:jira\n    - delete:object:jira\n    - storage:app\n  external:\n    fetch:\n      backend:\n        - address: 'https:\u002F\u002Fapi.your-service.com'   # note: address: not a bare string\n\nmodules:\n  graph:connector:\n    - key: my-connector\n      name: My Service\n      icons:\n        light: https:\u002F\u002Fcdn.example.com\u002Flogo.png\n        dark: https:\u002F\u002Fcdn.example.com\u002Flogo.png\n      objectTypes:\n        - atlassian:document\n      datasource:\n        formConfiguration:\n          form:                          # use form:, NOT fields: or beforeYouBegin:\n            - key: connectionDetails\n              type: header\n              title: Connection Details\n              description: >\n                Provide your My Service API credentials.\n                Find them in My Service → Settings → API.\n              properties:\n                - key: apiKey           # camelCase keys — accessed as request.configProperties.apiKey\n                  label: API Key\n                  type: string\n                  isRequired: true\n                - key: apiUrl\n                  label: API URL\n                  type: string\n                  isRequired: true\n          validateConnection:\n            function: validate-connection\n        onConnectionChange:\n          function: on-connection-change\n\n  function:                              # function: is under modules:, NOT top-level\n    - key: on-connection-change\n      handler: index.onConnectionChangeHandler\n    - key: validate-connection\n      handler: index.validateConnectionHandler\n```\n\n---\n\n## Handler Signatures\n\n> **Critical:** Forge passes the request **directly as the first argument** — it is NOT wrapped under `event.payload`. Config form values are at `request.configProperties`, not `event.payload.config`. Getting this wrong causes `TypeError: Cannot destructure property of undefined`.\n\n### onConnectionChange\n\n```javascript\nconst { kvs } = require('@forge\u002Fkvs');\nconst { graph } = require('@forge\u002Fteamwork-graph');\n\nexports.onConnectionChangeHandler = async (request) => {\n  \u002F\u002F request.action, request.connectionId, request.configProperties\n  const { action, connectionId, configProperties } = request;\n\n  if (action === 'DELETED') {\n    \u002F\u002F Atlassian removes Teamwork Graph data automatically on disconnect.\n    \u002F\u002F Only clean up locally stored credentials.\n    await kvs.deleteSecret(connectionId);\n    return { success: true };\n  }\n\n  \u002F\u002F CREATED or UPDATED — persist credentials and ingest data\n  await kvs.setSecret(connectionId, configProperties);\n  await ingestAllData(connectionId, configProperties);\n  return { success: true };\n};\n```\n\n### validateConnection\n\n```javascript\nconst { fetch } = require('@forge\u002Fapi');\n\nexports.validateConnectionHandler = async (request) => {\n  \u002F\u002F request.configProperties — NOT event.payload.config\n  const { configProperties } = request;\n\n  \u002F\u002F Return { success: false, message } to reject — do NOT throw an Error.\n  \u002F\u002F Return { success: true } to accept.\n  const response = await fetch(`${configProperties['apiUrl']}\u002Fhealth`);\n  if (!response.ok) {\n    return { success: false, message: 'Invalid API credentials. Please check your settings.' };\n  }\n  return { success: true, message: 'Connection validated successfully.' };\n};\n```\n\n### refreshIngestion (scheduled trigger)\n\n```javascript\nexports.refreshIngestionHandler = async () => {\n  const activeConnections = await kvs.get('active-connections') ?? [];\n  for (const connectionId of activeConnections) {\n    const config = await kvs.getSecret(connectionId);\n    if (config) await ingestAllData(connectionId, config);\n  }\n};\n```\n\n---\n\n## Object Types\n\nObjects in **bold** are indexed in Rovo Search and Rovo Chat.\n\n\n| Object Type                       | Indexed in Rovo | Best for                             |\n| --------------------------------- | --------------- | ------------------------------------ |\n| `atlassian:document`              | ✅               | Files, pages, wiki articles, reports |\n| `atlassian:message`               | ✅               | Chat messages, emails, comments      |\n| `atlassian:work-item`             | ✅               | Tasks, tickets, issues               |\n| `atlassian:project`               | ✅               | Projects, workspaces                 |\n| `atlassian:space`                 | ✅               | Team spaces, org units               |\n| `atlassian:design`                | ✅               | Design files (Figma, etc.)           |\n| `atlassian:repository`            | ✅               | Code repositories                    |\n| `atlassian:pull-request`          | ✅               | PRs, merge requests                  |\n| `atlassian:commit`                | ✅               | Git commits                          |\n| `atlassian:branch`                | ✅               | Git branches                         |\n| `atlassian:conversation`          | ✅               | Threads, channels                    |\n| `atlassian:video`                 | ✅               | Video recordings                     |\n| `atlassian:calendar-event`        | ✅               | Meetings, events                     |\n| `atlassian:comment`               | ✅               | Review comments                      |\n| `atlassian:customer-organization` | ✅               | Customer accounts, orgs              |\n| `atlassian:build`                 | ❌               | CI\u002FCD builds                         |\n| `atlassian:deployment`            | ❌               | Deployments                          |\n| `atlassian:test`                  | ❌               | Test cases                           |\n\n\n---\n\n## Rovo Search \u002F Rovo Chat Surfacing\n\nOnce ingested:\n\n- Objects appear in **Rovo Search** under a subfilter named after the connector's nickname (set by admin at connection time)\n- **Rovo Chat** can reference and cite connector objects in responses when queried about topics related to the ingested content\n- Data is not available immediately — allow a few minutes for indexing after `onConnectionChange` fires\n\nTo verify ingestion is working:\n\n1. Open Rovo Search on the Jira site\n2. Search for text that appears in an ingested object's `name` or `properties`\n3. Filter by the connector nickname to narrow results\n\n---\n\n## Batching Pattern for Large Datasets\n\n```javascript\nconst { graph } = require('@forge\u002Fteamwork-graph');\n\nconst BATCH_SIZE = 100;\n\nasync function ingestAllData(connectionId, config) {\n  const items = await fetchExternalData(config);\n\n  for (let i = 0; i \u003C items.length; i += BATCH_SIZE) {\n    const batch = items.slice(i, i + BATCH_SIZE);\n    const result = await graph.setObjects({\n      connectionId,          \u002F\u002F required in every call\n      objects: batch.map(item => ({\n        schemaVersion: '1.0',\n        id: item.id,                      \u002F\u002F unique per connectionId\n        updateSequenceNumber: 1,\n        displayName: item.title,\n        url: item.url,\n        createdAt: item.createdAt,\n        lastUpdatedAt: item.updatedAt,\n        \u002F\u002F Replace with user\u002Fgroup principals if source system has access controls.\n        permissions: [{\n          accessControls: [{ principals: [{ type: 'EVERYONE' }] }],\n        }],\n        'atlassian:document': {\n          type: { category: 'DOCUMENT', mimeType: item.mimeType },\n          content: { mimeType: item.mimeType, text: item.title },\n        },\n      })),\n    });\n    if (!result.success) {\n      console.error(`[connector] setObjects error in batch ${Math.floor(i \u002F BATCH_SIZE) + 1}:`, result.error);\n    }\n  }\n}\n```\n\n---\n\n## Scheduled Re-Ingestion (optional)\n\nTo keep data fresh, add a scheduled trigger that re-runs ingestion periodically:\n\n```yaml\n# In manifest.yml — under modules:\nscheduledTrigger:\n  - key: refresh-trigger\n    function: refresh-ingestion\n    interval: day   # prefer 'day' or 'hour'; avoid 'fiveMinutes'\n\n# Under function:\n  - key: refresh-ingestion\n    handler: index.refreshIngestionHandler\n```\n\n```javascript\nconst { kvs } = require('@forge\u002Fkvs');\n\n\u002F\u002F Track active connections in onConnectionChangeHandler:\n\u002F\u002F   await kvs.set('active-connections', [...activeConnections, connectionId]);\n\u002F\u002F   await kvs.setSecret(connectionId, configProperties);  \u002F\u002F store credentials securely\n\nexports.refreshIngestionHandler = async () => {\n  const activeConnections = await kvs.get('active-connections') ?? [];\n  for (const connectionId of activeConnections) {\n    const config = await kvs.getSecret(connectionId);  \u002F\u002F retrieve stored credentials\n    if (config) await ingestAllData(connectionId, config);\n  }\n};\n```\n\n---\n\n## Scripts\n\n\n| Script                          | Skill directory                                   | Purpose                                                                                                                         |\n| ------------------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |\n| `scripts\u002Fscaffold_connector.py` | `skills\u002Fforge-connector\u002F` (this skill)            | Scaffold a new connector app — generates manifest.yml, src\u002Findex.ts, installs SDK. Run: `python3 -m scripts.scaffold_connector` |\n| `scripts\u002Fdeploy_forge_app.py`   | `skills\u002Fforge-app-builder\u002F` (**different skill**) | Deploy and install on Jira. Run from the forge-app-builder directory: `python3 -m scripts.deploy_forge_app`                     |\n\n\nThe scaffold script is in this skill's directory. The deploy script is in the **forge-app-builder** skill directory — always `cd` there (or derive the path from this SKILL.md's location) before running it.\n\n---\n\n## Troubleshooting\n\n| Problem | Action |\n| --- | --- |\n| `graph:connector` not recognized in manifest | Run `forge lint` — it will identify the exact field causing the error |\n| `TypeError: Cannot destructure property 'config' of 'event.payload'` | Handler using `event.payload.config` — change to `request.configProperties`. Forge passes request directly, not nested under `event.payload` |\n| `TypeError: Cannot read properties of undefined (reading 'set')` | Using `storage` from `@forge\u002Fstorage` — switch to `kvs` from `@forge\u002Fkvs` |\n| `graph.setObjects is not a function` | Wrong import — use `const { graph } = require('@forge\u002Fteamwork-graph')` then call `graph.setObjects({ objects, connectionId })` |\n| `forge lint`: invalid scopes `read\u002Fwrite:graph:teamwork` | Replace with `read:object:jira`, `write:object:jira`, `delete:object:jira` |\n| `forge lint`: `document should NOT have additional property 'function'` | `function:` is at the top level — move it inside `modules:` |\n| `forge lint`: `formConfiguration must have required property 'form'` | Replace `fields:` \u002F `beforeYouBegin:` with `form: [{ type: header, properties: [...] }]` |\n| `forge lint` warning: deprecated egress entries | Run `forge lint --fix` to auto-convert bare URL strings to `{ address: 'url' }` |\n| `forge developer-spaces list` command not found | Does not exist in Forge CLI 12.x. Have user run `forge create` interactively to select a developer space |\n| `forge create` fails with non-TTY error | `forge create` needs an interactive terminal — ask the user to run it; then write manifest and source files into the created directory |\n| `onConnectionChange` not triggered | Verify admin clicked \"Connect\" in Atlassian Administration → Connected apps; run `forge tunnel` to confirm the function fires |\n| Objects not appearing in Rovo Search | Wait ~5 minutes for indexing; run `forge logs -e development --since 15m` to check for `setObjects` errors |\n| 403 on `@forge\u002Fteamwork-graph` calls | Ensure `read:object:jira`, `write:object:jira`, `delete:object:jira` are in manifest scopes, then redeploy and `forge install --upgrade` |\n| `forge login` required | Create API token at https:\u002F\u002Fid.atlassian.com\u002Fmanage\u002Fapi-tokens, then run `forge login` |\n\n---\n\n---\n\n## Naming and Logo Guidelines\n\n- Use the **official service name** as the connector name (e.g. `Google Drive`, not `Drive Connector by Acme`)\n- Use the **official service logo** for icons — do not modify or combine with your own branding\n- These guidelines apply only to the `graph:connector` module; your Forge app itself may use your own branding\n\n",{"data":40,"body":49},{"name":4,"description":6,"license":25,"labels":41,"maintainer":47,"namespace":48},[42,43,44,8,45,46],"forge","rovo","jira","teamwork-graph","connector","mbanjan94","cloud",{"type":50,"children":51},"root",[52,60,90,97,601,607,667,671,677,684,713,752,764,770,792,802,812,825,831,848,855,1319,1325,1359,1364,1370,1397,1548,1561,1578,1595,1636,1642,1654,1698,1710,1716,1819,1825,1844,2760,2810,2823,3028,3034,3270,3276,3293,3329,3656,3662,3667,3768,3774,3812,3817,3859,3864,3912,3924,4036,4044,4123,4141,4147,4152,4160,4179,4185,4217,4231,4256,4269,4280,4314,4319,4363,4391,4397,4430,4435,4511,4524,4542,4575,4594,4600,4605,4620,4625,4631,4643,4688,4694,4713,4848,4851,4857,4984,4990,4995,5410,5416,5421,6226,6229,6235,6282,6287,6783,6788,7190,7196,7458,7461,7467,7479,7869,7872,7878,7883,7918,7923,7954,7957,7963,9075,9078,9084,9089,9226,9573,9576,9582,9679,9697,9700,9706,10183,10186,10189,10195,10246],{"type":53,"tag":54,"props":55,"children":56},"element","h1",{"id":4},[57],{"type":58,"value":59},"text","Forge Connector",{"type":53,"tag":61,"props":62,"children":63},"p",{},[64,66,73,75,81,83,88],{"type":58,"value":65},"Builds a ",{"type":53,"tag":67,"props":68,"children":70},"code",{"className":69},[],[71],{"type":58,"value":72},"graph:connector",{"type":58,"value":74}," Forge app that ingests external data into Atlassian's Teamwork Graph so it appears in ",{"type":53,"tag":76,"props":77,"children":78},"strong",{},[79],{"type":58,"value":80},"Rovo Search",{"type":58,"value":82}," and ",{"type":53,"tag":76,"props":84,"children":85},{},[86],{"type":58,"value":87},"Rovo Chat",{"type":58,"value":89},".",{"type":53,"tag":91,"props":92,"children":94},"h2",{"id":93},"critical-rules",[95],{"type":58,"value":96},"Critical Rules",{"type":53,"tag":98,"props":99,"children":100},"ol",{},[101,112,130,148,158,176,218,275,322,360,406,459,519],{"type":53,"tag":102,"props":103,"children":104},"li",{},[105,110],{"type":53,"tag":76,"props":106,"children":107},{},[108],{"type":58,"value":109},"Must install in Jira",{"type":58,"value":111}," — Apps using Teamwork Graph modules must be installed on a Jira site. Confluence-only installs will not work.",{"type":53,"tag":102,"props":113,"children":114},{},[115,120,122,128],{"type":53,"tag":76,"props":116,"children":117},{},[118],{"type":58,"value":119},"Never ask for credentials in chat",{"type":58,"value":121}," — Direct users to run ",{"type":53,"tag":67,"props":123,"children":125},{"className":124},[],[126],{"type":58,"value":127},"forge login",{"type":58,"value":129}," in their own terminal.",{"type":53,"tag":102,"props":131,"children":132},{},[133,138,140,146],{"type":53,"tag":76,"props":134,"children":135},{},[136],{"type":58,"value":137},"Always run the scaffold script yourself",{"type":58,"value":139}," — Do not only give manual instructions; run ",{"type":53,"tag":67,"props":141,"children":143},{"className":142},[],[144],{"type":58,"value":145},"scripts\u002Fscaffold_connector.py",{"type":58,"value":147}," to generate the boilerplate.",{"type":53,"tag":102,"props":149,"children":150},{},[151,156],{"type":53,"tag":76,"props":152,"children":153},{},[154],{"type":58,"value":155},"Always ask the user for their Atlassian site URL",{"type":58,"value":157}," when install is needed — never discover or guess it.",{"type":53,"tag":102,"props":159,"children":160},{},[161,166,168,174],{"type":53,"tag":76,"props":162,"children":163},{},[164],{"type":58,"value":165},"Atlassian deletes data on disconnect",{"type":58,"value":167}," — When ",{"type":53,"tag":67,"props":169,"children":171},{"className":170},[],[172],{"type":58,"value":173},"action = 'DELETED'",{"type":58,"value":175},", the app only needs to clean up local state; Atlassian removes the Teamwork Graph data automatically.",{"type":53,"tag":102,"props":177,"children":178},{},[179,184,186,192,194,200,202,208,210,216],{"type":53,"tag":76,"props":180,"children":181},{},[182],{"type":58,"value":183},"Handler arguments are passed directly",{"type":58,"value":185}," — Forge passes the request object as the first argument to handlers, NOT nested under ",{"type":53,"tag":67,"props":187,"children":189},{"className":188},[],[190],{"type":58,"value":191},"event.payload",{"type":58,"value":193},". Config values are at ",{"type":53,"tag":67,"props":195,"children":197},{"className":196},[],[198],{"type":58,"value":199},"request.configProperties",{"type":58,"value":201},", NOT ",{"type":53,"tag":67,"props":203,"children":205},{"className":204},[],[206],{"type":58,"value":207},"event.payload.config",{"type":58,"value":209},". This is the most common source of ",{"type":53,"tag":67,"props":211,"children":213},{"className":212},[],[214],{"type":58,"value":215},"TypeError: Cannot destructure property of undefined",{"type":58,"value":217}," errors.",{"type":53,"tag":102,"props":219,"children":220},{},[221,234,236,242,244,249,251,257,259,265,267,273],{"type":53,"tag":76,"props":222,"children":223},{},[224,226,232],{"type":58,"value":225},"Use ",{"type":53,"tag":67,"props":227,"children":229},{"className":228},[],[230],{"type":58,"value":231},"@forge\u002Fkvs",{"type":58,"value":233}," for storage",{"type":58,"value":235}," — Import ",{"type":53,"tag":67,"props":237,"children":239},{"className":238},[],[240],{"type":58,"value":241},"kvs",{"type":58,"value":243}," from ",{"type":53,"tag":67,"props":245,"children":247},{"className":246},[],[248],{"type":58,"value":231},{"type":58,"value":250},". Do NOT use ",{"type":53,"tag":67,"props":252,"children":254},{"className":253},[],[255],{"type":58,"value":256},"@forge\u002Fstorage",{"type":58,"value":258}," — its ",{"type":53,"tag":67,"props":260,"children":262},{"className":261},[],[263],{"type":58,"value":264},"storage",{"type":58,"value":266}," export is ",{"type":53,"tag":67,"props":268,"children":270},{"className":269},[],[271],{"type":58,"value":272},"undefined",{"type":58,"value":274}," at runtime in connector functions.",{"type":53,"tag":102,"props":276,"children":277},{},[278,296,298,304,306,312,314,320],{"type":53,"tag":76,"props":279,"children":280},{},[281,282,288,290],{"type":58,"value":225},{"type":53,"tag":67,"props":283,"children":285},{"className":284},[],[286],{"type":58,"value":287},"graph",{"type":58,"value":289}," named export from ",{"type":53,"tag":67,"props":291,"children":293},{"className":292},[],[294],{"type":58,"value":295},"@forge\u002Fteamwork-graph",{"type":58,"value":297}," — The correct import is ",{"type":53,"tag":67,"props":299,"children":301},{"className":300},[],[302],{"type":58,"value":303},"const { graph } = require('@forge\u002Fteamwork-graph')",{"type":58,"value":305},". Call ",{"type":53,"tag":67,"props":307,"children":309},{"className":308},[],[310],{"type":58,"value":311},"graph.setObjects({ objects, connectionId })",{"type":58,"value":313},". Do NOT import ",{"type":53,"tag":67,"props":315,"children":317},{"className":316},[],[318],{"type":58,"value":319},"setObjects",{"type":58,"value":321}," as a named export directly.",{"type":53,"tag":102,"props":323,"children":324},{},[325,342,344,350,352,358],{"type":53,"tag":76,"props":326,"children":327},{},[328,334,336],{"type":53,"tag":67,"props":329,"children":331},{"className":330},[],[332],{"type":58,"value":333},"validateConnectionHandler",{"type":58,"value":335}," must return ",{"type":53,"tag":67,"props":337,"children":339},{"className":338},[],[340],{"type":58,"value":341},"{ success, message }",{"type":58,"value":343}," — Do NOT throw an Error. Return ",{"type":53,"tag":67,"props":345,"children":347},{"className":346},[],[348],{"type":58,"value":349},"{ success: false, message: '...' }",{"type":58,"value":351}," to reject, ",{"type":53,"tag":67,"props":353,"children":355},{"className":354},[],[356],{"type":58,"value":357},"{ success: true }",{"type":58,"value":359}," to accept.",{"type":53,"tag":102,"props":361,"children":362},{},[363,380,382,388,390,396,398,404],{"type":53,"tag":76,"props":364,"children":365},{},[366,372,374],{"type":53,"tag":67,"props":367,"children":369},{"className":368},[],[370],{"type":58,"value":371},"function",{"type":58,"value":373}," declarations belong under ",{"type":53,"tag":67,"props":375,"children":377},{"className":376},[],[378],{"type":58,"value":379},"modules",{"type":58,"value":381}," — In ",{"type":53,"tag":67,"props":383,"children":385},{"className":384},[],[386],{"type":58,"value":387},"manifest.yml",{"type":58,"value":389},", ",{"type":53,"tag":67,"props":391,"children":393},{"className":392},[],[394],{"type":58,"value":395},"function:",{"type":58,"value":397}," is a key under ",{"type":53,"tag":67,"props":399,"children":401},{"className":400},[],[402],{"type":58,"value":403},"modules:",{"type":58,"value":405},", not a top-level key. Placing it at the top level causes a lint error.",{"type":53,"tag":102,"props":407,"children":408},{},[409,434,436,442,444,450,452,458],{"type":53,"tag":76,"props":410,"children":411},{},[412,418,420,426,428],{"type":53,"tag":67,"props":413,"children":415},{"className":414},[],[416],{"type":58,"value":417},"formConfiguration",{"type":58,"value":419}," uses ",{"type":53,"tag":67,"props":421,"children":423},{"className":422},[],[424],{"type":58,"value":425},"form",{"type":58,"value":427}," array with ",{"type":53,"tag":67,"props":429,"children":431},{"className":430},[],[432],{"type":58,"value":433},"type: header",{"type":58,"value":435}," — Do NOT use ",{"type":53,"tag":67,"props":437,"children":439},{"className":438},[],[440],{"type":58,"value":441},"fields:",{"type":58,"value":443}," or ",{"type":53,"tag":67,"props":445,"children":447},{"className":446},[],[448],{"type":58,"value":449},"beforeYouBegin:",{"type":58,"value":451},". The correct format uses ",{"type":53,"tag":67,"props":453,"children":455},{"className":454},[],[456],{"type":58,"value":457},"form: [{ key, type: header, title, description, properties: [...] }]",{"type":58,"value":89},{"type":53,"tag":102,"props":460,"children":461},{},[462,473,475,481,482,488,489,495,497,503,504,510,512,518],{"type":53,"tag":76,"props":463,"children":464},{},[465,467],{"type":58,"value":466},"Scopes are ",{"type":53,"tag":67,"props":468,"children":470},{"className":469},[],[471],{"type":58,"value":472},"read\u002Fwrite\u002Fdelete:object:jira",{"type":58,"value":474}," — Use ",{"type":53,"tag":67,"props":476,"children":478},{"className":477},[],[479],{"type":58,"value":480},"read:object:jira",{"type":58,"value":389},{"type":53,"tag":67,"props":483,"children":485},{"className":484},[],[486],{"type":58,"value":487},"write:object:jira",{"type":58,"value":389},{"type":53,"tag":67,"props":490,"children":492},{"className":491},[],[493],{"type":58,"value":494},"delete:object:jira",{"type":58,"value":496},". The scopes ",{"type":53,"tag":67,"props":498,"children":500},{"className":499},[],[501],{"type":58,"value":502},"read:graph:teamwork",{"type":58,"value":82},{"type":53,"tag":67,"props":505,"children":507},{"className":506},[],[508],{"type":58,"value":509},"write:graph:teamwork",{"type":58,"value":511}," are invalid and will fail ",{"type":53,"tag":67,"props":513,"children":515},{"className":514},[],[516],{"type":58,"value":517},"forge lint",{"type":58,"value":89},{"type":53,"tag":102,"props":520,"children":521},{},[522,542,544,549,551,556,557,563,564,570,572,585,587,592,593,599],{"type":53,"tag":76,"props":523,"children":524},{},[525,527,533,535,540],{"type":58,"value":526},"Set ",{"type":53,"tag":67,"props":528,"children":530},{"className":529},[],[531],{"type":58,"value":532},"ATL_FORGE_ATTRIBUTION_SKILL_NAME=forge-connector",{"type":58,"value":534}," on ",{"type":53,"tag":67,"props":536,"children":538},{"className":537},[],[539],{"type":58,"value":42},{"type":58,"value":541}," commands run for this skill",{"type":58,"value":543}," — prefix ",{"type":53,"tag":67,"props":545,"children":547},{"className":546},[],[548],{"type":58,"value":42},{"type":58,"value":550}," invocations with this env var: ones you run in the shell (e.g. ",{"type":53,"tag":67,"props":552,"children":554},{"className":553},[],[555],{"type":58,"value":517},{"type":58,"value":389},{"type":53,"tag":67,"props":558,"children":560},{"className":559},[],[561],{"type":58,"value":562},"forge logs",{"type":58,"value":389},{"type":53,"tag":67,"props":565,"children":567},{"className":566},[],[568],{"type":58,"value":569},"forge deploy",{"type":58,"value":571},") ",{"type":53,"tag":76,"props":573,"children":574},{},[575,577,583],{"type":58,"value":576},"and the interactive ",{"type":53,"tag":67,"props":578,"children":580},{"className":579},[],[581],{"type":58,"value":582},"forge create",{"type":58,"value":584}," command you hand the user as a fallback",{"type":58,"value":586},". The bundled scripts set it automatically; other commands shown in this skill omit it for brevity — add it when you run them. The only exclusions are ",{"type":53,"tag":67,"props":588,"children":590},{"className":589},[],[591],{"type":58,"value":127},{"type":58,"value":82},{"type":53,"tag":67,"props":594,"children":596},{"className":595},[],[597],{"type":58,"value":598},"forge tunnel",{"type":58,"value":600}," (user-run auth \u002F live-dev commands).",{"type":53,"tag":91,"props":602,"children":604},{"id":603},"mcp-prerequisites",[605],{"type":58,"value":606},"MCP Prerequisites",{"type":53,"tag":608,"props":609,"children":610},"table",{},[611,630],{"type":53,"tag":612,"props":613,"children":614},"thead",{},[615],{"type":53,"tag":616,"props":617,"children":618},"tr",{},[619,625],{"type":53,"tag":620,"props":621,"children":622},"th",{},[623],{"type":58,"value":624},"MCP Server",{"type":53,"tag":620,"props":626,"children":627},{},[628],{"type":58,"value":629},"Purpose",{"type":53,"tag":631,"props":632,"children":633},"tbody",{},[634,651],{"type":53,"tag":616,"props":635,"children":636},{},[637,646],{"type":53,"tag":638,"props":639,"children":640},"td",{},[641],{"type":53,"tag":76,"props":642,"children":643},{},[644],{"type":58,"value":645},"Forge MCP",{"type":53,"tag":638,"props":647,"children":648},{},[649],{"type":58,"value":650},"Manifest syntax, module config, deployment guides",{"type":53,"tag":616,"props":652,"children":653},{},[654,662],{"type":53,"tag":638,"props":655,"children":656},{},[657],{"type":53,"tag":76,"props":658,"children":659},{},[660],{"type":58,"value":661},"ADS MCP",{"type":53,"tag":638,"props":663,"children":664},{},[665],{"type":58,"value":666},"Atlaskit components (only if adding Custom UI)",{"type":53,"tag":668,"props":669,"children":670},"hr",{},[],{"type":53,"tag":91,"props":672,"children":674},{"id":673},"agent-workflow-complete-steps-07-in-order",[675],{"type":58,"value":676},"Agent Workflow — Complete Steps 0–7 in Order",{"type":53,"tag":678,"props":679,"children":681},"h3",{"id":680},"step-0-prerequisites",[682],{"type":58,"value":683},"Step 0: Prerequisites",{"type":53,"tag":61,"props":685,"children":686},{},[687,689,695,697,703,705,711],{"type":58,"value":688},"Check Node.js (",{"type":53,"tag":67,"props":690,"children":692},{"className":691},[],[693],{"type":58,"value":694},"node -v",{"type":58,"value":696},", requires 22+), Forge CLI (",{"type":53,"tag":67,"props":698,"children":700},{"className":699},[],[701],{"type":58,"value":702},"forge --version",{"type":58,"value":704},"), and login (",{"type":53,"tag":67,"props":706,"children":708},{"className":707},[],[709],{"type":58,"value":710},"forge whoami",{"type":58,"value":712},"). Install missing tools:",{"type":53,"tag":714,"props":715,"children":720},"pre",{"className":716,"code":717,"language":718,"meta":719,"style":719},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","npm install -g @forge\u002Fcli\n","bash","",[721],{"type":53,"tag":67,"props":722,"children":723},{"__ignoreMap":719},[724],{"type":53,"tag":725,"props":726,"children":729},"span",{"class":727,"line":728},"line",1,[730,736,742,747],{"type":53,"tag":725,"props":731,"children":733},{"style":732},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[734],{"type":58,"value":735},"npm",{"type":53,"tag":725,"props":737,"children":739},{"style":738},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[740],{"type":58,"value":741}," install",{"type":53,"tag":725,"props":743,"children":744},{"style":738},[745],{"type":58,"value":746}," -g",{"type":53,"tag":725,"props":748,"children":749},{"style":738},[750],{"type":58,"value":751}," @forge\u002Fcli\n",{"type":53,"tag":61,"props":753,"children":754},{},[755,757,762],{"type":58,"value":756},"Tell the user to run ",{"type":53,"tag":67,"props":758,"children":760},{"className":759},[],[761],{"type":58,"value":127},{"type":58,"value":763}," in their terminal if not authenticated.",{"type":53,"tag":678,"props":765,"children":767},{"id":766},"step-1-discover-developer-spaces",[768],{"type":58,"value":769},"Step 1: Discover Developer Spaces",{"type":53,"tag":771,"props":772,"children":773},"blockquote",{},[774],{"type":53,"tag":61,"props":775,"children":776},{},[777,782,784,790],{"type":53,"tag":76,"props":778,"children":779},{},[780],{"type":58,"value":781},"Note:",{"type":58,"value":783}," ",{"type":53,"tag":67,"props":785,"children":787},{"className":786},[],[788],{"type":58,"value":789},"forge developer-spaces list",{"type":58,"value":791}," does NOT exist in Forge CLI 12.x. You cannot list developer spaces non-interactively.",{"type":53,"tag":61,"props":793,"children":794},{},[795,800],{"type":53,"tag":67,"props":796,"children":798},{"className":797},[],[799],{"type":58,"value":582},{"type":58,"value":801}," requires an interactive TTY to select a developer space. Ask the user to run it themselves:",{"type":53,"tag":714,"props":803,"children":807},{"className":804,"code":806,"language":58},[805],"language-text","Tell the user:\n  cd \u003Cparent-directory>\n  ATL_FORGE_ATTRIBUTION_SKILL_NAME=forge-connector forge create --template blank \u003Capp-name>\n\n  When prompted, select a Developer Space and let it complete.\n  Come back when done.\n",[808],{"type":53,"tag":67,"props":809,"children":810},{"__ignoreMap":719},[811],{"type":58,"value":806},{"type":53,"tag":61,"props":813,"children":814},{},[815,817,823],{"type":58,"value":816},"The ",{"type":53,"tag":67,"props":818,"children":820},{"className":819},[],[821],{"type":58,"value":822},"--dev-space-id",{"type":58,"value":824}," flag in the scaffold script is optional and can be omitted — the script has been updated to skip it when not provided.",{"type":53,"tag":678,"props":826,"children":828},{"id":827},"step-15-discover-data-map-to-object-types",[829],{"type":58,"value":830},"Step 1.5: Discover Data & Map to Object Types",{"type":53,"tag":61,"props":832,"children":833},{},[834,839,841,847],{"type":53,"tag":76,"props":835,"children":836},{},[837],{"type":58,"value":838},"Do this before scaffolding.",{"type":58,"value":840}," Ask the user the following questions to determine the correct Teamwork Graph object type(s). Do not assume or default to ",{"type":53,"tag":67,"props":842,"children":844},{"className":843},[],[845],{"type":58,"value":846},"atlassian:document",{"type":58,"value":89},{"type":53,"tag":849,"props":850,"children":852},"h4",{"id":851},"questions-to-ask-the-user",[853],{"type":58,"value":854},"Questions to ask the user",{"type":53,"tag":98,"props":856,"children":857},{},[858,868,1031,1064,1082,1116],{"type":53,"tag":102,"props":859,"children":860},{},[861,866],{"type":53,"tag":76,"props":862,"children":863},{},[864],{"type":58,"value":865},"What external system or tool are you connecting?",{"type":58,"value":867},"\ne.g. Google Drive, ServiceNow, Salesforce, GitHub, Confluence, Slack, Figma, Zendesk",{"type":53,"tag":102,"props":869,"children":870},{},[871,876,878],{"type":53,"tag":76,"props":872,"children":873},{},[874],{"type":58,"value":875},"What kind of content do you want to make searchable in Rovo?",{"type":58,"value":877},"\nPrompt with examples to help them identify it:",{"type":53,"tag":879,"props":880,"children":881},"ul",{},[882,892,903,921,932,943,954,965,976,987,998,1009,1020],{"type":53,"tag":102,"props":883,"children":884},{},[885,887],{"type":58,"value":886},"Files, pages, wiki articles, reports, PDFs → likely ",{"type":53,"tag":67,"props":888,"children":890},{"className":889},[],[891],{"type":58,"value":846},{"type":53,"tag":102,"props":893,"children":894},{},[895,897],{"type":58,"value":896},"Tasks, tickets, issues, bugs, stories → likely ",{"type":53,"tag":67,"props":898,"children":900},{"className":899},[],[901],{"type":58,"value":902},"atlassian:work-item",{"type":53,"tag":102,"props":904,"children":905},{},[906,908,914,915],{"type":58,"value":907},"Chat messages, emails, comments → likely ",{"type":53,"tag":67,"props":909,"children":911},{"className":910},[],[912],{"type":58,"value":913},"atlassian:message",{"type":58,"value":443},{"type":53,"tag":67,"props":916,"children":918},{"className":917},[],[919],{"type":58,"value":920},"atlassian:comment",{"type":53,"tag":102,"props":922,"children":923},{},[924,926],{"type":58,"value":925},"Projects, workspaces, boards → likely ",{"type":53,"tag":67,"props":927,"children":929},{"className":928},[],[930],{"type":58,"value":931},"atlassian:project",{"type":53,"tag":102,"props":933,"children":934},{},[935,937],{"type":58,"value":936},"Code repositories → likely ",{"type":53,"tag":67,"props":938,"children":940},{"className":939},[],[941],{"type":58,"value":942},"atlassian:repository",{"type":53,"tag":102,"props":944,"children":945},{},[946,948],{"type":58,"value":947},"Pull requests \u002F merge requests → likely ",{"type":53,"tag":67,"props":949,"children":951},{"className":950},[],[952],{"type":58,"value":953},"atlassian:pull-request",{"type":53,"tag":102,"props":955,"children":956},{},[957,959],{"type":58,"value":958},"Git commits → likely ",{"type":53,"tag":67,"props":960,"children":962},{"className":961},[],[963],{"type":58,"value":964},"atlassian:commit",{"type":53,"tag":102,"props":966,"children":967},{},[968,970],{"type":58,"value":969},"Design files (Figma, Sketch) → likely ",{"type":53,"tag":67,"props":971,"children":973},{"className":972},[],[974],{"type":58,"value":975},"atlassian:design",{"type":53,"tag":102,"props":977,"children":978},{},[979,981],{"type":58,"value":980},"Video recordings → likely ",{"type":53,"tag":67,"props":982,"children":984},{"className":983},[],[985],{"type":58,"value":986},"atlassian:video",{"type":53,"tag":102,"props":988,"children":989},{},[990,992],{"type":58,"value":991},"Calendar events, meetings → likely ",{"type":53,"tag":67,"props":993,"children":995},{"className":994},[],[996],{"type":58,"value":997},"atlassian:calendar-event",{"type":53,"tag":102,"props":999,"children":1000},{},[1001,1003],{"type":58,"value":1002},"Threads, channels → likely ",{"type":53,"tag":67,"props":1004,"children":1006},{"className":1005},[],[1007],{"type":58,"value":1008},"atlassian:conversation",{"type":53,"tag":102,"props":1010,"children":1011},{},[1012,1014],{"type":58,"value":1013},"Customer accounts or organisations → likely ",{"type":53,"tag":67,"props":1015,"children":1017},{"className":1016},[],[1018],{"type":58,"value":1019},"atlassian:customer-organization",{"type":53,"tag":102,"props":1021,"children":1022},{},[1023,1025],{"type":58,"value":1024},"Team spaces or org units → likely ",{"type":53,"tag":67,"props":1026,"children":1028},{"className":1027},[],[1029],{"type":58,"value":1030},"atlassian:space",{"type":53,"tag":102,"props":1032,"children":1033},{},[1034,1039,1041,1047,1049,1055,1057,1062],{"type":53,"tag":76,"props":1035,"children":1036},{},[1037],{"type":58,"value":1038},"Is the content a single type or a mix?",{"type":58,"value":1040},"\nIf mixed (e.g. a project management tool with tasks ",{"type":53,"tag":1042,"props":1043,"children":1044},"em",{},[1045],{"type":58,"value":1046},"and",{"type":58,"value":1048}," documents), plan to ingest each as its own object type. The scaffold supports one primary type — you can add more ",{"type":53,"tag":67,"props":1050,"children":1052},{"className":1051},[],[1053],{"type":58,"value":1054},"objectTypes",{"type":58,"value":1056}," entries in ",{"type":53,"tag":67,"props":1058,"children":1060},{"className":1059},[],[1061],{"type":58,"value":387},{"type":58,"value":1063}," later.",{"type":53,"tag":102,"props":1065,"children":1066},{},[1067,1072,1074,1080],{"type":53,"tag":76,"props":1068,"children":1069},{},[1070],{"type":58,"value":1071},"Does the admin need to supply credentials (API key, URL, OAuth token) to connect?",{"type":58,"value":1073},"\nYes → use ",{"type":53,"tag":67,"props":1075,"children":1077},{"className":1076},[],[1078],{"type":58,"value":1079},"--has-form-config",{"type":58,"value":1081}," in the scaffold command.\nNo (data comes entirely from within Atlassian) → omit the flag.",{"type":53,"tag":102,"props":1083,"children":1084},{},[1085,1090,1092,1098,1100,1106,1108,1114],{"type":53,"tag":76,"props":1086,"children":1087},{},[1088],{"type":58,"value":1089},"How often does the source data change?",{"type":58,"value":1091},"\nFrequently (hourly) → plan a ",{"type":53,"tag":67,"props":1093,"children":1095},{"className":1094},[],[1096],{"type":58,"value":1097},"scheduledTrigger",{"type":58,"value":1099}," with ",{"type":53,"tag":67,"props":1101,"children":1103},{"className":1102},[],[1104],{"type":58,"value":1105},"interval: hour",{"type":58,"value":1107},".\nDaily or less → ",{"type":53,"tag":67,"props":1109,"children":1111},{"className":1110},[],[1112],{"type":58,"value":1113},"interval: day",{"type":58,"value":1115},".\nStatic \u002F one-off → no scheduled trigger needed.",{"type":53,"tag":102,"props":1117,"children":1118},{},[1119,1124,1126,1132,1134,1147,1151,1153,1284,1287,1298,1300,1305,1307,1310,1312,1317],{"type":53,"tag":76,"props":1120,"children":1121},{},[1122],{"type":58,"value":1123},"Who should be able to see the ingested content in Rovo Search?",{"type":58,"value":1125},"\nThis determines the ",{"type":53,"tag":67,"props":1127,"children":1129},{"className":1128},[],[1130],{"type":58,"value":1131},"permissions.accessControls",{"type":58,"value":1133}," on each object. Ask:",{"type":53,"tag":879,"props":1135,"children":1136},{},[1137,1142],{"type":53,"tag":102,"props":1138,"children":1139},{},[1140],{"type":58,"value":1141},"\"Is all this content publicly accessible, or does the source system restrict who can see what?\"",{"type":53,"tag":102,"props":1143,"children":1144},{},[1145],{"type":58,"value":1146},"\"Do you want Rovo Search results to respect those source-system permissions?\"",{"type":53,"tag":1148,"props":1149,"children":1150},"br",{},[],{"type":58,"value":1152},"Map the answer to the correct principal model:",{"type":53,"tag":608,"props":1154,"children":1155},{},[1156,1178],{"type":53,"tag":612,"props":1157,"children":1158},{},[1159],{"type":53,"tag":616,"props":1160,"children":1161},{},[1162,1167],{"type":53,"tag":620,"props":1163,"children":1164},{},[1165],{"type":58,"value":1166},"Source system access model",{"type":53,"tag":620,"props":1168,"children":1169},{},[1170,1176],{"type":53,"tag":67,"props":1171,"children":1173},{"className":1172},[],[1174],{"type":58,"value":1175},"accessControls",{"type":58,"value":1177}," to use",{"type":53,"tag":631,"props":1179,"children":1180},{},[1181,1198,1217,1236,1257],{"type":53,"tag":616,"props":1182,"children":1183},{},[1184,1189],{"type":53,"tag":638,"props":1185,"children":1186},{},[1187],{"type":58,"value":1188},"Publicly accessible, no restrictions",{"type":53,"tag":638,"props":1190,"children":1191},{},[1192],{"type":53,"tag":67,"props":1193,"children":1195},{"className":1194},[],[1196],{"type":58,"value":1197},"principals: [{ type: 'EVERYONE' }]",{"type":53,"tag":616,"props":1199,"children":1200},{},[1201,1206],{"type":53,"tag":638,"props":1202,"children":1203},{},[1204],{"type":58,"value":1205},"Specific named users have access",{"type":53,"tag":638,"props":1207,"children":1208},{},[1209,1215],{"type":53,"tag":67,"props":1210,"children":1212},{"className":1211},[],[1213],{"type":58,"value":1214},"principals: [{ type: 'user', id: '\u003Catlassian-account-id>' }]",{"type":58,"value":1216}," — one entry per user",{"type":53,"tag":616,"props":1218,"children":1219},{},[1220,1225],{"type":53,"tag":638,"props":1221,"children":1222},{},[1223],{"type":58,"value":1224},"Team or group based (e.g. Confluence space, Google Workspace group)",{"type":53,"tag":638,"props":1226,"children":1227},{},[1228,1234],{"type":53,"tag":67,"props":1229,"children":1231},{"className":1230},[],[1232],{"type":58,"value":1233},"principals: [{ type: 'group', id: '\u003Cgroup-id>' }]",{"type":58,"value":1235}," — one entry per group",{"type":53,"tag":616,"props":1237,"children":1238},{},[1239,1244],{"type":53,"tag":638,"props":1240,"children":1241},{},[1242],{"type":58,"value":1243},"Private \u002F owner only",{"type":53,"tag":638,"props":1245,"children":1246},{},[1247,1249,1255],{"type":58,"value":1248},"single ",{"type":53,"tag":67,"props":1250,"children":1252},{"className":1251},[],[1253],{"type":58,"value":1254},"user",{"type":58,"value":1256}," principal with the owner's Atlassian account ID",{"type":53,"tag":616,"props":1258,"children":1259},{},[1260,1265],{"type":53,"tag":638,"props":1261,"children":1262},{},[1263],{"type":58,"value":1264},"Mixed (per-object ACLs from the source)",{"type":53,"tag":638,"props":1266,"children":1267},{},[1268,1270,1275,1276,1282],{"type":58,"value":1269},"fetch ACLs per item during ingestion and map each to a ",{"type":53,"tag":67,"props":1271,"children":1273},{"className":1272},[],[1274],{"type":58,"value":1254},{"type":58,"value":443},{"type":53,"tag":67,"props":1277,"children":1279},{"className":1278},[],[1280],{"type":58,"value":1281},"group",{"type":58,"value":1283}," principal",{"type":53,"tag":1148,"props":1285,"children":1286},{},[],{"type":53,"tag":76,"props":1288,"children":1289},{},[1290,1292],{"type":58,"value":1291},"Do NOT default to ",{"type":53,"tag":67,"props":1293,"children":1295},{"className":1294},[],[1296],{"type":58,"value":1297},"EVERYONE",{"type":58,"value":1299}," unless the user explicitly confirms content is publicly accessible. Using ",{"type":53,"tag":67,"props":1301,"children":1303},{"className":1302},[],[1304],{"type":58,"value":1297},{"type":58,"value":1306}," on restricted content leaks data to users who shouldn't see it in Rovo Search.",{"type":53,"tag":1148,"props":1308,"children":1309},{},[],{"type":58,"value":1311},"Record the chosen permission model before proceeding to Step 2. Reference it when writing the ",{"type":53,"tag":67,"props":1313,"children":1315},{"className":1314},[],[1316],{"type":58,"value":319},{"type":58,"value":1318}," call in Step 3.",{"type":53,"tag":849,"props":1320,"children":1322},{"id":1321},"mapping-decision",[1323],{"type":58,"value":1324},"Mapping decision",{"type":53,"tag":61,"props":1326,"children":1327},{},[1328,1330,1335,1337,1343,1344,1350,1351,1357],{"type":58,"value":1329},"Based on the answers, select the best-fit type from the Object Types table below. Only fall back to ",{"type":53,"tag":67,"props":1331,"children":1333},{"className":1332},[],[1334],{"type":58,"value":846},{"type":58,"value":1336}," if the content genuinely has no better match (e.g. arbitrary file attachments). For types marked ❌ in the \"Indexed in Rovo\" column (",{"type":53,"tag":67,"props":1338,"children":1340},{"className":1339},[],[1341],{"type":58,"value":1342},"atlassian:build",{"type":58,"value":389},{"type":53,"tag":67,"props":1345,"children":1347},{"className":1346},[],[1348],{"type":58,"value":1349},"atlassian:deployment",{"type":58,"value":389},{"type":53,"tag":67,"props":1352,"children":1354},{"className":1353},[],[1355],{"type":58,"value":1356},"atlassian:test",{"type":58,"value":1358},"), warn the user that those objects will not appear in Rovo Search or Rovo Chat.",{"type":53,"tag":61,"props":1360,"children":1361},{},[1362],{"type":58,"value":1363},"Record the chosen object type(s) and permission model before proceeding to Step 2.",{"type":53,"tag":678,"props":1365,"children":1367},{"id":1366},"step-2-scaffold-the-connector-app",[1368],{"type":58,"value":1369},"Step 2: Scaffold the Connector App",{"type":53,"tag":61,"props":1371,"children":1372},{},[1373,1375,1380,1382,1388,1390,1395],{"type":58,"value":1374},"Run from the ",{"type":53,"tag":76,"props":1376,"children":1377},{},[1378],{"type":58,"value":1379},"skill directory",{"type":58,"value":1381}," (the directory containing this SKILL.md). Replace ",{"type":53,"tag":67,"props":1383,"children":1385},{"className":1384},[],[1386],{"type":58,"value":1387},"\u003Cobject-type>",{"type":58,"value":1389}," with the type determined in Step 1.5. ",{"type":53,"tag":67,"props":1391,"children":1393},{"className":1392},[],[1394],{"type":58,"value":822},{"type":58,"value":1396}," is optional:",{"type":53,"tag":714,"props":1398,"children":1400},{"className":716,"code":1399,"language":718,"meta":719,"style":719},"python3 -m scripts.scaffold_connector \\\n  --name \u003Capp-name> \\\n  --connector-name \"\u003CHuman Readable Name>\" \\\n  --object-type \u003Cobject-type> \\\n  --directory \u003Cparent-directory>\n",[1401],{"type":53,"tag":67,"props":1402,"children":1403},{"__ignoreMap":719},[1404,1428,1462,1490,1520],{"type":53,"tag":725,"props":1405,"children":1406},{"class":727,"line":728},[1407,1412,1417,1422],{"type":53,"tag":725,"props":1408,"children":1409},{"style":732},[1410],{"type":58,"value":1411},"python3",{"type":53,"tag":725,"props":1413,"children":1414},{"style":738},[1415],{"type":58,"value":1416}," -m",{"type":53,"tag":725,"props":1418,"children":1419},{"style":738},[1420],{"type":58,"value":1421}," scripts.scaffold_connector",{"type":53,"tag":725,"props":1423,"children":1425},{"style":1424},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[1426],{"type":58,"value":1427}," \\\n",{"type":53,"tag":725,"props":1429,"children":1431},{"class":727,"line":1430},2,[1432,1437,1443,1448,1453,1458],{"type":53,"tag":725,"props":1433,"children":1434},{"style":738},[1435],{"type":58,"value":1436},"  --name",{"type":53,"tag":725,"props":1438,"children":1440},{"style":1439},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[1441],{"type":58,"value":1442}," \u003C",{"type":53,"tag":725,"props":1444,"children":1445},{"style":738},[1446],{"type":58,"value":1447},"app-nam",{"type":53,"tag":725,"props":1449,"children":1450},{"style":1424},[1451],{"type":58,"value":1452},"e",{"type":53,"tag":725,"props":1454,"children":1455},{"style":1439},[1456],{"type":58,"value":1457},">",{"type":53,"tag":725,"props":1459,"children":1460},{"style":1424},[1461],{"type":58,"value":1427},{"type":53,"tag":725,"props":1463,"children":1465},{"class":727,"line":1464},3,[1466,1471,1476,1481,1486],{"type":53,"tag":725,"props":1467,"children":1468},{"style":738},[1469],{"type":58,"value":1470},"  --connector-name",{"type":53,"tag":725,"props":1472,"children":1473},{"style":1439},[1474],{"type":58,"value":1475}," \"",{"type":53,"tag":725,"props":1477,"children":1478},{"style":738},[1479],{"type":58,"value":1480},"\u003CHuman Readable Name>",{"type":53,"tag":725,"props":1482,"children":1483},{"style":1439},[1484],{"type":58,"value":1485},"\"",{"type":53,"tag":725,"props":1487,"children":1488},{"style":1424},[1489],{"type":58,"value":1427},{"type":53,"tag":725,"props":1491,"children":1493},{"class":727,"line":1492},4,[1494,1499,1503,1508,1512,1516],{"type":53,"tag":725,"props":1495,"children":1496},{"style":738},[1497],{"type":58,"value":1498},"  --object-type",{"type":53,"tag":725,"props":1500,"children":1501},{"style":1439},[1502],{"type":58,"value":1442},{"type":53,"tag":725,"props":1504,"children":1505},{"style":738},[1506],{"type":58,"value":1507},"object-typ",{"type":53,"tag":725,"props":1509,"children":1510},{"style":1424},[1511],{"type":58,"value":1452},{"type":53,"tag":725,"props":1513,"children":1514},{"style":1439},[1515],{"type":58,"value":1457},{"type":53,"tag":725,"props":1517,"children":1518},{"style":1424},[1519],{"type":58,"value":1427},{"type":53,"tag":725,"props":1521,"children":1523},{"class":727,"line":1522},5,[1524,1529,1533,1538,1543],{"type":53,"tag":725,"props":1525,"children":1526},{"style":738},[1527],{"type":58,"value":1528},"  --directory",{"type":53,"tag":725,"props":1530,"children":1531},{"style":1439},[1532],{"type":58,"value":1442},{"type":53,"tag":725,"props":1534,"children":1535},{"style":738},[1536],{"type":58,"value":1537},"parent-director",{"type":53,"tag":725,"props":1539,"children":1540},{"style":1424},[1541],{"type":58,"value":1542},"y",{"type":53,"tag":725,"props":1544,"children":1545},{"style":1439},[1546],{"type":58,"value":1547},">\n",{"type":53,"tag":61,"props":1549,"children":1550},{},[1551,1553,1559],{"type":58,"value":1552},"Add ",{"type":53,"tag":67,"props":1554,"children":1556},{"className":1555},[],[1557],{"type":58,"value":1558},"--dev-space-id \u003Cid>",{"type":58,"value":1560}," only if you have the ID from a previous step.",{"type":53,"tag":61,"props":1562,"children":1563},{},[1564,1569,1571,1576],{"type":53,"tag":76,"props":1565,"children":1566},{},[1567],{"type":58,"value":1568},"Object type",{"type":58,"value":1570}," — use the type chosen in Step 1.5. Do NOT default to ",{"type":53,"tag":67,"props":1572,"children":1574},{"className":1573},[],[1575],{"type":58,"value":846},{"type":58,"value":1577}," without first completing the discovery questions above.",{"type":53,"tag":61,"props":1579,"children":1580},{},[1581,1586,1588,1593],{"type":53,"tag":76,"props":1582,"children":1583},{},[1584],{"type":58,"value":1585},"Form config flag",{"type":58,"value":1587}," — add ",{"type":53,"tag":67,"props":1589,"children":1591},{"className":1590},[],[1592],{"type":58,"value":1079},{"type":58,"value":1594}," if the admin must provide API credentials or connection details (determined in Step 1.5 question 4). Omit it for apps that operate entirely within Atlassian (no external credentials needed).",{"type":53,"tag":771,"props":1596,"children":1597},{},[1598],{"type":53,"tag":61,"props":1599,"children":1600},{},[1601,1613,1615,1620,1622,1627,1628,1634],{"type":53,"tag":76,"props":1602,"children":1603},{},[1604,1606,1611],{"type":58,"value":1605},"If scaffold fails because ",{"type":53,"tag":67,"props":1607,"children":1609},{"className":1608},[],[1610],{"type":58,"value":582},{"type":58,"value":1612}," needs a TTY:",{"type":58,"value":1614}," The scaffold script will print a manual fallback command. Have the user run ",{"type":53,"tag":67,"props":1616,"children":1618},{"className":1617},[],[1619],{"type":58,"value":582},{"type":58,"value":1621}," interactively, then continue from Step 3 — the scaffold script only needs to write ",{"type":53,"tag":67,"props":1623,"children":1625},{"className":1624},[],[1626],{"type":58,"value":387},{"type":58,"value":82},{"type":53,"tag":67,"props":1629,"children":1631},{"className":1630},[],[1632],{"type":58,"value":1633},"src\u002Findex.js",{"type":58,"value":1635}," after the directory exists.",{"type":53,"tag":678,"props":1637,"children":1639},{"id":1638},"step-3-customize-the-generated-code",[1640],{"type":58,"value":1641},"Step 3: Customize the Generated Code",{"type":53,"tag":61,"props":1643,"children":1644},{},[1645,1647,1652],{"type":58,"value":1646},"After scaffolding (or after the user runs ",{"type":53,"tag":67,"props":1648,"children":1650},{"className":1649},[],[1651],{"type":58,"value":582},{"type":58,"value":1653}," interactively):",{"type":53,"tag":714,"props":1655,"children":1657},{"className":716,"code":1656,"language":718,"meta":719,"style":719},"cd \u003Capp-name>\nnpm install\n",[1658],{"type":53,"tag":67,"props":1659,"children":1660},{"__ignoreMap":719},[1661,1686],{"type":53,"tag":725,"props":1662,"children":1663},{"class":727,"line":728},[1664,1670,1674,1678,1682],{"type":53,"tag":725,"props":1665,"children":1667},{"style":1666},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[1668],{"type":58,"value":1669},"cd",{"type":53,"tag":725,"props":1671,"children":1672},{"style":1439},[1673],{"type":58,"value":1442},{"type":53,"tag":725,"props":1675,"children":1676},{"style":738},[1677],{"type":58,"value":1447},{"type":53,"tag":725,"props":1679,"children":1680},{"style":1424},[1681],{"type":58,"value":1452},{"type":53,"tag":725,"props":1683,"children":1684},{"style":1439},[1685],{"type":58,"value":1547},{"type":53,"tag":725,"props":1687,"children":1688},{"class":727,"line":1430},[1689,1693],{"type":53,"tag":725,"props":1690,"children":1691},{"style":732},[1692],{"type":58,"value":735},{"type":53,"tag":725,"props":1694,"children":1695},{"style":738},[1696],{"type":58,"value":1697}," install\n",{"type":53,"tag":61,"props":1699,"children":1700},{},[1701,1703,1708],{"type":58,"value":1702},"The blank template generates ",{"type":53,"tag":67,"props":1704,"children":1706},{"className":1705},[],[1707],{"type":58,"value":1633},{"type":58,"value":1709}," (JavaScript, not TypeScript). Edit it to add your API calls. The scaffold generates working handler skeletons; fill in your business logic.",{"type":53,"tag":849,"props":1711,"children":1713},{"id":1712},"key-files-to-edit",[1714],{"type":58,"value":1715},"Key files to edit",{"type":53,"tag":608,"props":1717,"children":1718},{},[1719,1735],{"type":53,"tag":612,"props":1720,"children":1721},{},[1722],{"type":53,"tag":616,"props":1723,"children":1724},{},[1725,1730],{"type":53,"tag":620,"props":1726,"children":1727},{},[1728],{"type":58,"value":1729},"File",{"type":53,"tag":620,"props":1731,"children":1732},{},[1733],{"type":58,"value":1734},"What to change",{"type":53,"tag":631,"props":1736,"children":1737},{},[1738,1760,1783],{"type":53,"tag":616,"props":1739,"children":1740},{},[1741,1749],{"type":53,"tag":638,"props":1742,"children":1743},{},[1744],{"type":53,"tag":67,"props":1745,"children":1747},{"className":1746},[],[1748],{"type":58,"value":1633},{"type":53,"tag":638,"props":1750,"children":1751},{},[1752,1758],{"type":53,"tag":67,"props":1753,"children":1755},{"className":1754},[],[1756],{"type":58,"value":1757},"fetchExternalData()",{"type":58,"value":1759}," — replace with your API calls",{"type":53,"tag":616,"props":1761,"children":1762},{},[1763,1771],{"type":53,"tag":638,"props":1764,"children":1765},{},[1766],{"type":53,"tag":67,"props":1767,"children":1769},{"className":1768},[],[1770],{"type":58,"value":387},{"type":53,"tag":638,"props":1772,"children":1773},{},[1774,1775,1781],{"type":58,"value":1552},{"type":53,"tag":67,"props":1776,"children":1778},{"className":1777},[],[1779],{"type":58,"value":1780},"permissions.external.fetch.backend",{"type":58,"value":1782}," URLs for any external APIs",{"type":53,"tag":616,"props":1784,"children":1785},{},[1786,1795],{"type":53,"tag":638,"props":1787,"children":1788},{},[1789],{"type":53,"tag":67,"props":1790,"children":1792},{"className":1791},[],[1793],{"type":58,"value":1794},"package.json",{"type":53,"tag":638,"props":1796,"children":1797},{},[1798,1799,1805,1806,1811,1812,1817],{"type":58,"value":1552},{"type":53,"tag":67,"props":1800,"children":1802},{"className":1801},[],[1803],{"type":58,"value":1804},"@forge\u002Fapi",{"type":58,"value":389},{"type":53,"tag":67,"props":1807,"children":1809},{"className":1808},[],[1810],{"type":58,"value":231},{"type":58,"value":389},{"type":53,"tag":67,"props":1813,"children":1815},{"className":1814},[],[1816],{"type":58,"value":295},{"type":58,"value":1818}," as dependencies",{"type":53,"tag":849,"props":1820,"children":1822},{"id":1821},"setobjects-ingest-data-into-teamwork-graph",[1823],{"type":58,"value":1824},"setObjects — ingest data into Teamwork Graph",{"type":53,"tag":61,"props":1826,"children":1827},{},[1828,1830,1835,1837,1842],{"type":58,"value":1829},"Use the ",{"type":53,"tag":67,"props":1831,"children":1833},{"className":1832},[],[1834],{"type":58,"value":287},{"type":58,"value":1836}," named export — do NOT destructure ",{"type":53,"tag":67,"props":1838,"children":1840},{"className":1839},[],[1841],{"type":58,"value":319},{"type":58,"value":1843}," directly:",{"type":53,"tag":714,"props":1845,"children":1849},{"className":1846,"code":1847,"language":1848,"meta":719,"style":719},"language-javascript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","const { graph } = require('@forge\u002Fteamwork-graph');\n\nconst result = await graph.setObjects({\n  connectionId,          \u002F\u002F required — the connectionId from the handler request\n  objects: [\n    {\n      schemaVersion: '1.0',\n      id: 'unique-id-from-source',      \u002F\u002F unique per connectionId\n      updateSequenceNumber: 1,\n      displayName: 'My Document Title',\n      url: 'https:\u002F\u002Fsource-system.example.com\u002Fdoc\u002F123',\n      createdAt: '2024-01-15T10:00:00Z',        \u002F\u002F ISO 8601\n      lastUpdatedAt: '2024-01-20T14:30:00Z',\n      \u002F\u002F Use the permission model chosen in Step 1.5 question 6.\n      \u002F\u002F EVERYONE only if content is confirmed publicly accessible.\n      \u002F\u002F For user-restricted content: { type: 'user', id: '\u003Catlassian-account-id>' }\n      \u002F\u002F For group-restricted content: { type: 'group', id: '\u003Cgroup-id>' }\n      permissions: [{\n        accessControls: [{\n          principals: [{ type: 'EVERYONE' }],\n        }],\n      }],\n      'atlassian:document': {\n        type: {\n          category: 'DOCUMENT',   \u002F\u002F see Document Categories table below\n          mimeType: 'application\u002Fvnd.google-apps.document',\n        },\n        content: {\n          mimeType: 'application\u002Fvnd.google-apps.document',\n          text: 'document title or snippet for search indexing',\n        },\n      },\n    },\n  ],\n});\n\nif (!result.success) {\n  console.error('setObjects error:', result.error);\n}\n","javascript",[1850],{"type":53,"tag":67,"props":1851,"children":1852},{"__ignoreMap":719},[1853,1915,1924,1969,1988,2007,2016,2047,2082,2105,2135,2165,2200,2230,2238,2247,2256,2265,2287,2308,2365,2382,2399,2425,2442,2477,2507,2516,2533,2561,2591,2599,2608,2617,2630,2646,2654,2691,2751],{"type":53,"tag":725,"props":1854,"children":1855},{"class":727,"line":728},[1856,1862,1867,1872,1877,1882,1887,1892,1897,1901,1905,1910],{"type":53,"tag":725,"props":1857,"children":1859},{"style":1858},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[1860],{"type":58,"value":1861},"const",{"type":53,"tag":725,"props":1863,"children":1864},{"style":1439},[1865],{"type":58,"value":1866}," {",{"type":53,"tag":725,"props":1868,"children":1869},{"style":1424},[1870],{"type":58,"value":1871}," graph ",{"type":53,"tag":725,"props":1873,"children":1874},{"style":1439},[1875],{"type":58,"value":1876},"}",{"type":53,"tag":725,"props":1878,"children":1879},{"style":1439},[1880],{"type":58,"value":1881}," =",{"type":53,"tag":725,"props":1883,"children":1884},{"style":1666},[1885],{"type":58,"value":1886}," require",{"type":53,"tag":725,"props":1888,"children":1889},{"style":1424},[1890],{"type":58,"value":1891},"(",{"type":53,"tag":725,"props":1893,"children":1894},{"style":1439},[1895],{"type":58,"value":1896},"'",{"type":53,"tag":725,"props":1898,"children":1899},{"style":738},[1900],{"type":58,"value":295},{"type":53,"tag":725,"props":1902,"children":1903},{"style":1439},[1904],{"type":58,"value":1896},{"type":53,"tag":725,"props":1906,"children":1907},{"style":1424},[1908],{"type":58,"value":1909},")",{"type":53,"tag":725,"props":1911,"children":1912},{"style":1439},[1913],{"type":58,"value":1914},";\n",{"type":53,"tag":725,"props":1916,"children":1917},{"class":727,"line":1430},[1918],{"type":53,"tag":725,"props":1919,"children":1921},{"emptyLinePlaceholder":1920},true,[1922],{"type":58,"value":1923},"\n",{"type":53,"tag":725,"props":1925,"children":1926},{"class":727,"line":1464},[1927,1931,1936,1941,1947,1952,1956,1960,1964],{"type":53,"tag":725,"props":1928,"children":1929},{"style":1858},[1930],{"type":58,"value":1861},{"type":53,"tag":725,"props":1932,"children":1933},{"style":1424},[1934],{"type":58,"value":1935}," result ",{"type":53,"tag":725,"props":1937,"children":1938},{"style":1439},[1939],{"type":58,"value":1940},"=",{"type":53,"tag":725,"props":1942,"children":1944},{"style":1943},"--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic",[1945],{"type":58,"value":1946}," await",{"type":53,"tag":725,"props":1948,"children":1949},{"style":1424},[1950],{"type":58,"value":1951}," graph",{"type":53,"tag":725,"props":1953,"children":1954},{"style":1439},[1955],{"type":58,"value":89},{"type":53,"tag":725,"props":1957,"children":1958},{"style":1666},[1959],{"type":58,"value":319},{"type":53,"tag":725,"props":1961,"children":1962},{"style":1424},[1963],{"type":58,"value":1891},{"type":53,"tag":725,"props":1965,"children":1966},{"style":1439},[1967],{"type":58,"value":1968},"{\n",{"type":53,"tag":725,"props":1970,"children":1971},{"class":727,"line":1492},[1972,1977,1982],{"type":53,"tag":725,"props":1973,"children":1974},{"style":1424},[1975],{"type":58,"value":1976},"  connectionId",{"type":53,"tag":725,"props":1978,"children":1979},{"style":1439},[1980],{"type":58,"value":1981},",",{"type":53,"tag":725,"props":1983,"children":1985},{"style":1984},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[1986],{"type":58,"value":1987},"          \u002F\u002F required — the connectionId from the handler request\n",{"type":53,"tag":725,"props":1989,"children":1990},{"class":727,"line":1522},[1991,1997,2002],{"type":53,"tag":725,"props":1992,"children":1994},{"style":1993},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[1995],{"type":58,"value":1996},"  objects",{"type":53,"tag":725,"props":1998,"children":1999},{"style":1439},[2000],{"type":58,"value":2001},":",{"type":53,"tag":725,"props":2003,"children":2004},{"style":1424},[2005],{"type":58,"value":2006}," [\n",{"type":53,"tag":725,"props":2008,"children":2010},{"class":727,"line":2009},6,[2011],{"type":53,"tag":725,"props":2012,"children":2013},{"style":1439},[2014],{"type":58,"value":2015},"    {\n",{"type":53,"tag":725,"props":2017,"children":2018},{"class":727,"line":26},[2019,2024,2028,2033,2038,2042],{"type":53,"tag":725,"props":2020,"children":2021},{"style":1993},[2022],{"type":58,"value":2023},"      schemaVersion",{"type":53,"tag":725,"props":2025,"children":2026},{"style":1439},[2027],{"type":58,"value":2001},{"type":53,"tag":725,"props":2029,"children":2030},{"style":1439},[2031],{"type":58,"value":2032}," '",{"type":53,"tag":725,"props":2034,"children":2035},{"style":738},[2036],{"type":58,"value":2037},"1.0",{"type":53,"tag":725,"props":2039,"children":2040},{"style":1439},[2041],{"type":58,"value":1896},{"type":53,"tag":725,"props":2043,"children":2044},{"style":1439},[2045],{"type":58,"value":2046},",\n",{"type":53,"tag":725,"props":2048,"children":2050},{"class":727,"line":2049},8,[2051,2056,2060,2064,2069,2073,2077],{"type":53,"tag":725,"props":2052,"children":2053},{"style":1993},[2054],{"type":58,"value":2055},"      id",{"type":53,"tag":725,"props":2057,"children":2058},{"style":1439},[2059],{"type":58,"value":2001},{"type":53,"tag":725,"props":2061,"children":2062},{"style":1439},[2063],{"type":58,"value":2032},{"type":53,"tag":725,"props":2065,"children":2066},{"style":738},[2067],{"type":58,"value":2068},"unique-id-from-source",{"type":53,"tag":725,"props":2070,"children":2071},{"style":1439},[2072],{"type":58,"value":1896},{"type":53,"tag":725,"props":2074,"children":2075},{"style":1439},[2076],{"type":58,"value":1981},{"type":53,"tag":725,"props":2078,"children":2079},{"style":1984},[2080],{"type":58,"value":2081},"      \u002F\u002F unique per connectionId\n",{"type":53,"tag":725,"props":2083,"children":2085},{"class":727,"line":2084},9,[2086,2091,2095,2101],{"type":53,"tag":725,"props":2087,"children":2088},{"style":1993},[2089],{"type":58,"value":2090},"      updateSequenceNumber",{"type":53,"tag":725,"props":2092,"children":2093},{"style":1439},[2094],{"type":58,"value":2001},{"type":53,"tag":725,"props":2096,"children":2098},{"style":2097},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[2099],{"type":58,"value":2100}," 1",{"type":53,"tag":725,"props":2102,"children":2103},{"style":1439},[2104],{"type":58,"value":2046},{"type":53,"tag":725,"props":2106,"children":2108},{"class":727,"line":2107},10,[2109,2114,2118,2122,2127,2131],{"type":53,"tag":725,"props":2110,"children":2111},{"style":1993},[2112],{"type":58,"value":2113},"      displayName",{"type":53,"tag":725,"props":2115,"children":2116},{"style":1439},[2117],{"type":58,"value":2001},{"type":53,"tag":725,"props":2119,"children":2120},{"style":1439},[2121],{"type":58,"value":2032},{"type":53,"tag":725,"props":2123,"children":2124},{"style":738},[2125],{"type":58,"value":2126},"My Document Title",{"type":53,"tag":725,"props":2128,"children":2129},{"style":1439},[2130],{"type":58,"value":1896},{"type":53,"tag":725,"props":2132,"children":2133},{"style":1439},[2134],{"type":58,"value":2046},{"type":53,"tag":725,"props":2136,"children":2138},{"class":727,"line":2137},11,[2139,2144,2148,2152,2157,2161],{"type":53,"tag":725,"props":2140,"children":2141},{"style":1993},[2142],{"type":58,"value":2143},"      url",{"type":53,"tag":725,"props":2145,"children":2146},{"style":1439},[2147],{"type":58,"value":2001},{"type":53,"tag":725,"props":2149,"children":2150},{"style":1439},[2151],{"type":58,"value":2032},{"type":53,"tag":725,"props":2153,"children":2154},{"style":738},[2155],{"type":58,"value":2156},"https:\u002F\u002Fsource-system.example.com\u002Fdoc\u002F123",{"type":53,"tag":725,"props":2158,"children":2159},{"style":1439},[2160],{"type":58,"value":1896},{"type":53,"tag":725,"props":2162,"children":2163},{"style":1439},[2164],{"type":58,"value":2046},{"type":53,"tag":725,"props":2166,"children":2168},{"class":727,"line":2167},12,[2169,2174,2178,2182,2187,2191,2195],{"type":53,"tag":725,"props":2170,"children":2171},{"style":1993},[2172],{"type":58,"value":2173},"      createdAt",{"type":53,"tag":725,"props":2175,"children":2176},{"style":1439},[2177],{"type":58,"value":2001},{"type":53,"tag":725,"props":2179,"children":2180},{"style":1439},[2181],{"type":58,"value":2032},{"type":53,"tag":725,"props":2183,"children":2184},{"style":738},[2185],{"type":58,"value":2186},"2024-01-15T10:00:00Z",{"type":53,"tag":725,"props":2188,"children":2189},{"style":1439},[2190],{"type":58,"value":1896},{"type":53,"tag":725,"props":2192,"children":2193},{"style":1439},[2194],{"type":58,"value":1981},{"type":53,"tag":725,"props":2196,"children":2197},{"style":1984},[2198],{"type":58,"value":2199},"        \u002F\u002F ISO 8601\n",{"type":53,"tag":725,"props":2201,"children":2203},{"class":727,"line":2202},13,[2204,2209,2213,2217,2222,2226],{"type":53,"tag":725,"props":2205,"children":2206},{"style":1993},[2207],{"type":58,"value":2208},"      lastUpdatedAt",{"type":53,"tag":725,"props":2210,"children":2211},{"style":1439},[2212],{"type":58,"value":2001},{"type":53,"tag":725,"props":2214,"children":2215},{"style":1439},[2216],{"type":58,"value":2032},{"type":53,"tag":725,"props":2218,"children":2219},{"style":738},[2220],{"type":58,"value":2221},"2024-01-20T14:30:00Z",{"type":53,"tag":725,"props":2223,"children":2224},{"style":1439},[2225],{"type":58,"value":1896},{"type":53,"tag":725,"props":2227,"children":2228},{"style":1439},[2229],{"type":58,"value":2046},{"type":53,"tag":725,"props":2231,"children":2232},{"class":727,"line":22},[2233],{"type":53,"tag":725,"props":2234,"children":2235},{"style":1984},[2236],{"type":58,"value":2237},"      \u002F\u002F Use the permission model chosen in Step 1.5 question 6.\n",{"type":53,"tag":725,"props":2239,"children":2241},{"class":727,"line":2240},15,[2242],{"type":53,"tag":725,"props":2243,"children":2244},{"style":1984},[2245],{"type":58,"value":2246},"      \u002F\u002F EVERYONE only if content is confirmed publicly accessible.\n",{"type":53,"tag":725,"props":2248,"children":2250},{"class":727,"line":2249},16,[2251],{"type":53,"tag":725,"props":2252,"children":2253},{"style":1984},[2254],{"type":58,"value":2255},"      \u002F\u002F For user-restricted content: { type: 'user', id: '\u003Catlassian-account-id>' }\n",{"type":53,"tag":725,"props":2257,"children":2259},{"class":727,"line":2258},17,[2260],{"type":53,"tag":725,"props":2261,"children":2262},{"style":1984},[2263],{"type":58,"value":2264},"      \u002F\u002F For group-restricted content: { type: 'group', id: '\u003Cgroup-id>' }\n",{"type":53,"tag":725,"props":2266,"children":2268},{"class":727,"line":2267},18,[2269,2274,2278,2283],{"type":53,"tag":725,"props":2270,"children":2271},{"style":1993},[2272],{"type":58,"value":2273},"      permissions",{"type":53,"tag":725,"props":2275,"children":2276},{"style":1439},[2277],{"type":58,"value":2001},{"type":53,"tag":725,"props":2279,"children":2280},{"style":1424},[2281],{"type":58,"value":2282}," [",{"type":53,"tag":725,"props":2284,"children":2285},{"style":1439},[2286],{"type":58,"value":1968},{"type":53,"tag":725,"props":2288,"children":2290},{"class":727,"line":2289},19,[2291,2296,2300,2304],{"type":53,"tag":725,"props":2292,"children":2293},{"style":1993},[2294],{"type":58,"value":2295},"        accessControls",{"type":53,"tag":725,"props":2297,"children":2298},{"style":1439},[2299],{"type":58,"value":2001},{"type":53,"tag":725,"props":2301,"children":2302},{"style":1424},[2303],{"type":58,"value":2282},{"type":53,"tag":725,"props":2305,"children":2306},{"style":1439},[2307],{"type":58,"value":1968},{"type":53,"tag":725,"props":2309,"children":2311},{"class":727,"line":2310},20,[2312,2317,2321,2325,2330,2335,2339,2343,2347,2351,2356,2361],{"type":53,"tag":725,"props":2313,"children":2314},{"style":1993},[2315],{"type":58,"value":2316},"          principals",{"type":53,"tag":725,"props":2318,"children":2319},{"style":1439},[2320],{"type":58,"value":2001},{"type":53,"tag":725,"props":2322,"children":2323},{"style":1424},[2324],{"type":58,"value":2282},{"type":53,"tag":725,"props":2326,"children":2327},{"style":1439},[2328],{"type":58,"value":2329},"{",{"type":53,"tag":725,"props":2331,"children":2332},{"style":1993},[2333],{"type":58,"value":2334}," type",{"type":53,"tag":725,"props":2336,"children":2337},{"style":1439},[2338],{"type":58,"value":2001},{"type":53,"tag":725,"props":2340,"children":2341},{"style":1439},[2342],{"type":58,"value":2032},{"type":53,"tag":725,"props":2344,"children":2345},{"style":738},[2346],{"type":58,"value":1297},{"type":53,"tag":725,"props":2348,"children":2349},{"style":1439},[2350],{"type":58,"value":1896},{"type":53,"tag":725,"props":2352,"children":2353},{"style":1439},[2354],{"type":58,"value":2355}," }",{"type":53,"tag":725,"props":2357,"children":2358},{"style":1424},[2359],{"type":58,"value":2360},"]",{"type":53,"tag":725,"props":2362,"children":2363},{"style":1439},[2364],{"type":58,"value":2046},{"type":53,"tag":725,"props":2366,"children":2368},{"class":727,"line":2367},21,[2369,2374,2378],{"type":53,"tag":725,"props":2370,"children":2371},{"style":1439},[2372],{"type":58,"value":2373},"        }",{"type":53,"tag":725,"props":2375,"children":2376},{"style":1424},[2377],{"type":58,"value":2360},{"type":53,"tag":725,"props":2379,"children":2380},{"style":1439},[2381],{"type":58,"value":2046},{"type":53,"tag":725,"props":2383,"children":2385},{"class":727,"line":2384},22,[2386,2391,2395],{"type":53,"tag":725,"props":2387,"children":2388},{"style":1439},[2389],{"type":58,"value":2390},"      }",{"type":53,"tag":725,"props":2392,"children":2393},{"style":1424},[2394],{"type":58,"value":2360},{"type":53,"tag":725,"props":2396,"children":2397},{"style":1439},[2398],{"type":58,"value":2046},{"type":53,"tag":725,"props":2400,"children":2402},{"class":727,"line":2401},23,[2403,2408,2412,2416,2420],{"type":53,"tag":725,"props":2404,"children":2405},{"style":1439},[2406],{"type":58,"value":2407},"      '",{"type":53,"tag":725,"props":2409,"children":2410},{"style":1993},[2411],{"type":58,"value":846},{"type":53,"tag":725,"props":2413,"children":2414},{"style":1439},[2415],{"type":58,"value":1896},{"type":53,"tag":725,"props":2417,"children":2418},{"style":1439},[2419],{"type":58,"value":2001},{"type":53,"tag":725,"props":2421,"children":2422},{"style":1439},[2423],{"type":58,"value":2424}," {\n",{"type":53,"tag":725,"props":2426,"children":2428},{"class":727,"line":2427},24,[2429,2434,2438],{"type":53,"tag":725,"props":2430,"children":2431},{"style":1993},[2432],{"type":58,"value":2433},"        type",{"type":53,"tag":725,"props":2435,"children":2436},{"style":1439},[2437],{"type":58,"value":2001},{"type":53,"tag":725,"props":2439,"children":2440},{"style":1439},[2441],{"type":58,"value":2424},{"type":53,"tag":725,"props":2443,"children":2445},{"class":727,"line":2444},25,[2446,2451,2455,2459,2464,2468,2472],{"type":53,"tag":725,"props":2447,"children":2448},{"style":1993},[2449],{"type":58,"value":2450},"          category",{"type":53,"tag":725,"props":2452,"children":2453},{"style":1439},[2454],{"type":58,"value":2001},{"type":53,"tag":725,"props":2456,"children":2457},{"style":1439},[2458],{"type":58,"value":2032},{"type":53,"tag":725,"props":2460,"children":2461},{"style":738},[2462],{"type":58,"value":2463},"DOCUMENT",{"type":53,"tag":725,"props":2465,"children":2466},{"style":1439},[2467],{"type":58,"value":1896},{"type":53,"tag":725,"props":2469,"children":2470},{"style":1439},[2471],{"type":58,"value":1981},{"type":53,"tag":725,"props":2473,"children":2474},{"style":1984},[2475],{"type":58,"value":2476},"   \u002F\u002F see Document Categories table below\n",{"type":53,"tag":725,"props":2478,"children":2480},{"class":727,"line":2479},26,[2481,2486,2490,2494,2499,2503],{"type":53,"tag":725,"props":2482,"children":2483},{"style":1993},[2484],{"type":58,"value":2485},"          mimeType",{"type":53,"tag":725,"props":2487,"children":2488},{"style":1439},[2489],{"type":58,"value":2001},{"type":53,"tag":725,"props":2491,"children":2492},{"style":1439},[2493],{"type":58,"value":2032},{"type":53,"tag":725,"props":2495,"children":2496},{"style":738},[2497],{"type":58,"value":2498},"application\u002Fvnd.google-apps.document",{"type":53,"tag":725,"props":2500,"children":2501},{"style":1439},[2502],{"type":58,"value":1896},{"type":53,"tag":725,"props":2504,"children":2505},{"style":1439},[2506],{"type":58,"value":2046},{"type":53,"tag":725,"props":2508,"children":2510},{"class":727,"line":2509},27,[2511],{"type":53,"tag":725,"props":2512,"children":2513},{"style":1439},[2514],{"type":58,"value":2515},"        },\n",{"type":53,"tag":725,"props":2517,"children":2519},{"class":727,"line":2518},28,[2520,2525,2529],{"type":53,"tag":725,"props":2521,"children":2522},{"style":1993},[2523],{"type":58,"value":2524},"        content",{"type":53,"tag":725,"props":2526,"children":2527},{"style":1439},[2528],{"type":58,"value":2001},{"type":53,"tag":725,"props":2530,"children":2531},{"style":1439},[2532],{"type":58,"value":2424},{"type":53,"tag":725,"props":2534,"children":2536},{"class":727,"line":2535},29,[2537,2541,2545,2549,2553,2557],{"type":53,"tag":725,"props":2538,"children":2539},{"style":1993},[2540],{"type":58,"value":2485},{"type":53,"tag":725,"props":2542,"children":2543},{"style":1439},[2544],{"type":58,"value":2001},{"type":53,"tag":725,"props":2546,"children":2547},{"style":1439},[2548],{"type":58,"value":2032},{"type":53,"tag":725,"props":2550,"children":2551},{"style":738},[2552],{"type":58,"value":2498},{"type":53,"tag":725,"props":2554,"children":2555},{"style":1439},[2556],{"type":58,"value":1896},{"type":53,"tag":725,"props":2558,"children":2559},{"style":1439},[2560],{"type":58,"value":2046},{"type":53,"tag":725,"props":2562,"children":2564},{"class":727,"line":2563},30,[2565,2570,2574,2578,2583,2587],{"type":53,"tag":725,"props":2566,"children":2567},{"style":1993},[2568],{"type":58,"value":2569},"          text",{"type":53,"tag":725,"props":2571,"children":2572},{"style":1439},[2573],{"type":58,"value":2001},{"type":53,"tag":725,"props":2575,"children":2576},{"style":1439},[2577],{"type":58,"value":2032},{"type":53,"tag":725,"props":2579,"children":2580},{"style":738},[2581],{"type":58,"value":2582},"document title or snippet for search indexing",{"type":53,"tag":725,"props":2584,"children":2585},{"style":1439},[2586],{"type":58,"value":1896},{"type":53,"tag":725,"props":2588,"children":2589},{"style":1439},[2590],{"type":58,"value":2046},{"type":53,"tag":725,"props":2592,"children":2594},{"class":727,"line":2593},31,[2595],{"type":53,"tag":725,"props":2596,"children":2597},{"style":1439},[2598],{"type":58,"value":2515},{"type":53,"tag":725,"props":2600,"children":2602},{"class":727,"line":2601},32,[2603],{"type":53,"tag":725,"props":2604,"children":2605},{"style":1439},[2606],{"type":58,"value":2607},"      },\n",{"type":53,"tag":725,"props":2609,"children":2611},{"class":727,"line":2610},33,[2612],{"type":53,"tag":725,"props":2613,"children":2614},{"style":1439},[2615],{"type":58,"value":2616},"    },\n",{"type":53,"tag":725,"props":2618,"children":2620},{"class":727,"line":2619},34,[2621,2626],{"type":53,"tag":725,"props":2622,"children":2623},{"style":1424},[2624],{"type":58,"value":2625},"  ]",{"type":53,"tag":725,"props":2627,"children":2628},{"style":1439},[2629],{"type":58,"value":2046},{"type":53,"tag":725,"props":2631,"children":2633},{"class":727,"line":2632},35,[2634,2638,2642],{"type":53,"tag":725,"props":2635,"children":2636},{"style":1439},[2637],{"type":58,"value":1876},{"type":53,"tag":725,"props":2639,"children":2640},{"style":1424},[2641],{"type":58,"value":1909},{"type":53,"tag":725,"props":2643,"children":2644},{"style":1439},[2645],{"type":58,"value":1914},{"type":53,"tag":725,"props":2647,"children":2649},{"class":727,"line":2648},36,[2650],{"type":53,"tag":725,"props":2651,"children":2652},{"emptyLinePlaceholder":1920},[2653],{"type":58,"value":1923},{"type":53,"tag":725,"props":2655,"children":2657},{"class":727,"line":2656},37,[2658,2663,2668,2673,2678,2682,2687],{"type":53,"tag":725,"props":2659,"children":2660},{"style":1943},[2661],{"type":58,"value":2662},"if",{"type":53,"tag":725,"props":2664,"children":2665},{"style":1424},[2666],{"type":58,"value":2667}," (",{"type":53,"tag":725,"props":2669,"children":2670},{"style":1439},[2671],{"type":58,"value":2672},"!",{"type":53,"tag":725,"props":2674,"children":2675},{"style":1424},[2676],{"type":58,"value":2677},"result",{"type":53,"tag":725,"props":2679,"children":2680},{"style":1439},[2681],{"type":58,"value":89},{"type":53,"tag":725,"props":2683,"children":2684},{"style":1424},[2685],{"type":58,"value":2686},"success) ",{"type":53,"tag":725,"props":2688,"children":2689},{"style":1439},[2690],{"type":58,"value":1968},{"type":53,"tag":725,"props":2692,"children":2694},{"class":727,"line":2693},38,[2695,2700,2704,2709,2713,2717,2722,2726,2730,2735,2739,2743,2747],{"type":53,"tag":725,"props":2696,"children":2697},{"style":1424},[2698],{"type":58,"value":2699},"  console",{"type":53,"tag":725,"props":2701,"children":2702},{"style":1439},[2703],{"type":58,"value":89},{"type":53,"tag":725,"props":2705,"children":2706},{"style":1666},[2707],{"type":58,"value":2708},"error",{"type":53,"tag":725,"props":2710,"children":2711},{"style":1993},[2712],{"type":58,"value":1891},{"type":53,"tag":725,"props":2714,"children":2715},{"style":1439},[2716],{"type":58,"value":1896},{"type":53,"tag":725,"props":2718,"children":2719},{"style":738},[2720],{"type":58,"value":2721},"setObjects error:",{"type":53,"tag":725,"props":2723,"children":2724},{"style":1439},[2725],{"type":58,"value":1896},{"type":53,"tag":725,"props":2727,"children":2728},{"style":1439},[2729],{"type":58,"value":1981},{"type":53,"tag":725,"props":2731,"children":2732},{"style":1424},[2733],{"type":58,"value":2734}," result",{"type":53,"tag":725,"props":2736,"children":2737},{"style":1439},[2738],{"type":58,"value":89},{"type":53,"tag":725,"props":2740,"children":2741},{"style":1424},[2742],{"type":58,"value":2708},{"type":53,"tag":725,"props":2744,"children":2745},{"style":1993},[2746],{"type":58,"value":1909},{"type":53,"tag":725,"props":2748,"children":2749},{"style":1439},[2750],{"type":58,"value":1914},{"type":53,"tag":725,"props":2752,"children":2754},{"class":727,"line":2753},39,[2755],{"type":53,"tag":725,"props":2756,"children":2757},{"style":1439},[2758],{"type":58,"value":2759},"}\n",{"type":53,"tag":879,"props":2761,"children":2762},{},[2763,2775,2792],{"type":53,"tag":102,"props":2764,"children":2765},{},[2766,2768,2773],{"type":58,"value":2767},"Max ",{"type":53,"tag":76,"props":2769,"children":2770},{},[2771],{"type":58,"value":2772},"100 objects per call",{"type":58,"value":2774}," — batch large datasets with a loop",{"type":53,"tag":102,"props":2776,"children":2777},{},[2778,2784,2786],{"type":53,"tag":67,"props":2779,"children":2781},{"className":2780},[],[2782],{"type":58,"value":2783},"id",{"type":58,"value":2785}," must be unique per ",{"type":53,"tag":67,"props":2787,"children":2789},{"className":2788},[],[2790],{"type":58,"value":2791},"connectionId",{"type":53,"tag":102,"props":2793,"children":2794},{},[2795,2800,2802,2808],{"type":53,"tag":67,"props":2796,"children":2798},{"className":2797},[],[2799],{"type":58,"value":2791},{"type":58,"value":2801}," is required in every ",{"type":53,"tag":67,"props":2803,"children":2805},{"className":2804},[],[2806],{"type":58,"value":2807},"graph.setObjects()",{"type":58,"value":2809}," call",{"type":53,"tag":849,"props":2811,"children":2813},{"id":2812},"document-categories-for-atlassiandocumenttypecategory",[2814,2816,2822],{"type":58,"value":2815},"Document Categories (for ",{"type":53,"tag":67,"props":2817,"children":2819},{"className":2818},[],[2820],{"type":58,"value":2821},"atlassian:document.type.category",{"type":58,"value":1909},{"type":53,"tag":608,"props":2824,"children":2825},{},[2826,2842],{"type":53,"tag":612,"props":2827,"children":2828},{},[2829],{"type":53,"tag":616,"props":2830,"children":2831},{},[2832,2837],{"type":53,"tag":620,"props":2833,"children":2834},{},[2835],{"type":58,"value":2836},"MIME type",{"type":53,"tag":620,"props":2838,"children":2839},{},[2840],{"type":58,"value":2841},"Category",{"type":53,"tag":631,"props":2843,"children":2844},{},[2845,2864,2885,2906,2927,2948,2969,2990,3011],{"type":53,"tag":616,"props":2846,"children":2847},{},[2848,2856],{"type":53,"tag":638,"props":2849,"children":2850},{},[2851],{"type":53,"tag":67,"props":2852,"children":2854},{"className":2853},[],[2855],{"type":58,"value":2498},{"type":53,"tag":638,"props":2857,"children":2858},{},[2859],{"type":53,"tag":67,"props":2860,"children":2862},{"className":2861},[],[2863],{"type":58,"value":2463},{"type":53,"tag":616,"props":2865,"children":2866},{},[2867,2876],{"type":53,"tag":638,"props":2868,"children":2869},{},[2870],{"type":53,"tag":67,"props":2871,"children":2873},{"className":2872},[],[2874],{"type":58,"value":2875},"application\u002Fvnd.google-apps.spreadsheet",{"type":53,"tag":638,"props":2877,"children":2878},{},[2879],{"type":53,"tag":67,"props":2880,"children":2882},{"className":2881},[],[2883],{"type":58,"value":2884},"SPREADSHEET",{"type":53,"tag":616,"props":2886,"children":2887},{},[2888,2897],{"type":53,"tag":638,"props":2889,"children":2890},{},[2891],{"type":53,"tag":67,"props":2892,"children":2894},{"className":2893},[],[2895],{"type":58,"value":2896},"application\u002Fvnd.google-apps.presentation",{"type":53,"tag":638,"props":2898,"children":2899},{},[2900],{"type":53,"tag":67,"props":2901,"children":2903},{"className":2902},[],[2904],{"type":58,"value":2905},"PRESENTATION",{"type":53,"tag":616,"props":2907,"children":2908},{},[2909,2918],{"type":53,"tag":638,"props":2910,"children":2911},{},[2912],{"type":53,"tag":67,"props":2913,"children":2915},{"className":2914},[],[2916],{"type":58,"value":2917},"application\u002Fvnd.google-apps.folder",{"type":53,"tag":638,"props":2919,"children":2920},{},[2921],{"type":53,"tag":67,"props":2922,"children":2924},{"className":2923},[],[2925],{"type":58,"value":2926},"FOLDER",{"type":53,"tag":616,"props":2928,"children":2929},{},[2930,2939],{"type":53,"tag":638,"props":2931,"children":2932},{},[2933],{"type":53,"tag":67,"props":2934,"children":2936},{"className":2935},[],[2937],{"type":58,"value":2938},"application\u002Fpdf",{"type":53,"tag":638,"props":2940,"children":2941},{},[2942],{"type":53,"tag":67,"props":2943,"children":2945},{"className":2944},[],[2946],{"type":58,"value":2947},"PDF",{"type":53,"tag":616,"props":2949,"children":2950},{},[2951,2960],{"type":53,"tag":638,"props":2952,"children":2953},{},[2954],{"type":53,"tag":67,"props":2955,"children":2957},{"className":2956},[],[2958],{"type":58,"value":2959},"image\u002F*",{"type":53,"tag":638,"props":2961,"children":2962},{},[2963],{"type":53,"tag":67,"props":2964,"children":2966},{"className":2965},[],[2967],{"type":58,"value":2968},"IMAGE",{"type":53,"tag":616,"props":2970,"children":2971},{},[2972,2981],{"type":53,"tag":638,"props":2973,"children":2974},{},[2975],{"type":53,"tag":67,"props":2976,"children":2978},{"className":2977},[],[2979],{"type":58,"value":2980},"video\u002F*",{"type":53,"tag":638,"props":2982,"children":2983},{},[2984],{"type":53,"tag":67,"props":2985,"children":2987},{"className":2986},[],[2988],{"type":58,"value":2989},"VIDEO",{"type":53,"tag":616,"props":2991,"children":2992},{},[2993,3002],{"type":53,"tag":638,"props":2994,"children":2995},{},[2996],{"type":53,"tag":67,"props":2997,"children":2999},{"className":2998},[],[3000],{"type":58,"value":3001},"audio\u002F*",{"type":53,"tag":638,"props":3003,"children":3004},{},[3005],{"type":53,"tag":67,"props":3006,"children":3008},{"className":3007},[],[3009],{"type":58,"value":3010},"AUDIO",{"type":53,"tag":616,"props":3012,"children":3013},{},[3014,3019],{"type":53,"tag":638,"props":3015,"children":3016},{},[3017],{"type":58,"value":3018},"Other",{"type":53,"tag":638,"props":3020,"children":3021},{},[3022],{"type":53,"tag":67,"props":3023,"children":3025},{"className":3024},[],[3026],{"type":58,"value":3027},"OTHER",{"type":53,"tag":849,"props":3029,"children":3031},{"id":3030},"getobjectbyexternalid-look-up-a-single-object",[3032],{"type":58,"value":3033},"getObjectByExternalId — look up a single object",{"type":53,"tag":714,"props":3035,"children":3037},{"className":1846,"code":3036,"language":1848,"meta":719,"style":719},"const { graph } = require('@forge\u002Fteamwork-graph');\n\nconst data = await graph.getObjectByExternalId({\n  externalId: 'unique-id-from-source',\n  objectType: 'atlassian:document',\n  connectionId,\n});\nif (data.success) console.log(data.object);\n",[3038],{"type":53,"tag":67,"props":3039,"children":3040},{"__ignoreMap":719},[3041,3092,3099,3140,3168,3196,3207,3222],{"type":53,"tag":725,"props":3042,"children":3043},{"class":727,"line":728},[3044,3048,3052,3056,3060,3064,3068,3072,3076,3080,3084,3088],{"type":53,"tag":725,"props":3045,"children":3046},{"style":1858},[3047],{"type":58,"value":1861},{"type":53,"tag":725,"props":3049,"children":3050},{"style":1439},[3051],{"type":58,"value":1866},{"type":53,"tag":725,"props":3053,"children":3054},{"style":1424},[3055],{"type":58,"value":1871},{"type":53,"tag":725,"props":3057,"children":3058},{"style":1439},[3059],{"type":58,"value":1876},{"type":53,"tag":725,"props":3061,"children":3062},{"style":1439},[3063],{"type":58,"value":1881},{"type":53,"tag":725,"props":3065,"children":3066},{"style":1666},[3067],{"type":58,"value":1886},{"type":53,"tag":725,"props":3069,"children":3070},{"style":1424},[3071],{"type":58,"value":1891},{"type":53,"tag":725,"props":3073,"children":3074},{"style":1439},[3075],{"type":58,"value":1896},{"type":53,"tag":725,"props":3077,"children":3078},{"style":738},[3079],{"type":58,"value":295},{"type":53,"tag":725,"props":3081,"children":3082},{"style":1439},[3083],{"type":58,"value":1896},{"type":53,"tag":725,"props":3085,"children":3086},{"style":1424},[3087],{"type":58,"value":1909},{"type":53,"tag":725,"props":3089,"children":3090},{"style":1439},[3091],{"type":58,"value":1914},{"type":53,"tag":725,"props":3093,"children":3094},{"class":727,"line":1430},[3095],{"type":53,"tag":725,"props":3096,"children":3097},{"emptyLinePlaceholder":1920},[3098],{"type":58,"value":1923},{"type":53,"tag":725,"props":3100,"children":3101},{"class":727,"line":1464},[3102,3106,3111,3115,3119,3123,3127,3132,3136],{"type":53,"tag":725,"props":3103,"children":3104},{"style":1858},[3105],{"type":58,"value":1861},{"type":53,"tag":725,"props":3107,"children":3108},{"style":1424},[3109],{"type":58,"value":3110}," data ",{"type":53,"tag":725,"props":3112,"children":3113},{"style":1439},[3114],{"type":58,"value":1940},{"type":53,"tag":725,"props":3116,"children":3117},{"style":1943},[3118],{"type":58,"value":1946},{"type":53,"tag":725,"props":3120,"children":3121},{"style":1424},[3122],{"type":58,"value":1951},{"type":53,"tag":725,"props":3124,"children":3125},{"style":1439},[3126],{"type":58,"value":89},{"type":53,"tag":725,"props":3128,"children":3129},{"style":1666},[3130],{"type":58,"value":3131},"getObjectByExternalId",{"type":53,"tag":725,"props":3133,"children":3134},{"style":1424},[3135],{"type":58,"value":1891},{"type":53,"tag":725,"props":3137,"children":3138},{"style":1439},[3139],{"type":58,"value":1968},{"type":53,"tag":725,"props":3141,"children":3142},{"class":727,"line":1492},[3143,3148,3152,3156,3160,3164],{"type":53,"tag":725,"props":3144,"children":3145},{"style":1993},[3146],{"type":58,"value":3147},"  externalId",{"type":53,"tag":725,"props":3149,"children":3150},{"style":1439},[3151],{"type":58,"value":2001},{"type":53,"tag":725,"props":3153,"children":3154},{"style":1439},[3155],{"type":58,"value":2032},{"type":53,"tag":725,"props":3157,"children":3158},{"style":738},[3159],{"type":58,"value":2068},{"type":53,"tag":725,"props":3161,"children":3162},{"style":1439},[3163],{"type":58,"value":1896},{"type":53,"tag":725,"props":3165,"children":3166},{"style":1439},[3167],{"type":58,"value":2046},{"type":53,"tag":725,"props":3169,"children":3170},{"class":727,"line":1522},[3171,3176,3180,3184,3188,3192],{"type":53,"tag":725,"props":3172,"children":3173},{"style":1993},[3174],{"type":58,"value":3175},"  objectType",{"type":53,"tag":725,"props":3177,"children":3178},{"style":1439},[3179],{"type":58,"value":2001},{"type":53,"tag":725,"props":3181,"children":3182},{"style":1439},[3183],{"type":58,"value":2032},{"type":53,"tag":725,"props":3185,"children":3186},{"style":738},[3187],{"type":58,"value":846},{"type":53,"tag":725,"props":3189,"children":3190},{"style":1439},[3191],{"type":58,"value":1896},{"type":53,"tag":725,"props":3193,"children":3194},{"style":1439},[3195],{"type":58,"value":2046},{"type":53,"tag":725,"props":3197,"children":3198},{"class":727,"line":2009},[3199,3203],{"type":53,"tag":725,"props":3200,"children":3201},{"style":1424},[3202],{"type":58,"value":1976},{"type":53,"tag":725,"props":3204,"children":3205},{"style":1439},[3206],{"type":58,"value":2046},{"type":53,"tag":725,"props":3208,"children":3209},{"class":727,"line":26},[3210,3214,3218],{"type":53,"tag":725,"props":3211,"children":3212},{"style":1439},[3213],{"type":58,"value":1876},{"type":53,"tag":725,"props":3215,"children":3216},{"style":1424},[3217],{"type":58,"value":1909},{"type":53,"tag":725,"props":3219,"children":3220},{"style":1439},[3221],{"type":58,"value":1914},{"type":53,"tag":725,"props":3223,"children":3224},{"class":727,"line":2049},[3225,3229,3234,3238,3243,3247,3252,3257,3261,3266],{"type":53,"tag":725,"props":3226,"children":3227},{"style":1943},[3228],{"type":58,"value":2662},{"type":53,"tag":725,"props":3230,"children":3231},{"style":1424},[3232],{"type":58,"value":3233}," (data",{"type":53,"tag":725,"props":3235,"children":3236},{"style":1439},[3237],{"type":58,"value":89},{"type":53,"tag":725,"props":3239,"children":3240},{"style":1424},[3241],{"type":58,"value":3242},"success) console",{"type":53,"tag":725,"props":3244,"children":3245},{"style":1439},[3246],{"type":58,"value":89},{"type":53,"tag":725,"props":3248,"children":3249},{"style":1666},[3250],{"type":58,"value":3251},"log",{"type":53,"tag":725,"props":3253,"children":3254},{"style":1424},[3255],{"type":58,"value":3256},"(data",{"type":53,"tag":725,"props":3258,"children":3259},{"style":1439},[3260],{"type":58,"value":89},{"type":53,"tag":725,"props":3262,"children":3263},{"style":1424},[3264],{"type":58,"value":3265},"object)",{"type":53,"tag":725,"props":3267,"children":3268},{"style":1439},[3269],{"type":58,"value":1914},{"type":53,"tag":678,"props":3271,"children":3273},{"id":3272},"step-4-deploy-and-install",[3274],{"type":58,"value":3275},"Step 4: Deploy and Install",{"type":53,"tag":61,"props":3277,"children":3278},{},[3279,3284,3286,3291],{"type":53,"tag":76,"props":3280,"children":3281},{},[3282],{"type":58,"value":3283},"You MUST run the deploy script",{"type":58,"value":3285}," — do not only give the user manual ",{"type":53,"tag":67,"props":3287,"children":3289},{"className":3288},[],[3290],{"type":58,"value":569},{"type":58,"value":3292}," commands.",{"type":53,"tag":61,"props":3294,"children":3295},{},[3296,3298,3303,3305,3311,3313,3319,3321,3327],{"type":58,"value":3297},"The deploy script lives in the ",{"type":53,"tag":76,"props":3299,"children":3300},{},[3301],{"type":58,"value":3302},"forge-app-builder",{"type":58,"value":3304}," skill, not in this skill. Derive its directory from the path of this SKILL.md: go up two levels (",{"type":53,"tag":67,"props":3306,"children":3308},{"className":3307},[],[3309],{"type":58,"value":3310},"skills\u002Fforge-connector\u002F",{"type":58,"value":3312}," → ",{"type":53,"tag":67,"props":3314,"children":3316},{"className":3315},[],[3317],{"type":58,"value":3318},"skills\u002F",{"type":58,"value":3320},") then into ",{"type":53,"tag":67,"props":3322,"children":3324},{"className":3323},[],[3325],{"type":58,"value":3326},"forge-app-builder\u002F",{"type":58,"value":3328},". Run all commands below from that directory.",{"type":53,"tag":714,"props":3330,"children":3332},{"className":716,"code":3331,"language":718,"meta":719,"style":719},"# Derive forge-app-builder skill dir from this SKILL.md's path:\n# e.g. if this file is at \u002Fpath\u002Fto\u002Fskills\u002Fforge-connector\u002FSKILL.md\n# then the deploy script dir is: \u002Fpath\u002Fto\u002Fskills\u002Fforge-app-builder\u002F\n\n# If you have the site URL:\npython3 -m scripts.deploy_forge_app \\\n  --app-dir \u003Capp-directory> \\\n  --site \u003Csite-url> \\\n  --product jira\n\n# If you don't have the site URL yet, deploy first then ask:\npython3 -m scripts.deploy_forge_app \\\n  --app-dir \u003Capp-directory> \\\n  --product jira \\\n  --deploy-only\n# Ask: \"What is your Atlassian site URL (e.g. yourcompany.atlassian.net)?\"\npython3 -m scripts.deploy_forge_app \\\n  --app-dir \u003Capp-directory> \\\n  --site \u003Csite-url> \\\n  --product jira \\\n  --skip-deps\n",[3333],{"type":53,"tag":67,"props":3334,"children":3335},{"__ignoreMap":719},[3336,3344,3352,3360,3367,3375,3395,3424,3454,3467,3474,3482,3501,3528,3544,3552,3560,3579,3606,3633,3648],{"type":53,"tag":725,"props":3337,"children":3338},{"class":727,"line":728},[3339],{"type":53,"tag":725,"props":3340,"children":3341},{"style":1984},[3342],{"type":58,"value":3343},"# Derive forge-app-builder skill dir from this SKILL.md's path:\n",{"type":53,"tag":725,"props":3345,"children":3346},{"class":727,"line":1430},[3347],{"type":53,"tag":725,"props":3348,"children":3349},{"style":1984},[3350],{"type":58,"value":3351},"# e.g. if this file is at \u002Fpath\u002Fto\u002Fskills\u002Fforge-connector\u002FSKILL.md\n",{"type":53,"tag":725,"props":3353,"children":3354},{"class":727,"line":1464},[3355],{"type":53,"tag":725,"props":3356,"children":3357},{"style":1984},[3358],{"type":58,"value":3359},"# then the deploy script dir is: \u002Fpath\u002Fto\u002Fskills\u002Fforge-app-builder\u002F\n",{"type":53,"tag":725,"props":3361,"children":3362},{"class":727,"line":1492},[3363],{"type":53,"tag":725,"props":3364,"children":3365},{"emptyLinePlaceholder":1920},[3366],{"type":58,"value":1923},{"type":53,"tag":725,"props":3368,"children":3369},{"class":727,"line":1522},[3370],{"type":53,"tag":725,"props":3371,"children":3372},{"style":1984},[3373],{"type":58,"value":3374},"# If you have the site URL:\n",{"type":53,"tag":725,"props":3376,"children":3377},{"class":727,"line":2009},[3378,3382,3386,3391],{"type":53,"tag":725,"props":3379,"children":3380},{"style":732},[3381],{"type":58,"value":1411},{"type":53,"tag":725,"props":3383,"children":3384},{"style":738},[3385],{"type":58,"value":1416},{"type":53,"tag":725,"props":3387,"children":3388},{"style":738},[3389],{"type":58,"value":3390}," scripts.deploy_forge_app",{"type":53,"tag":725,"props":3392,"children":3393},{"style":1424},[3394],{"type":58,"value":1427},{"type":53,"tag":725,"props":3396,"children":3397},{"class":727,"line":26},[3398,3403,3407,3412,3416,3420],{"type":53,"tag":725,"props":3399,"children":3400},{"style":738},[3401],{"type":58,"value":3402},"  --app-dir",{"type":53,"tag":725,"props":3404,"children":3405},{"style":1439},[3406],{"type":58,"value":1442},{"type":53,"tag":725,"props":3408,"children":3409},{"style":738},[3410],{"type":58,"value":3411},"app-director",{"type":53,"tag":725,"props":3413,"children":3414},{"style":1424},[3415],{"type":58,"value":1542},{"type":53,"tag":725,"props":3417,"children":3418},{"style":1439},[3419],{"type":58,"value":1457},{"type":53,"tag":725,"props":3421,"children":3422},{"style":1424},[3423],{"type":58,"value":1427},{"type":53,"tag":725,"props":3425,"children":3426},{"class":727,"line":2049},[3427,3432,3436,3441,3446,3450],{"type":53,"tag":725,"props":3428,"children":3429},{"style":738},[3430],{"type":58,"value":3431},"  --site",{"type":53,"tag":725,"props":3433,"children":3434},{"style":1439},[3435],{"type":58,"value":1442},{"type":53,"tag":725,"props":3437,"children":3438},{"style":738},[3439],{"type":58,"value":3440},"site-ur",{"type":53,"tag":725,"props":3442,"children":3443},{"style":1424},[3444],{"type":58,"value":3445},"l",{"type":53,"tag":725,"props":3447,"children":3448},{"style":1439},[3449],{"type":58,"value":1457},{"type":53,"tag":725,"props":3451,"children":3452},{"style":1424},[3453],{"type":58,"value":1427},{"type":53,"tag":725,"props":3455,"children":3456},{"class":727,"line":2084},[3457,3462],{"type":53,"tag":725,"props":3458,"children":3459},{"style":738},[3460],{"type":58,"value":3461},"  --product",{"type":53,"tag":725,"props":3463,"children":3464},{"style":738},[3465],{"type":58,"value":3466}," jira\n",{"type":53,"tag":725,"props":3468,"children":3469},{"class":727,"line":2107},[3470],{"type":53,"tag":725,"props":3471,"children":3472},{"emptyLinePlaceholder":1920},[3473],{"type":58,"value":1923},{"type":53,"tag":725,"props":3475,"children":3476},{"class":727,"line":2137},[3477],{"type":53,"tag":725,"props":3478,"children":3479},{"style":1984},[3480],{"type":58,"value":3481},"# If you don't have the site URL yet, deploy first then ask:\n",{"type":53,"tag":725,"props":3483,"children":3484},{"class":727,"line":2167},[3485,3489,3493,3497],{"type":53,"tag":725,"props":3486,"children":3487},{"style":732},[3488],{"type":58,"value":1411},{"type":53,"tag":725,"props":3490,"children":3491},{"style":738},[3492],{"type":58,"value":1416},{"type":53,"tag":725,"props":3494,"children":3495},{"style":738},[3496],{"type":58,"value":3390},{"type":53,"tag":725,"props":3498,"children":3499},{"style":1424},[3500],{"type":58,"value":1427},{"type":53,"tag":725,"props":3502,"children":3503},{"class":727,"line":2202},[3504,3508,3512,3516,3520,3524],{"type":53,"tag":725,"props":3505,"children":3506},{"style":738},[3507],{"type":58,"value":3402},{"type":53,"tag":725,"props":3509,"children":3510},{"style":1439},[3511],{"type":58,"value":1442},{"type":53,"tag":725,"props":3513,"children":3514},{"style":738},[3515],{"type":58,"value":3411},{"type":53,"tag":725,"props":3517,"children":3518},{"style":1424},[3519],{"type":58,"value":1542},{"type":53,"tag":725,"props":3521,"children":3522},{"style":1439},[3523],{"type":58,"value":1457},{"type":53,"tag":725,"props":3525,"children":3526},{"style":1424},[3527],{"type":58,"value":1427},{"type":53,"tag":725,"props":3529,"children":3530},{"class":727,"line":22},[3531,3535,3540],{"type":53,"tag":725,"props":3532,"children":3533},{"style":738},[3534],{"type":58,"value":3461},{"type":53,"tag":725,"props":3536,"children":3537},{"style":738},[3538],{"type":58,"value":3539}," jira",{"type":53,"tag":725,"props":3541,"children":3542},{"style":1424},[3543],{"type":58,"value":1427},{"type":53,"tag":725,"props":3545,"children":3546},{"class":727,"line":2240},[3547],{"type":53,"tag":725,"props":3548,"children":3549},{"style":738},[3550],{"type":58,"value":3551},"  --deploy-only\n",{"type":53,"tag":725,"props":3553,"children":3554},{"class":727,"line":2249},[3555],{"type":53,"tag":725,"props":3556,"children":3557},{"style":1984},[3558],{"type":58,"value":3559},"# Ask: \"What is your Atlassian site URL (e.g. yourcompany.atlassian.net)?\"\n",{"type":53,"tag":725,"props":3561,"children":3562},{"class":727,"line":2258},[3563,3567,3571,3575],{"type":53,"tag":725,"props":3564,"children":3565},{"style":732},[3566],{"type":58,"value":1411},{"type":53,"tag":725,"props":3568,"children":3569},{"style":738},[3570],{"type":58,"value":1416},{"type":53,"tag":725,"props":3572,"children":3573},{"style":738},[3574],{"type":58,"value":3390},{"type":53,"tag":725,"props":3576,"children":3577},{"style":1424},[3578],{"type":58,"value":1427},{"type":53,"tag":725,"props":3580,"children":3581},{"class":727,"line":2267},[3582,3586,3590,3594,3598,3602],{"type":53,"tag":725,"props":3583,"children":3584},{"style":738},[3585],{"type":58,"value":3402},{"type":53,"tag":725,"props":3587,"children":3588},{"style":1439},[3589],{"type":58,"value":1442},{"type":53,"tag":725,"props":3591,"children":3592},{"style":738},[3593],{"type":58,"value":3411},{"type":53,"tag":725,"props":3595,"children":3596},{"style":1424},[3597],{"type":58,"value":1542},{"type":53,"tag":725,"props":3599,"children":3600},{"style":1439},[3601],{"type":58,"value":1457},{"type":53,"tag":725,"props":3603,"children":3604},{"style":1424},[3605],{"type":58,"value":1427},{"type":53,"tag":725,"props":3607,"children":3608},{"class":727,"line":2289},[3609,3613,3617,3621,3625,3629],{"type":53,"tag":725,"props":3610,"children":3611},{"style":738},[3612],{"type":58,"value":3431},{"type":53,"tag":725,"props":3614,"children":3615},{"style":1439},[3616],{"type":58,"value":1442},{"type":53,"tag":725,"props":3618,"children":3619},{"style":738},[3620],{"type":58,"value":3440},{"type":53,"tag":725,"props":3622,"children":3623},{"style":1424},[3624],{"type":58,"value":3445},{"type":53,"tag":725,"props":3626,"children":3627},{"style":1439},[3628],{"type":58,"value":1457},{"type":53,"tag":725,"props":3630,"children":3631},{"style":1424},[3632],{"type":58,"value":1427},{"type":53,"tag":725,"props":3634,"children":3635},{"class":727,"line":2310},[3636,3640,3644],{"type":53,"tag":725,"props":3637,"children":3638},{"style":738},[3639],{"type":58,"value":3461},{"type":53,"tag":725,"props":3641,"children":3642},{"style":738},[3643],{"type":58,"value":3539},{"type":53,"tag":725,"props":3645,"children":3646},{"style":1424},[3647],{"type":58,"value":1427},{"type":53,"tag":725,"props":3649,"children":3650},{"class":727,"line":2367},[3651],{"type":53,"tag":725,"props":3652,"children":3653},{"style":738},[3654],{"type":58,"value":3655},"  --skip-deps\n",{"type":53,"tag":678,"props":3657,"children":3659},{"id":3658},"step-5-connect-via-atlassian-administration",[3660],{"type":58,"value":3661},"Step 5: Connect via Atlassian Administration",{"type":53,"tag":61,"props":3663,"children":3664},{},[3665],{"type":58,"value":3666},"After deployment, tell the user to:",{"type":53,"tag":98,"props":3668,"children":3669},{},[3670,3701,3719,3731,3743],{"type":53,"tag":102,"props":3671,"children":3672},{},[3673,3675,3680,3681,3686,3687,3695,3696],{"type":58,"value":3674},"Go to ",{"type":53,"tag":76,"props":3676,"children":3677},{},[3678],{"type":58,"value":3679},"Atlassian Administration",{"type":58,"value":3312},{"type":53,"tag":76,"props":3682,"children":3683},{},[3684],{"type":58,"value":3685},"Apps",{"type":58,"value":3312},{"type":53,"tag":76,"props":3688,"children":3689},{},[3690],{"type":53,"tag":725,"props":3691,"children":3692},{},[3693],{"type":58,"value":3694},"site",{"type":58,"value":3312},{"type":53,"tag":76,"props":3697,"children":3698},{},[3699],{"type":58,"value":3700},"Connected apps",{"type":53,"tag":102,"props":3702,"children":3703},{},[3704,3706,3711,3712,3717],{"type":58,"value":3705},"Find the app → ",{"type":53,"tag":76,"props":3707,"children":3708},{},[3709],{"type":58,"value":3710},"View app details",{"type":58,"value":3312},{"type":53,"tag":76,"props":3713,"children":3714},{},[3715],{"type":58,"value":3716},"Connections",{"type":58,"value":3718}," tab",{"type":53,"tag":102,"props":3720,"children":3721},{},[3722,3724,3729],{"type":58,"value":3723},"Click ",{"type":53,"tag":76,"props":3725,"children":3726},{},[3727],{"type":58,"value":3728},"Connect",{"type":58,"value":3730}," under the connector",{"type":53,"tag":102,"props":3732,"children":3733},{},[3734,3736,3741],{"type":58,"value":3735},"Fill in any configuration fields (if ",{"type":53,"tag":67,"props":3737,"children":3739},{"className":3738},[],[3740],{"type":58,"value":417},{"type":58,"value":3742}," was defined)",{"type":53,"tag":102,"props":3744,"children":3745},{},[3746,3747,3751,3753,3759,3760,3766],{"type":58,"value":3723},{"type":53,"tag":76,"props":3748,"children":3749},{},[3750],{"type":58,"value":3728},{"type":58,"value":3752}," — this triggers ",{"type":53,"tag":67,"props":3754,"children":3756},{"className":3755},[],[3757],{"type":58,"value":3758},"onConnectionChange",{"type":58,"value":1099},{"type":53,"tag":67,"props":3761,"children":3763},{"className":3762},[],[3764],{"type":58,"value":3765},"action: CREATED",{"type":58,"value":3767}," and starts data ingestion",{"type":53,"tag":678,"props":3769,"children":3771},{"id":3770},"step-6-monitor-with-forge-tunnel",[3772],{"type":58,"value":3773},"Step 6: Monitor with forge tunnel",{"type":53,"tag":61,"props":3775,"children":3776},{},[3777,3778,3783,3785,3791,3792,3797,3799,3804,3806,3811],{"type":58,"value":225},{"type":53,"tag":67,"props":3779,"children":3781},{"className":3780},[],[3782],{"type":58,"value":598},{"type":58,"value":3784}," during development to stream live logs directly to your terminal as the connector functions execute. This is the fastest way to catch errors in ",{"type":53,"tag":67,"props":3786,"children":3788},{"className":3787},[],[3789],{"type":58,"value":3790},"onConnectionChangeHandler",{"type":58,"value":389},{"type":53,"tag":67,"props":3793,"children":3795},{"className":3794},[],[3796],{"type":58,"value":333},{"type":58,"value":3798},", and ",{"type":53,"tag":67,"props":3800,"children":3802},{"className":3801},[],[3803],{"type":58,"value":319},{"type":58,"value":3805}," calls without waiting for ",{"type":53,"tag":67,"props":3807,"children":3809},{"className":3808},[],[3810],{"type":58,"value":562},{"type":58,"value":89},{"type":53,"tag":61,"props":3813,"children":3814},{},[3815],{"type":58,"value":3816},"Tell the user to run this in their own terminal (it requires an interactive session):",{"type":53,"tag":714,"props":3818,"children":3820},{"className":716,"code":3819,"language":718,"meta":719,"style":719},"cd \u003Capp-directory>\nforge tunnel\n",[3821],{"type":53,"tag":67,"props":3822,"children":3823},{"__ignoreMap":719},[3824,3847],{"type":53,"tag":725,"props":3825,"children":3826},{"class":727,"line":728},[3827,3831,3835,3839,3843],{"type":53,"tag":725,"props":3828,"children":3829},{"style":1666},[3830],{"type":58,"value":1669},{"type":53,"tag":725,"props":3832,"children":3833},{"style":1439},[3834],{"type":58,"value":1442},{"type":53,"tag":725,"props":3836,"children":3837},{"style":738},[3838],{"type":58,"value":3411},{"type":53,"tag":725,"props":3840,"children":3841},{"style":1424},[3842],{"type":58,"value":1542},{"type":53,"tag":725,"props":3844,"children":3845},{"style":1439},[3846],{"type":58,"value":1547},{"type":53,"tag":725,"props":3848,"children":3849},{"class":727,"line":1430},[3850,3854],{"type":53,"tag":725,"props":3851,"children":3852},{"style":732},[3853],{"type":58,"value":42},{"type":53,"tag":725,"props":3855,"children":3856},{"style":738},[3857],{"type":58,"value":3858}," tunnel\n",{"type":53,"tag":61,"props":3860,"children":3861},{},[3862],{"type":58,"value":3863},"With the tunnel active, any invocation of the connector functions (e.g. clicking \"Connect\" in Atlassian Admin, or triggering a scheduled re-ingestion) will stream output immediately. Look for:",{"type":53,"tag":879,"props":3865,"children":3866},{},[3867,3885,3902],{"type":53,"tag":102,"props":3868,"children":3869},{},[3870,3876,3878,3883],{"type":53,"tag":67,"props":3871,"children":3873},{"className":3872},[],[3874],{"type":58,"value":3875},"[connector] Fetched N items",{"type":58,"value":3877}," — confirms ",{"type":53,"tag":67,"props":3879,"children":3881},{"className":3880},[],[3882],{"type":58,"value":1757},{"type":58,"value":3884}," ran",{"type":53,"tag":102,"props":3886,"children":3887},{},[3888,3894,3895,3900],{"type":53,"tag":67,"props":3889,"children":3891},{"className":3890},[],[3892],{"type":58,"value":3893},"[connector] Batch 1: N accepted, 0 rejected",{"type":58,"value":3877},{"type":53,"tag":67,"props":3896,"children":3898},{"className":3897},[],[3899],{"type":58,"value":319},{"type":58,"value":3901}," succeeded",{"type":53,"tag":102,"props":3903,"children":3904},{},[3905,3907],{"type":58,"value":3906},"Any uncaught errors or thrown exceptions from ",{"type":53,"tag":67,"props":3908,"children":3910},{"className":3909},[],[3911],{"type":58,"value":333},{"type":53,"tag":61,"props":3913,"children":3914},{},[3915,3917,3922],{"type":58,"value":3916},"If the tunnel is not running, use ",{"type":53,"tag":67,"props":3918,"children":3920},{"className":3919},[],[3921],{"type":58,"value":562},{"type":58,"value":3923}," instead to inspect past invocations:",{"type":53,"tag":714,"props":3925,"children":3927},{"className":716,"code":3926,"language":718,"meta":719,"style":719},"# Most recent 50 log lines from development environment\nforge logs -e development --limit 50\n\n# Production logs for a specific site\nforge logs -e production --site \u003Cyour-site> --limit 50\n",[3928],{"type":53,"tag":67,"props":3929,"children":3930},{"__ignoreMap":719},[3931,3939,3971,3978,3986],{"type":53,"tag":725,"props":3932,"children":3933},{"class":727,"line":728},[3934],{"type":53,"tag":725,"props":3935,"children":3936},{"style":1984},[3937],{"type":58,"value":3938},"# Most recent 50 log lines from development environment\n",{"type":53,"tag":725,"props":3940,"children":3941},{"class":727,"line":1430},[3942,3946,3951,3956,3961,3966],{"type":53,"tag":725,"props":3943,"children":3944},{"style":732},[3945],{"type":58,"value":42},{"type":53,"tag":725,"props":3947,"children":3948},{"style":738},[3949],{"type":58,"value":3950}," logs",{"type":53,"tag":725,"props":3952,"children":3953},{"style":738},[3954],{"type":58,"value":3955}," -e",{"type":53,"tag":725,"props":3957,"children":3958},{"style":738},[3959],{"type":58,"value":3960}," development",{"type":53,"tag":725,"props":3962,"children":3963},{"style":738},[3964],{"type":58,"value":3965}," --limit",{"type":53,"tag":725,"props":3967,"children":3968},{"style":2097},[3969],{"type":58,"value":3970}," 50\n",{"type":53,"tag":725,"props":3972,"children":3973},{"class":727,"line":1464},[3974],{"type":53,"tag":725,"props":3975,"children":3976},{"emptyLinePlaceholder":1920},[3977],{"type":58,"value":1923},{"type":53,"tag":725,"props":3979,"children":3980},{"class":727,"line":1492},[3981],{"type":53,"tag":725,"props":3982,"children":3983},{"style":1984},[3984],{"type":58,"value":3985},"# Production logs for a specific site\n",{"type":53,"tag":725,"props":3987,"children":3988},{"class":727,"line":1522},[3989,3993,3997,4001,4006,4011,4015,4020,4024,4028,4032],{"type":53,"tag":725,"props":3990,"children":3991},{"style":732},[3992],{"type":58,"value":42},{"type":53,"tag":725,"props":3994,"children":3995},{"style":738},[3996],{"type":58,"value":3950},{"type":53,"tag":725,"props":3998,"children":3999},{"style":738},[4000],{"type":58,"value":3955},{"type":53,"tag":725,"props":4002,"children":4003},{"style":738},[4004],{"type":58,"value":4005}," production",{"type":53,"tag":725,"props":4007,"children":4008},{"style":738},[4009],{"type":58,"value":4010}," --site",{"type":53,"tag":725,"props":4012,"children":4013},{"style":1439},[4014],{"type":58,"value":1442},{"type":53,"tag":725,"props":4016,"children":4017},{"style":738},[4018],{"type":58,"value":4019},"your-sit",{"type":53,"tag":725,"props":4021,"children":4022},{"style":1424},[4023],{"type":58,"value":1452},{"type":53,"tag":725,"props":4025,"children":4026},{"style":1439},[4027],{"type":58,"value":1457},{"type":53,"tag":725,"props":4029,"children":4030},{"style":738},[4031],{"type":58,"value":3965},{"type":53,"tag":725,"props":4033,"children":4034},{"style":2097},[4035],{"type":58,"value":3970},{"type":53,"tag":61,"props":4037,"children":4038},{},[4039],{"type":53,"tag":76,"props":4040,"children":4041},{},[4042],{"type":58,"value":4043},"Tunnel vs logs — when to use which:",{"type":53,"tag":608,"props":4045,"children":4046},{},[4047,4063],{"type":53,"tag":612,"props":4048,"children":4049},{},[4050],{"type":53,"tag":616,"props":4051,"children":4052},{},[4053,4058],{"type":53,"tag":620,"props":4054,"children":4055},{},[4056],{"type":58,"value":4057},"Situation",{"type":53,"tag":620,"props":4059,"children":4060},{},[4061],{"type":58,"value":4062},"Use",{"type":53,"tag":631,"props":4064,"children":4065},{},[4066,4084,4100],{"type":53,"tag":616,"props":4067,"children":4068},{},[4069,4074],{"type":53,"tag":638,"props":4070,"children":4071},{},[4072],{"type":58,"value":4073},"Actively developing \u002F testing the connection flow",{"type":53,"tag":638,"props":4075,"children":4076},{},[4077,4082],{"type":53,"tag":67,"props":4078,"children":4080},{"className":4079},[],[4081],{"type":58,"value":598},{"type":58,"value":4083}," — live streaming",{"type":53,"tag":616,"props":4085,"children":4086},{},[4087,4092],{"type":53,"tag":638,"props":4088,"children":4089},{},[4090],{"type":58,"value":4091},"Debugging a past invocation or production issue",{"type":53,"tag":638,"props":4093,"children":4094},{},[4095],{"type":53,"tag":67,"props":4096,"children":4098},{"className":4097},[],[4099],{"type":58,"value":562},{"type":53,"tag":616,"props":4101,"children":4102},{},[4103,4108],{"type":53,"tag":638,"props":4104,"children":4105},{},[4106],{"type":58,"value":4107},"Connector function timed out before tunnel caught it",{"type":53,"tag":638,"props":4109,"children":4110},{},[4111,4116,4117],{"type":53,"tag":67,"props":4112,"children":4114},{"className":4113},[],[4115],{"type":58,"value":562},{"type":58,"value":1099},{"type":53,"tag":67,"props":4118,"children":4120},{"className":4119},[],[4121],{"type":58,"value":4122},"--limit 100",{"type":53,"tag":771,"props":4124,"children":4125},{},[4126],{"type":53,"tag":61,"props":4127,"children":4128},{},[4129,4133,4134,4139],{"type":53,"tag":76,"props":4130,"children":4131},{},[4132],{"type":58,"value":781},{"type":58,"value":783},{"type":53,"tag":67,"props":4135,"children":4137},{"className":4136},[],[4138],{"type":58,"value":598},{"type":58,"value":4140}," must be run by the user in an interactive terminal — do not attempt to run it via the agent.",{"type":53,"tag":678,"props":4142,"children":4144},{"id":4143},"step-7-end-to-end-verification-optional",[4145],{"type":58,"value":4146},"Step 7: End-to-End Verification (optional)",{"type":53,"tag":61,"props":4148,"children":4149},{},[4150],{"type":58,"value":4151},"Before running any checks, ask the user:",{"type":53,"tag":771,"props":4153,"children":4154},{},[4155],{"type":53,"tag":61,"props":4156,"children":4157},{},[4158],{"type":58,"value":4159},"\"Would you like to run end-to-end verification checks before deploying to production? This confirms the connection, ingestion, Rovo Search visibility, and permission boundaries are all working correctly.\"",{"type":53,"tag":61,"props":4161,"children":4162},{},[4163,4165,4170,4172,4177],{"type":58,"value":4164},"If the user says ",{"type":53,"tag":76,"props":4166,"children":4167},{},[4168],{"type":58,"value":4169},"no",{"type":58,"value":4171}," or wants to skip, move on — do not run or describe the checks.\nIf the user says ",{"type":53,"tag":76,"props":4173,"children":4174},{},[4175],{"type":58,"value":4176},"yes",{"type":58,"value":4178},", work through every check below in order.",{"type":53,"tag":849,"props":4180,"children":4182},{"id":4181},"check-1-connection-established",[4183],{"type":58,"value":4184},"Check 1 — Connection established",{"type":53,"tag":61,"props":4186,"children":4187},{},[4188,4190,4195,4197,4202,4204,4209,4210,4215],{"type":58,"value":4189},"In ",{"type":53,"tag":76,"props":4191,"children":4192},{},[4193],{"type":58,"value":4194},"Atlassian Administration → Apps → Connected apps",{"type":58,"value":4196},", the connector should show status ",{"type":53,"tag":76,"props":4198,"children":4199},{},[4200],{"type":58,"value":4201},"Connected",{"type":58,"value":4203},". If it shows an error or pending state, go back to Step 6 and inspect ",{"type":53,"tag":67,"props":4205,"children":4207},{"className":4206},[],[4208],{"type":58,"value":598},{"type":58,"value":443},{"type":53,"tag":67,"props":4211,"children":4213},{"className":4212},[],[4214],{"type":58,"value":562},{"type":58,"value":4216}," output.",{"type":53,"tag":849,"props":4218,"children":4220},{"id":4219},"check-2-validateconnection-passed-if-configured",[4221,4223,4229],{"type":58,"value":4222},"Check 2 — ",{"type":53,"tag":67,"props":4224,"children":4226},{"className":4225},[],[4227],{"type":58,"value":4228},"validateConnection",{"type":58,"value":4230}," passed (if configured)",{"type":53,"tag":61,"props":4232,"children":4233},{},[4234,4236,4241,4243,4247,4249,4254],{"type":58,"value":4235},"If the app has a ",{"type":53,"tag":67,"props":4237,"children":4239},{"className":4238},[],[4240],{"type":58,"value":4228},{"type":58,"value":4242}," function, confirm the admin saw a success message when clicking ",{"type":53,"tag":76,"props":4244,"children":4245},{},[4246],{"type":58,"value":3728},{"type":58,"value":4248},". If not, check logs for the return value — it must be ",{"type":53,"tag":67,"props":4250,"children":4252},{"className":4251},[],[4253],{"type":58,"value":357},{"type":58,"value":4255},", not a thrown error.",{"type":53,"tag":849,"props":4257,"children":4259},{"id":4258},"check-3-onconnectionchange-fired-and-ingestion-ran",[4260,4262,4267],{"type":58,"value":4261},"Check 3 — ",{"type":53,"tag":67,"props":4263,"children":4265},{"className":4264},[],[4266],{"type":58,"value":3758},{"type":58,"value":4268}," fired and ingestion ran",{"type":53,"tag":61,"props":4270,"children":4271},{},[4272,4273,4278],{"type":58,"value":4189},{"type":53,"tag":67,"props":4274,"children":4276},{"className":4275},[],[4277],{"type":58,"value":562},{"type":58,"value":4279}," or the tunnel output, confirm:",{"type":53,"tag":714,"props":4281,"children":4283},{"className":716,"code":4282,"language":718,"meta":719,"style":719},"forge logs -e development --limit 50\n",[4284],{"type":53,"tag":67,"props":4285,"children":4286},{"__ignoreMap":719},[4287],{"type":53,"tag":725,"props":4288,"children":4289},{"class":727,"line":728},[4290,4294,4298,4302,4306,4310],{"type":53,"tag":725,"props":4291,"children":4292},{"style":732},[4293],{"type":58,"value":42},{"type":53,"tag":725,"props":4295,"children":4296},{"style":738},[4297],{"type":58,"value":3950},{"type":53,"tag":725,"props":4299,"children":4300},{"style":738},[4301],{"type":58,"value":3955},{"type":53,"tag":725,"props":4303,"children":4304},{"style":738},[4305],{"type":58,"value":3960},{"type":53,"tag":725,"props":4307,"children":4308},{"style":738},[4309],{"type":58,"value":3965},{"type":53,"tag":725,"props":4311,"children":4312},{"style":2097},[4313],{"type":58,"value":3970},{"type":53,"tag":61,"props":4315,"children":4316},{},[4317],{"type":58,"value":4318},"Look for all three signals:",{"type":53,"tag":879,"props":4320,"children":4321},{},[4322,4338,4348],{"type":53,"tag":102,"props":4323,"children":4324},{},[4325,4327,4332,4333],{"type":58,"value":4326},"Handler was invoked: log line from ",{"type":53,"tag":67,"props":4328,"children":4330},{"className":4329},[],[4331],{"type":58,"value":3790},{"type":58,"value":1099},{"type":53,"tag":67,"props":4334,"children":4336},{"className":4335},[],[4337],{"type":58,"value":3765},{"type":53,"tag":102,"props":4339,"children":4340},{},[4341,4343],{"type":58,"value":4342},"Data was fetched: e.g. ",{"type":53,"tag":67,"props":4344,"children":4346},{"className":4345},[],[4347],{"type":58,"value":3875},{"type":53,"tag":102,"props":4349,"children":4350},{},[4351,4356,4358],{"type":53,"tag":67,"props":4352,"children":4354},{"className":4353},[],[4355],{"type":58,"value":319},{"type":58,"value":4357}," succeeded: e.g. ",{"type":53,"tag":67,"props":4359,"children":4361},{"className":4360},[],[4362],{"type":58,"value":3893},{"type":53,"tag":61,"props":4364,"children":4365},{},[4366,4368,4373,4375,4381,4383,4389],{"type":58,"value":4367},"If ",{"type":53,"tag":67,"props":4369,"children":4371},{"className":4370},[],[4372],{"type":58,"value":319},{"type":58,"value":4374}," returned ",{"type":53,"tag":67,"props":4376,"children":4378},{"className":4377},[],[4379],{"type":58,"value":4380},"{ success: false }",{"type":58,"value":4382},", the error detail is in ",{"type":53,"tag":67,"props":4384,"children":4386},{"className":4385},[],[4387],{"type":58,"value":4388},"result.error",{"type":58,"value":4390}," — surface it to the user and fix before continuing.",{"type":53,"tag":849,"props":4392,"children":4394},{"id":4393},"check-4-objects-visible-in-rovo-search",[4395],{"type":58,"value":4396},"Check 4 — Objects visible in Rovo Search",{"type":53,"tag":98,"props":4398,"children":4399},{},[4400,4412,4425],{"type":53,"tag":102,"props":4401,"children":4402},{},[4403,4405,4410],{"type":58,"value":4404},"Open Rovo Search on the Jira site (allow up to ",{"type":53,"tag":76,"props":4406,"children":4407},{},[4408],{"type":58,"value":4409},"5 minutes",{"type":58,"value":4411}," for indexing after ingestion)",{"type":53,"tag":102,"props":4413,"children":4414},{},[4415,4417,4423],{"type":58,"value":4416},"Search for a word that appears in at least one ingested object's ",{"type":53,"tag":67,"props":4418,"children":4420},{"className":4419},[],[4421],{"type":58,"value":4422},"displayName",{"type":58,"value":4424}," or content text",{"type":53,"tag":102,"props":4426,"children":4427},{},[4428],{"type":58,"value":4429},"Filter by the connector's nickname (set by admin at connection time)",{"type":53,"tag":61,"props":4431,"children":4432},{},[4433],{"type":58,"value":4434},"At least one result from the connector should appear. If nothing shows up after 5 minutes:",{"type":53,"tag":879,"props":4436,"children":4437},{},[4438,4458,4492],{"type":53,"tag":102,"props":4439,"children":4440},{},[4441,4443,4448,4450,4456],{"type":58,"value":4442},"Confirm ",{"type":53,"tag":67,"props":4444,"children":4446},{"className":4445},[],[4447],{"type":58,"value":319},{"type":58,"value":4449}," logged ",{"type":53,"tag":67,"props":4451,"children":4453},{"className":4452},[],[4454],{"type":58,"value":4455},"N accepted",{"type":58,"value":4457}," with N > 0 (Check 3)",{"type":53,"tag":102,"props":4459,"children":4460},{},[4461,4463,4469,4471,4476,4478,4483,4485,4490],{"type":58,"value":4462},"Confirm the object's ",{"type":53,"tag":67,"props":4464,"children":4466},{"className":4465},[],[4467],{"type":58,"value":4468},"permissions",{"type":58,"value":4470}," match the logged-in user (an ",{"type":53,"tag":67,"props":4472,"children":4474},{"className":4473},[],[4475],{"type":58,"value":1297},{"type":58,"value":4477}," principal or a ",{"type":53,"tag":67,"props":4479,"children":4481},{"className":4480},[],[4482],{"type":58,"value":1254},{"type":58,"value":4484},"\u002F",{"type":53,"tag":67,"props":4486,"children":4488},{"className":4487},[],[4489],{"type":58,"value":1281},{"type":58,"value":4491}," principal that includes the test user)",{"type":53,"tag":102,"props":4493,"children":4494},{},[4495,4497,4502,4504,4509],{"type":58,"value":4496},"Re-check that ",{"type":53,"tag":67,"props":4498,"children":4500},{"className":4499},[],[4501],{"type":58,"value":487},{"type":58,"value":4503}," scope is present in ",{"type":53,"tag":67,"props":4505,"children":4507},{"className":4506},[],[4508],{"type":58,"value":387},{"type":58,"value":4510}," and the app was redeployed after any scope change",{"type":53,"tag":849,"props":4512,"children":4514},{"id":4513},"check-5-permission-boundary-skip-only-if-everyone-was-used",[4515,4517,4522],{"type":58,"value":4516},"Check 5 — Permission boundary (skip only if ",{"type":53,"tag":67,"props":4518,"children":4520},{"className":4519},[],[4521],{"type":58,"value":1297},{"type":58,"value":4523}," was used)",{"type":53,"tag":61,"props":4525,"children":4526},{},[4527,4529,4534,4535,4540],{"type":58,"value":4528},"If the connector uses ",{"type":53,"tag":67,"props":4530,"children":4532},{"className":4531},[],[4533],{"type":58,"value":1254},{"type":58,"value":443},{"type":53,"tag":67,"props":4536,"children":4538},{"className":4537},[],[4539],{"type":58,"value":1281},{"type":58,"value":4541}," principals:",{"type":53,"tag":98,"props":4543,"children":4544},{},[4545,4557],{"type":53,"tag":102,"props":4546,"children":4547},{},[4548,4550,4555],{"type":58,"value":4549},"Log in as a user who ",{"type":53,"tag":76,"props":4551,"children":4552},{},[4553],{"type":58,"value":4554},"should",{"type":58,"value":4556}," have access → confirm the object appears in Rovo Search",{"type":53,"tag":102,"props":4558,"children":4559},{},[4560,4561,4566,4568,4573],{"type":58,"value":4549},{"type":53,"tag":76,"props":4562,"children":4563},{},[4564],{"type":58,"value":4565},"should not",{"type":58,"value":4567}," have access → confirm the object does ",{"type":53,"tag":76,"props":4569,"children":4570},{},[4571],{"type":58,"value":4572},"not",{"type":58,"value":4574}," appear",{"type":53,"tag":61,"props":4576,"children":4577},{},[4578,4580,4585,4587,4592],{"type":58,"value":4579},"If a restricted object is visible to an unauthorised user, re-check the ",{"type":53,"tag":67,"props":4581,"children":4583},{"className":4582},[],[4584],{"type":58,"value":1175},{"type":58,"value":4586}," principals in ",{"type":53,"tag":67,"props":4588,"children":4590},{"className":4589},[],[4591],{"type":58,"value":319},{"type":58,"value":4593}," and redeploy.",{"type":53,"tag":849,"props":4595,"children":4597},{"id":4596},"check-6-rovo-chat-references-connector-data",[4598],{"type":58,"value":4599},"Check 6 — Rovo Chat references connector data",{"type":53,"tag":61,"props":4601,"children":4602},{},[4603],{"type":58,"value":4604},"Ask Rovo Chat a question whose answer exists only in the ingested content, e.g.:",{"type":53,"tag":771,"props":4606,"children":4607},{},[4608],{"type":53,"tag":61,"props":4609,"children":4610},{},[4611,4613,4618],{"type":58,"value":4612},"\"What is the status of ",{"type":53,"tag":725,"props":4614,"children":4615},{},[4616],{"type":58,"value":4617},"title of an ingested item",{"type":58,"value":4619},"?\"",{"type":53,"tag":61,"props":4621,"children":4622},{},[4623],{"type":58,"value":4624},"Rovo Chat should cite the connector as a source. If it cannot find the content, Checks 3 and 4 likely have an unresolved issue.",{"type":53,"tag":849,"props":4626,"children":4628},{"id":4627},"check-7-scheduled-re-ingestion-fires-if-configured",[4629],{"type":58,"value":4630},"Check 7 — Scheduled re-ingestion fires (if configured)",{"type":53,"tag":61,"props":4632,"children":4633},{},[4634,4636,4641],{"type":58,"value":4635},"If a ",{"type":53,"tag":67,"props":4637,"children":4639},{"className":4638},[],[4640],{"type":58,"value":1097},{"type":58,"value":4642}," was added:",{"type":53,"tag":98,"props":4644,"children":4645},{},[4646,4666,4683],{"type":53,"tag":102,"props":4647,"children":4648},{},[4649,4651,4657,4659,4664],{"type":58,"value":4650},"Temporarily set ",{"type":53,"tag":67,"props":4652,"children":4654},{"className":4653},[],[4655],{"type":58,"value":4656},"interval: fiveMinutes",{"type":58,"value":4658}," in ",{"type":53,"tag":67,"props":4660,"children":4662},{"className":4661},[],[4663],{"type":58,"value":387},{"type":58,"value":4665},", redeploy, and wait one cycle",{"type":53,"tag":102,"props":4667,"children":4668},{},[4669,4670,4675,4677],{"type":58,"value":4442},{"type":53,"tag":67,"props":4671,"children":4673},{"className":4672},[],[4674],{"type":58,"value":562},{"type":58,"value":4676}," shows a fresh ingestion run from ",{"type":53,"tag":67,"props":4678,"children":4680},{"className":4679},[],[4681],{"type":58,"value":4682},"refreshIngestionHandler",{"type":53,"tag":102,"props":4684,"children":4685},{},[4686],{"type":58,"value":4687},"Restore the original interval and redeploy before going to production",{"type":53,"tag":849,"props":4689,"children":4691},{"id":4690},"production-readiness-gate",[4692],{"type":58,"value":4693},"Production readiness gate",{"type":53,"tag":61,"props":4695,"children":4696},{},[4697,4699,4705,4707,4712],{"type":58,"value":4698},"If the user chose to run verification, only proceed to a production deploy (",{"type":53,"tag":67,"props":4700,"children":4702},{"className":4701},[],[4703],{"type":58,"value":4704},"forge deploy -e production",{"type":58,"value":4706},") when ",{"type":53,"tag":76,"props":4708,"children":4709},{},[4710],{"type":58,"value":4711},"all applicable checks above pass",{"type":58,"value":2001},{"type":53,"tag":608,"props":4714,"children":4715},{},[4716,4732],{"type":53,"tag":612,"props":4717,"children":4718},{},[4719],{"type":53,"tag":616,"props":4720,"children":4721},{},[4722,4727],{"type":53,"tag":620,"props":4723,"children":4724},{},[4725],{"type":58,"value":4726},"Check",{"type":53,"tag":620,"props":4728,"children":4729},{},[4730],{"type":58,"value":4731},"Required for production",{"type":53,"tag":631,"props":4733,"children":4734},{},[4735,4748,4768,4780,4792,4818,4830],{"type":53,"tag":616,"props":4736,"children":4737},{},[4738,4743],{"type":53,"tag":638,"props":4739,"children":4740},{},[4741],{"type":58,"value":4742},"1 — Connection established",{"type":53,"tag":638,"props":4744,"children":4745},{},[4746],{"type":58,"value":4747},"Always",{"type":53,"tag":616,"props":4749,"children":4750},{},[4751,4756],{"type":53,"tag":638,"props":4752,"children":4753},{},[4754],{"type":58,"value":4755},"2 — validateConnection passed",{"type":53,"tag":638,"props":4757,"children":4758},{},[4759,4761,4766],{"type":58,"value":4760},"Only if ",{"type":53,"tag":67,"props":4762,"children":4764},{"className":4763},[],[4765],{"type":58,"value":4228},{"type":58,"value":4767}," is configured",{"type":53,"tag":616,"props":4769,"children":4770},{},[4771,4776],{"type":53,"tag":638,"props":4772,"children":4773},{},[4774],{"type":58,"value":4775},"3 — Ingestion ran without errors",{"type":53,"tag":638,"props":4777,"children":4778},{},[4779],{"type":58,"value":4747},{"type":53,"tag":616,"props":4781,"children":4782},{},[4783,4788],{"type":53,"tag":638,"props":4784,"children":4785},{},[4786],{"type":58,"value":4787},"4 — Objects visible in Rovo Search",{"type":53,"tag":638,"props":4789,"children":4790},{},[4791],{"type":58,"value":4747},{"type":53,"tag":616,"props":4793,"children":4794},{},[4795,4800],{"type":53,"tag":638,"props":4796,"children":4797},{},[4798],{"type":58,"value":4799},"5 — Permission boundary",{"type":53,"tag":638,"props":4801,"children":4802},{},[4803,4805,4810,4811,4816],{"type":58,"value":4804},"Only if using ",{"type":53,"tag":67,"props":4806,"children":4808},{"className":4807},[],[4809],{"type":58,"value":1254},{"type":58,"value":4484},{"type":53,"tag":67,"props":4812,"children":4814},{"className":4813},[],[4815],{"type":58,"value":1281},{"type":58,"value":4817}," principals",{"type":53,"tag":616,"props":4819,"children":4820},{},[4821,4826],{"type":53,"tag":638,"props":4822,"children":4823},{},[4824],{"type":58,"value":4825},"6 — Rovo Chat cites connector",{"type":53,"tag":638,"props":4827,"children":4828},{},[4829],{"type":58,"value":4747},{"type":53,"tag":616,"props":4831,"children":4832},{},[4833,4838],{"type":53,"tag":638,"props":4834,"children":4835},{},[4836],{"type":58,"value":4837},"7 — Scheduled re-ingestion fires",{"type":53,"tag":638,"props":4839,"children":4840},{},[4841,4842,4847],{"type":58,"value":4760},{"type":53,"tag":67,"props":4843,"children":4845},{"className":4844},[],[4846],{"type":58,"value":1097},{"type":58,"value":4767},{"type":53,"tag":668,"props":4849,"children":4850},{},[],{"type":53,"tag":91,"props":4852,"children":4854},{"id":4853},"manifest-reference",[4855],{"type":58,"value":4856},"Manifest Reference",{"type":53,"tag":771,"props":4858,"children":4859},{},[4860,4868],{"type":53,"tag":61,"props":4861,"children":4862},{},[4863],{"type":53,"tag":76,"props":4864,"children":4865},{},[4866],{"type":58,"value":4867},"Key rules:",{"type":53,"tag":879,"props":4869,"children":4870},{},[4871,4914,4936,4957],{"type":53,"tag":102,"props":4872,"children":4873},{},[4874,4875,4880,4881,4886,4887,4892,4894,4899,4901,4906,4908,4913],{"type":58,"value":466},{"type":53,"tag":67,"props":4876,"children":4878},{"className":4877},[],[4879],{"type":58,"value":480},{"type":58,"value":389},{"type":53,"tag":67,"props":4882,"children":4884},{"className":4883},[],[4885],{"type":58,"value":487},{"type":58,"value":389},{"type":53,"tag":67,"props":4888,"children":4890},{"className":4889},[],[4891],{"type":58,"value":494},{"type":58,"value":4893}," — NOT ",{"type":53,"tag":67,"props":4895,"children":4897},{"className":4896},[],[4898],{"type":58,"value":502},{"type":58,"value":4900}," \u002F ",{"type":53,"tag":67,"props":4902,"children":4904},{"className":4903},[],[4905],{"type":58,"value":509},{"type":58,"value":4907}," (those fail ",{"type":53,"tag":67,"props":4909,"children":4911},{"className":4910},[],[4912],{"type":58,"value":517},{"type":58,"value":1909},{"type":53,"tag":102,"props":4915,"children":4916},{},[4917,4922,4924,4934],{"type":53,"tag":67,"props":4918,"children":4920},{"className":4919},[],[4921],{"type":58,"value":395},{"type":58,"value":4923}," is declared ",{"type":53,"tag":76,"props":4925,"children":4926},{},[4927,4929],{"type":58,"value":4928},"under ",{"type":53,"tag":67,"props":4930,"children":4932},{"className":4931},[],[4933],{"type":58,"value":403},{"type":58,"value":4935},", not at the top level",{"type":53,"tag":102,"props":4937,"children":4938},{},[4939,4941,4947,4949,4955],{"type":58,"value":4940},"Egress uses ",{"type":53,"tag":67,"props":4942,"children":4944},{"className":4943},[],[4945],{"type":58,"value":4946},"address:",{"type":58,"value":4948}," not a bare string (run ",{"type":53,"tag":67,"props":4950,"children":4952},{"className":4951},[],[4953],{"type":58,"value":4954},"forge lint --fix",{"type":58,"value":4956}," to auto-correct)",{"type":53,"tag":102,"props":4958,"children":4959},{},[4960,4965,4966,4972,4973,4978,4979],{"type":53,"tag":67,"props":4961,"children":4963},{"className":4962},[],[4964],{"type":58,"value":417},{"type":58,"value":419},{"type":53,"tag":67,"props":4967,"children":4969},{"className":4968},[],[4970],{"type":58,"value":4971},"form: [{ type: header, properties: [...] }]",{"type":58,"value":4893},{"type":53,"tag":67,"props":4974,"children":4976},{"className":4975},[],[4977],{"type":58,"value":441},{"type":58,"value":443},{"type":53,"tag":67,"props":4980,"children":4982},{"className":4981},[],[4983],{"type":58,"value":449},{"type":53,"tag":678,"props":4985,"children":4987},{"id":4986},"minimal-connector-no-admin-config-no-oauth",[4988],{"type":58,"value":4989},"Minimal connector (no admin config, no OAuth)",{"type":53,"tag":61,"props":4991,"children":4992},{},[4993],{"type":58,"value":4994},"Use when the app operates entirely within Atlassian — no external credentials needed.",{"type":53,"tag":714,"props":4996,"children":5000},{"className":4997,"code":4998,"language":4999,"meta":719,"style":719},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","app:\n  id: \u003Cgenerated-by-forge-create>\n  runtime:\n    name: nodejs24.x\n    memoryMB: 256\n    architecture: arm64\n\npermissions:\n  scopes:\n    - read:object:jira\n    - write:object:jira\n    - delete:object:jira\n    - storage:app\n\nmodules:\n  graph:connector:\n    - key: my-connector\n      name: My Service\n      icons:\n        light: https:\u002F\u002Fcdn.example.com\u002Flogo.png\n        dark: https:\u002F\u002Fcdn.example.com\u002Flogo.png\n      objectTypes:\n        - atlassian:document\n      datasource:\n        onConnectionChange:\n          function: on-connection-change\n\n  function:\n    - key: on-connection-change\n      handler: index.onConnectionChangeHandler\n","yaml",[5001],{"type":53,"tag":67,"props":5002,"children":5003},{"__ignoreMap":719},[5004,5017,5034,5046,5063,5080,5097,5104,5115,5127,5140,5152,5164,5176,5183,5194,5206,5227,5244,5256,5273,5289,5301,5314,5326,5338,5355,5362,5374,5393],{"type":53,"tag":725,"props":5005,"children":5006},{"class":727,"line":728},[5007,5012],{"type":53,"tag":725,"props":5008,"children":5009},{"style":1993},[5010],{"type":58,"value":5011},"app",{"type":53,"tag":725,"props":5013,"children":5014},{"style":1439},[5015],{"type":58,"value":5016},":\n",{"type":53,"tag":725,"props":5018,"children":5019},{"class":727,"line":1430},[5020,5025,5029],{"type":53,"tag":725,"props":5021,"children":5022},{"style":1993},[5023],{"type":58,"value":5024},"  id",{"type":53,"tag":725,"props":5026,"children":5027},{"style":1439},[5028],{"type":58,"value":2001},{"type":53,"tag":725,"props":5030,"children":5031},{"style":738},[5032],{"type":58,"value":5033}," \u003Cgenerated-by-forge-create>\n",{"type":53,"tag":725,"props":5035,"children":5036},{"class":727,"line":1464},[5037,5042],{"type":53,"tag":725,"props":5038,"children":5039},{"style":1993},[5040],{"type":58,"value":5041},"  runtime",{"type":53,"tag":725,"props":5043,"children":5044},{"style":1439},[5045],{"type":58,"value":5016},{"type":53,"tag":725,"props":5047,"children":5048},{"class":727,"line":1492},[5049,5054,5058],{"type":53,"tag":725,"props":5050,"children":5051},{"style":1993},[5052],{"type":58,"value":5053},"    name",{"type":53,"tag":725,"props":5055,"children":5056},{"style":1439},[5057],{"type":58,"value":2001},{"type":53,"tag":725,"props":5059,"children":5060},{"style":738},[5061],{"type":58,"value":5062}," nodejs24.x\n",{"type":53,"tag":725,"props":5064,"children":5065},{"class":727,"line":1522},[5066,5071,5075],{"type":53,"tag":725,"props":5067,"children":5068},{"style":1993},[5069],{"type":58,"value":5070},"    memoryMB",{"type":53,"tag":725,"props":5072,"children":5073},{"style":1439},[5074],{"type":58,"value":2001},{"type":53,"tag":725,"props":5076,"children":5077},{"style":2097},[5078],{"type":58,"value":5079}," 256\n",{"type":53,"tag":725,"props":5081,"children":5082},{"class":727,"line":2009},[5083,5088,5092],{"type":53,"tag":725,"props":5084,"children":5085},{"style":1993},[5086],{"type":58,"value":5087},"    architecture",{"type":53,"tag":725,"props":5089,"children":5090},{"style":1439},[5091],{"type":58,"value":2001},{"type":53,"tag":725,"props":5093,"children":5094},{"style":738},[5095],{"type":58,"value":5096}," arm64\n",{"type":53,"tag":725,"props":5098,"children":5099},{"class":727,"line":26},[5100],{"type":53,"tag":725,"props":5101,"children":5102},{"emptyLinePlaceholder":1920},[5103],{"type":58,"value":1923},{"type":53,"tag":725,"props":5105,"children":5106},{"class":727,"line":2049},[5107,5111],{"type":53,"tag":725,"props":5108,"children":5109},{"style":1993},[5110],{"type":58,"value":4468},{"type":53,"tag":725,"props":5112,"children":5113},{"style":1439},[5114],{"type":58,"value":5016},{"type":53,"tag":725,"props":5116,"children":5117},{"class":727,"line":2084},[5118,5123],{"type":53,"tag":725,"props":5119,"children":5120},{"style":1993},[5121],{"type":58,"value":5122},"  scopes",{"type":53,"tag":725,"props":5124,"children":5125},{"style":1439},[5126],{"type":58,"value":5016},{"type":53,"tag":725,"props":5128,"children":5129},{"class":727,"line":2107},[5130,5135],{"type":53,"tag":725,"props":5131,"children":5132},{"style":1439},[5133],{"type":58,"value":5134},"    -",{"type":53,"tag":725,"props":5136,"children":5137},{"style":738},[5138],{"type":58,"value":5139}," read:object:jira\n",{"type":53,"tag":725,"props":5141,"children":5142},{"class":727,"line":2137},[5143,5147],{"type":53,"tag":725,"props":5144,"children":5145},{"style":1439},[5146],{"type":58,"value":5134},{"type":53,"tag":725,"props":5148,"children":5149},{"style":738},[5150],{"type":58,"value":5151}," write:object:jira\n",{"type":53,"tag":725,"props":5153,"children":5154},{"class":727,"line":2167},[5155,5159],{"type":53,"tag":725,"props":5156,"children":5157},{"style":1439},[5158],{"type":58,"value":5134},{"type":53,"tag":725,"props":5160,"children":5161},{"style":738},[5162],{"type":58,"value":5163}," delete:object:jira\n",{"type":53,"tag":725,"props":5165,"children":5166},{"class":727,"line":2202},[5167,5171],{"type":53,"tag":725,"props":5168,"children":5169},{"style":1439},[5170],{"type":58,"value":5134},{"type":53,"tag":725,"props":5172,"children":5173},{"style":738},[5174],{"type":58,"value":5175}," storage:app\n",{"type":53,"tag":725,"props":5177,"children":5178},{"class":727,"line":22},[5179],{"type":53,"tag":725,"props":5180,"children":5181},{"emptyLinePlaceholder":1920},[5182],{"type":58,"value":1923},{"type":53,"tag":725,"props":5184,"children":5185},{"class":727,"line":2240},[5186,5190],{"type":53,"tag":725,"props":5187,"children":5188},{"style":1993},[5189],{"type":58,"value":379},{"type":53,"tag":725,"props":5191,"children":5192},{"style":1439},[5193],{"type":58,"value":5016},{"type":53,"tag":725,"props":5195,"children":5196},{"class":727,"line":2249},[5197,5202],{"type":53,"tag":725,"props":5198,"children":5199},{"style":1993},[5200],{"type":58,"value":5201},"  graph:connector",{"type":53,"tag":725,"props":5203,"children":5204},{"style":1439},[5205],{"type":58,"value":5016},{"type":53,"tag":725,"props":5207,"children":5208},{"class":727,"line":2258},[5209,5213,5218,5222],{"type":53,"tag":725,"props":5210,"children":5211},{"style":1439},[5212],{"type":58,"value":5134},{"type":53,"tag":725,"props":5214,"children":5215},{"style":1993},[5216],{"type":58,"value":5217}," key",{"type":53,"tag":725,"props":5219,"children":5220},{"style":1439},[5221],{"type":58,"value":2001},{"type":53,"tag":725,"props":5223,"children":5224},{"style":738},[5225],{"type":58,"value":5226}," my-connector\n",{"type":53,"tag":725,"props":5228,"children":5229},{"class":727,"line":2267},[5230,5235,5239],{"type":53,"tag":725,"props":5231,"children":5232},{"style":1993},[5233],{"type":58,"value":5234},"      name",{"type":53,"tag":725,"props":5236,"children":5237},{"style":1439},[5238],{"type":58,"value":2001},{"type":53,"tag":725,"props":5240,"children":5241},{"style":738},[5242],{"type":58,"value":5243}," My Service\n",{"type":53,"tag":725,"props":5245,"children":5246},{"class":727,"line":2289},[5247,5252],{"type":53,"tag":725,"props":5248,"children":5249},{"style":1993},[5250],{"type":58,"value":5251},"      icons",{"type":53,"tag":725,"props":5253,"children":5254},{"style":1439},[5255],{"type":58,"value":5016},{"type":53,"tag":725,"props":5257,"children":5258},{"class":727,"line":2310},[5259,5264,5268],{"type":53,"tag":725,"props":5260,"children":5261},{"style":1993},[5262],{"type":58,"value":5263},"        light",{"type":53,"tag":725,"props":5265,"children":5266},{"style":1439},[5267],{"type":58,"value":2001},{"type":53,"tag":725,"props":5269,"children":5270},{"style":738},[5271],{"type":58,"value":5272}," https:\u002F\u002Fcdn.example.com\u002Flogo.png\n",{"type":53,"tag":725,"props":5274,"children":5275},{"class":727,"line":2367},[5276,5281,5285],{"type":53,"tag":725,"props":5277,"children":5278},{"style":1993},[5279],{"type":58,"value":5280},"        dark",{"type":53,"tag":725,"props":5282,"children":5283},{"style":1439},[5284],{"type":58,"value":2001},{"type":53,"tag":725,"props":5286,"children":5287},{"style":738},[5288],{"type":58,"value":5272},{"type":53,"tag":725,"props":5290,"children":5291},{"class":727,"line":2384},[5292,5297],{"type":53,"tag":725,"props":5293,"children":5294},{"style":1993},[5295],{"type":58,"value":5296},"      objectTypes",{"type":53,"tag":725,"props":5298,"children":5299},{"style":1439},[5300],{"type":58,"value":5016},{"type":53,"tag":725,"props":5302,"children":5303},{"class":727,"line":2401},[5304,5309],{"type":53,"tag":725,"props":5305,"children":5306},{"style":1439},[5307],{"type":58,"value":5308},"        -",{"type":53,"tag":725,"props":5310,"children":5311},{"style":738},[5312],{"type":58,"value":5313}," atlassian:document\n",{"type":53,"tag":725,"props":5315,"children":5316},{"class":727,"line":2427},[5317,5322],{"type":53,"tag":725,"props":5318,"children":5319},{"style":1993},[5320],{"type":58,"value":5321},"      datasource",{"type":53,"tag":725,"props":5323,"children":5324},{"style":1439},[5325],{"type":58,"value":5016},{"type":53,"tag":725,"props":5327,"children":5328},{"class":727,"line":2444},[5329,5334],{"type":53,"tag":725,"props":5330,"children":5331},{"style":1993},[5332],{"type":58,"value":5333},"        onConnectionChange",{"type":53,"tag":725,"props":5335,"children":5336},{"style":1439},[5337],{"type":58,"value":5016},{"type":53,"tag":725,"props":5339,"children":5340},{"class":727,"line":2479},[5341,5346,5350],{"type":53,"tag":725,"props":5342,"children":5343},{"style":1993},[5344],{"type":58,"value":5345},"          function",{"type":53,"tag":725,"props":5347,"children":5348},{"style":1439},[5349],{"type":58,"value":2001},{"type":53,"tag":725,"props":5351,"children":5352},{"style":738},[5353],{"type":58,"value":5354}," on-connection-change\n",{"type":53,"tag":725,"props":5356,"children":5357},{"class":727,"line":2509},[5358],{"type":53,"tag":725,"props":5359,"children":5360},{"emptyLinePlaceholder":1920},[5361],{"type":58,"value":1923},{"type":53,"tag":725,"props":5363,"children":5364},{"class":727,"line":2518},[5365,5370],{"type":53,"tag":725,"props":5366,"children":5367},{"style":1993},[5368],{"type":58,"value":5369},"  function",{"type":53,"tag":725,"props":5371,"children":5372},{"style":1439},[5373],{"type":58,"value":5016},{"type":53,"tag":725,"props":5375,"children":5376},{"class":727,"line":2535},[5377,5381,5385,5389],{"type":53,"tag":725,"props":5378,"children":5379},{"style":1439},[5380],{"type":58,"value":5134},{"type":53,"tag":725,"props":5382,"children":5383},{"style":1993},[5384],{"type":58,"value":5217},{"type":53,"tag":725,"props":5386,"children":5387},{"style":1439},[5388],{"type":58,"value":2001},{"type":53,"tag":725,"props":5390,"children":5391},{"style":738},[5392],{"type":58,"value":5354},{"type":53,"tag":725,"props":5394,"children":5395},{"class":727,"line":2563},[5396,5401,5405],{"type":53,"tag":725,"props":5397,"children":5398},{"style":1993},[5399],{"type":58,"value":5400},"      handler",{"type":53,"tag":725,"props":5402,"children":5403},{"style":1439},[5404],{"type":58,"value":2001},{"type":53,"tag":725,"props":5406,"children":5407},{"style":738},[5408],{"type":58,"value":5409}," index.onConnectionChangeHandler\n",{"type":53,"tag":678,"props":5411,"children":5413},{"id":5412},"connector-with-admin-form-config-api-key-url",[5414],{"type":58,"value":5415},"Connector with admin form config (API key \u002F URL)",{"type":53,"tag":61,"props":5417,"children":5418},{},[5419],{"type":58,"value":5420},"Use when the admin must provide credentials to connect to an external system.",{"type":53,"tag":714,"props":5422,"children":5424},{"className":4997,"code":5423,"language":4999,"meta":719,"style":719},"app:\n  id: \u003Cgenerated-by-forge-create>\n  runtime:\n    name: nodejs24.x\n    memoryMB: 256\n    architecture: arm64\n\npermissions:\n  scopes:\n    - read:object:jira\n    - write:object:jira\n    - delete:object:jira\n    - storage:app\n  external:\n    fetch:\n      backend:\n        - address: 'https:\u002F\u002Fapi.your-service.com'   # note: address: not a bare string\n\nmodules:\n  graph:connector:\n    - key: my-connector\n      name: My Service\n      icons:\n        light: https:\u002F\u002Fcdn.example.com\u002Flogo.png\n        dark: https:\u002F\u002Fcdn.example.com\u002Flogo.png\n      objectTypes:\n        - atlassian:document\n      datasource:\n        formConfiguration:\n          form:                          # use form:, NOT fields: or beforeYouBegin:\n            - key: connectionDetails\n              type: header\n              title: Connection Details\n              description: >\n                Provide your My Service API credentials.\n                Find them in My Service → Settings → API.\n              properties:\n                - key: apiKey           # camelCase keys — accessed as request.configProperties.apiKey\n                  label: API Key\n                  type: string\n                  isRequired: true\n                - key: apiUrl\n                  label: API URL\n                  type: string\n                  isRequired: true\n          validateConnection:\n            function: validate-connection\n        onConnectionChange:\n          function: on-connection-change\n\n  function:                              # function: is under modules:, NOT top-level\n    - key: on-connection-change\n      handler: index.onConnectionChangeHandler\n    - key: validate-connection\n      handler: index.validateConnectionHandler\n",[5425],{"type":53,"tag":67,"props":5426,"children":5427},{"__ignoreMap":719},[5428,5439,5454,5465,5480,5495,5510,5517,5528,5539,5550,5561,5572,5583,5595,5607,5619,5653,5660,5671,5682,5701,5716,5727,5742,5757,5768,5779,5790,5802,5819,5840,5857,5874,5891,5899,5907,5919,5945,5962,5980,5999,6020,6037,6053,6069,6082,6100,6112,6128,6136,6153,6173,6189,6209],{"type":53,"tag":725,"props":5429,"children":5430},{"class":727,"line":728},[5431,5435],{"type":53,"tag":725,"props":5432,"children":5433},{"style":1993},[5434],{"type":58,"value":5011},{"type":53,"tag":725,"props":5436,"children":5437},{"style":1439},[5438],{"type":58,"value":5016},{"type":53,"tag":725,"props":5440,"children":5441},{"class":727,"line":1430},[5442,5446,5450],{"type":53,"tag":725,"props":5443,"children":5444},{"style":1993},[5445],{"type":58,"value":5024},{"type":53,"tag":725,"props":5447,"children":5448},{"style":1439},[5449],{"type":58,"value":2001},{"type":53,"tag":725,"props":5451,"children":5452},{"style":738},[5453],{"type":58,"value":5033},{"type":53,"tag":725,"props":5455,"children":5456},{"class":727,"line":1464},[5457,5461],{"type":53,"tag":725,"props":5458,"children":5459},{"style":1993},[5460],{"type":58,"value":5041},{"type":53,"tag":725,"props":5462,"children":5463},{"style":1439},[5464],{"type":58,"value":5016},{"type":53,"tag":725,"props":5466,"children":5467},{"class":727,"line":1492},[5468,5472,5476],{"type":53,"tag":725,"props":5469,"children":5470},{"style":1993},[5471],{"type":58,"value":5053},{"type":53,"tag":725,"props":5473,"children":5474},{"style":1439},[5475],{"type":58,"value":2001},{"type":53,"tag":725,"props":5477,"children":5478},{"style":738},[5479],{"type":58,"value":5062},{"type":53,"tag":725,"props":5481,"children":5482},{"class":727,"line":1522},[5483,5487,5491],{"type":53,"tag":725,"props":5484,"children":5485},{"style":1993},[5486],{"type":58,"value":5070},{"type":53,"tag":725,"props":5488,"children":5489},{"style":1439},[5490],{"type":58,"value":2001},{"type":53,"tag":725,"props":5492,"children":5493},{"style":2097},[5494],{"type":58,"value":5079},{"type":53,"tag":725,"props":5496,"children":5497},{"class":727,"line":2009},[5498,5502,5506],{"type":53,"tag":725,"props":5499,"children":5500},{"style":1993},[5501],{"type":58,"value":5087},{"type":53,"tag":725,"props":5503,"children":5504},{"style":1439},[5505],{"type":58,"value":2001},{"type":53,"tag":725,"props":5507,"children":5508},{"style":738},[5509],{"type":58,"value":5096},{"type":53,"tag":725,"props":5511,"children":5512},{"class":727,"line":26},[5513],{"type":53,"tag":725,"props":5514,"children":5515},{"emptyLinePlaceholder":1920},[5516],{"type":58,"value":1923},{"type":53,"tag":725,"props":5518,"children":5519},{"class":727,"line":2049},[5520,5524],{"type":53,"tag":725,"props":5521,"children":5522},{"style":1993},[5523],{"type":58,"value":4468},{"type":53,"tag":725,"props":5525,"children":5526},{"style":1439},[5527],{"type":58,"value":5016},{"type":53,"tag":725,"props":5529,"children":5530},{"class":727,"line":2084},[5531,5535],{"type":53,"tag":725,"props":5532,"children":5533},{"style":1993},[5534],{"type":58,"value":5122},{"type":53,"tag":725,"props":5536,"children":5537},{"style":1439},[5538],{"type":58,"value":5016},{"type":53,"tag":725,"props":5540,"children":5541},{"class":727,"line":2107},[5542,5546],{"type":53,"tag":725,"props":5543,"children":5544},{"style":1439},[5545],{"type":58,"value":5134},{"type":53,"tag":725,"props":5547,"children":5548},{"style":738},[5549],{"type":58,"value":5139},{"type":53,"tag":725,"props":5551,"children":5552},{"class":727,"line":2137},[5553,5557],{"type":53,"tag":725,"props":5554,"children":5555},{"style":1439},[5556],{"type":58,"value":5134},{"type":53,"tag":725,"props":5558,"children":5559},{"style":738},[5560],{"type":58,"value":5151},{"type":53,"tag":725,"props":5562,"children":5563},{"class":727,"line":2167},[5564,5568],{"type":53,"tag":725,"props":5565,"children":5566},{"style":1439},[5567],{"type":58,"value":5134},{"type":53,"tag":725,"props":5569,"children":5570},{"style":738},[5571],{"type":58,"value":5163},{"type":53,"tag":725,"props":5573,"children":5574},{"class":727,"line":2202},[5575,5579],{"type":53,"tag":725,"props":5576,"children":5577},{"style":1439},[5578],{"type":58,"value":5134},{"type":53,"tag":725,"props":5580,"children":5581},{"style":738},[5582],{"type":58,"value":5175},{"type":53,"tag":725,"props":5584,"children":5585},{"class":727,"line":22},[5586,5591],{"type":53,"tag":725,"props":5587,"children":5588},{"style":1993},[5589],{"type":58,"value":5590},"  external",{"type":53,"tag":725,"props":5592,"children":5593},{"style":1439},[5594],{"type":58,"value":5016},{"type":53,"tag":725,"props":5596,"children":5597},{"class":727,"line":2240},[5598,5603],{"type":53,"tag":725,"props":5599,"children":5600},{"style":1993},[5601],{"type":58,"value":5602},"    fetch",{"type":53,"tag":725,"props":5604,"children":5605},{"style":1439},[5606],{"type":58,"value":5016},{"type":53,"tag":725,"props":5608,"children":5609},{"class":727,"line":2249},[5610,5615],{"type":53,"tag":725,"props":5611,"children":5612},{"style":1993},[5613],{"type":58,"value":5614},"      backend",{"type":53,"tag":725,"props":5616,"children":5617},{"style":1439},[5618],{"type":58,"value":5016},{"type":53,"tag":725,"props":5620,"children":5621},{"class":727,"line":2258},[5622,5626,5631,5635,5639,5644,5648],{"type":53,"tag":725,"props":5623,"children":5624},{"style":1439},[5625],{"type":58,"value":5308},{"type":53,"tag":725,"props":5627,"children":5628},{"style":1993},[5629],{"type":58,"value":5630}," address",{"type":53,"tag":725,"props":5632,"children":5633},{"style":1439},[5634],{"type":58,"value":2001},{"type":53,"tag":725,"props":5636,"children":5637},{"style":1439},[5638],{"type":58,"value":2032},{"type":53,"tag":725,"props":5640,"children":5641},{"style":738},[5642],{"type":58,"value":5643},"https:\u002F\u002Fapi.your-service.com",{"type":53,"tag":725,"props":5645,"children":5646},{"style":1439},[5647],{"type":58,"value":1896},{"type":53,"tag":725,"props":5649,"children":5650},{"style":1984},[5651],{"type":58,"value":5652},"   # note: address: not a bare string\n",{"type":53,"tag":725,"props":5654,"children":5655},{"class":727,"line":2267},[5656],{"type":53,"tag":725,"props":5657,"children":5658},{"emptyLinePlaceholder":1920},[5659],{"type":58,"value":1923},{"type":53,"tag":725,"props":5661,"children":5662},{"class":727,"line":2289},[5663,5667],{"type":53,"tag":725,"props":5664,"children":5665},{"style":1993},[5666],{"type":58,"value":379},{"type":53,"tag":725,"props":5668,"children":5669},{"style":1439},[5670],{"type":58,"value":5016},{"type":53,"tag":725,"props":5672,"children":5673},{"class":727,"line":2310},[5674,5678],{"type":53,"tag":725,"props":5675,"children":5676},{"style":1993},[5677],{"type":58,"value":5201},{"type":53,"tag":725,"props":5679,"children":5680},{"style":1439},[5681],{"type":58,"value":5016},{"type":53,"tag":725,"props":5683,"children":5684},{"class":727,"line":2367},[5685,5689,5693,5697],{"type":53,"tag":725,"props":5686,"children":5687},{"style":1439},[5688],{"type":58,"value":5134},{"type":53,"tag":725,"props":5690,"children":5691},{"style":1993},[5692],{"type":58,"value":5217},{"type":53,"tag":725,"props":5694,"children":5695},{"style":1439},[5696],{"type":58,"value":2001},{"type":53,"tag":725,"props":5698,"children":5699},{"style":738},[5700],{"type":58,"value":5226},{"type":53,"tag":725,"props":5702,"children":5703},{"class":727,"line":2384},[5704,5708,5712],{"type":53,"tag":725,"props":5705,"children":5706},{"style":1993},[5707],{"type":58,"value":5234},{"type":53,"tag":725,"props":5709,"children":5710},{"style":1439},[5711],{"type":58,"value":2001},{"type":53,"tag":725,"props":5713,"children":5714},{"style":738},[5715],{"type":58,"value":5243},{"type":53,"tag":725,"props":5717,"children":5718},{"class":727,"line":2401},[5719,5723],{"type":53,"tag":725,"props":5720,"children":5721},{"style":1993},[5722],{"type":58,"value":5251},{"type":53,"tag":725,"props":5724,"children":5725},{"style":1439},[5726],{"type":58,"value":5016},{"type":53,"tag":725,"props":5728,"children":5729},{"class":727,"line":2427},[5730,5734,5738],{"type":53,"tag":725,"props":5731,"children":5732},{"style":1993},[5733],{"type":58,"value":5263},{"type":53,"tag":725,"props":5735,"children":5736},{"style":1439},[5737],{"type":58,"value":2001},{"type":53,"tag":725,"props":5739,"children":5740},{"style":738},[5741],{"type":58,"value":5272},{"type":53,"tag":725,"props":5743,"children":5744},{"class":727,"line":2444},[5745,5749,5753],{"type":53,"tag":725,"props":5746,"children":5747},{"style":1993},[5748],{"type":58,"value":5280},{"type":53,"tag":725,"props":5750,"children":5751},{"style":1439},[5752],{"type":58,"value":2001},{"type":53,"tag":725,"props":5754,"children":5755},{"style":738},[5756],{"type":58,"value":5272},{"type":53,"tag":725,"props":5758,"children":5759},{"class":727,"line":2479},[5760,5764],{"type":53,"tag":725,"props":5761,"children":5762},{"style":1993},[5763],{"type":58,"value":5296},{"type":53,"tag":725,"props":5765,"children":5766},{"style":1439},[5767],{"type":58,"value":5016},{"type":53,"tag":725,"props":5769,"children":5770},{"class":727,"line":2509},[5771,5775],{"type":53,"tag":725,"props":5772,"children":5773},{"style":1439},[5774],{"type":58,"value":5308},{"type":53,"tag":725,"props":5776,"children":5777},{"style":738},[5778],{"type":58,"value":5313},{"type":53,"tag":725,"props":5780,"children":5781},{"class":727,"line":2518},[5782,5786],{"type":53,"tag":725,"props":5783,"children":5784},{"style":1993},[5785],{"type":58,"value":5321},{"type":53,"tag":725,"props":5787,"children":5788},{"style":1439},[5789],{"type":58,"value":5016},{"type":53,"tag":725,"props":5791,"children":5792},{"class":727,"line":2535},[5793,5798],{"type":53,"tag":725,"props":5794,"children":5795},{"style":1993},[5796],{"type":58,"value":5797},"        formConfiguration",{"type":53,"tag":725,"props":5799,"children":5800},{"style":1439},[5801],{"type":58,"value":5016},{"type":53,"tag":725,"props":5803,"children":5804},{"class":727,"line":2563},[5805,5810,5814],{"type":53,"tag":725,"props":5806,"children":5807},{"style":1993},[5808],{"type":58,"value":5809},"          form",{"type":53,"tag":725,"props":5811,"children":5812},{"style":1439},[5813],{"type":58,"value":2001},{"type":53,"tag":725,"props":5815,"children":5816},{"style":1984},[5817],{"type":58,"value":5818},"                          # use form:, NOT fields: or beforeYouBegin:\n",{"type":53,"tag":725,"props":5820,"children":5821},{"class":727,"line":2593},[5822,5827,5831,5835],{"type":53,"tag":725,"props":5823,"children":5824},{"style":1439},[5825],{"type":58,"value":5826},"            -",{"type":53,"tag":725,"props":5828,"children":5829},{"style":1993},[5830],{"type":58,"value":5217},{"type":53,"tag":725,"props":5832,"children":5833},{"style":1439},[5834],{"type":58,"value":2001},{"type":53,"tag":725,"props":5836,"children":5837},{"style":738},[5838],{"type":58,"value":5839}," connectionDetails\n",{"type":53,"tag":725,"props":5841,"children":5842},{"class":727,"line":2601},[5843,5848,5852],{"type":53,"tag":725,"props":5844,"children":5845},{"style":1993},[5846],{"type":58,"value":5847},"              type",{"type":53,"tag":725,"props":5849,"children":5850},{"style":1439},[5851],{"type":58,"value":2001},{"type":53,"tag":725,"props":5853,"children":5854},{"style":738},[5855],{"type":58,"value":5856}," header\n",{"type":53,"tag":725,"props":5858,"children":5859},{"class":727,"line":2610},[5860,5865,5869],{"type":53,"tag":725,"props":5861,"children":5862},{"style":1993},[5863],{"type":58,"value":5864},"              title",{"type":53,"tag":725,"props":5866,"children":5867},{"style":1439},[5868],{"type":58,"value":2001},{"type":53,"tag":725,"props":5870,"children":5871},{"style":738},[5872],{"type":58,"value":5873}," Connection Details\n",{"type":53,"tag":725,"props":5875,"children":5876},{"class":727,"line":2619},[5877,5882,5886],{"type":53,"tag":725,"props":5878,"children":5879},{"style":1993},[5880],{"type":58,"value":5881},"              description",{"type":53,"tag":725,"props":5883,"children":5884},{"style":1439},[5885],{"type":58,"value":2001},{"type":53,"tag":725,"props":5887,"children":5888},{"style":1943},[5889],{"type":58,"value":5890}," >\n",{"type":53,"tag":725,"props":5892,"children":5893},{"class":727,"line":2632},[5894],{"type":53,"tag":725,"props":5895,"children":5896},{"style":738},[5897],{"type":58,"value":5898},"                Provide your My Service API credentials.\n",{"type":53,"tag":725,"props":5900,"children":5901},{"class":727,"line":2648},[5902],{"type":53,"tag":725,"props":5903,"children":5904},{"style":738},[5905],{"type":58,"value":5906},"                Find them in My Service → Settings → API.\n",{"type":53,"tag":725,"props":5908,"children":5909},{"class":727,"line":2656},[5910,5915],{"type":53,"tag":725,"props":5911,"children":5912},{"style":1993},[5913],{"type":58,"value":5914},"              properties",{"type":53,"tag":725,"props":5916,"children":5917},{"style":1439},[5918],{"type":58,"value":5016},{"type":53,"tag":725,"props":5920,"children":5921},{"class":727,"line":2693},[5922,5927,5931,5935,5940],{"type":53,"tag":725,"props":5923,"children":5924},{"style":1439},[5925],{"type":58,"value":5926},"                -",{"type":53,"tag":725,"props":5928,"children":5929},{"style":1993},[5930],{"type":58,"value":5217},{"type":53,"tag":725,"props":5932,"children":5933},{"style":1439},[5934],{"type":58,"value":2001},{"type":53,"tag":725,"props":5936,"children":5937},{"style":738},[5938],{"type":58,"value":5939}," apiKey",{"type":53,"tag":725,"props":5941,"children":5942},{"style":1984},[5943],{"type":58,"value":5944},"           # camelCase keys — accessed as request.configProperties.apiKey\n",{"type":53,"tag":725,"props":5946,"children":5947},{"class":727,"line":2753},[5948,5953,5957],{"type":53,"tag":725,"props":5949,"children":5950},{"style":1993},[5951],{"type":58,"value":5952},"                  label",{"type":53,"tag":725,"props":5954,"children":5955},{"style":1439},[5956],{"type":58,"value":2001},{"type":53,"tag":725,"props":5958,"children":5959},{"style":738},[5960],{"type":58,"value":5961}," API Key\n",{"type":53,"tag":725,"props":5963,"children":5965},{"class":727,"line":5964},40,[5966,5971,5975],{"type":53,"tag":725,"props":5967,"children":5968},{"style":1993},[5969],{"type":58,"value":5970},"                  type",{"type":53,"tag":725,"props":5972,"children":5973},{"style":1439},[5974],{"type":58,"value":2001},{"type":53,"tag":725,"props":5976,"children":5977},{"style":738},[5978],{"type":58,"value":5979}," string\n",{"type":53,"tag":725,"props":5981,"children":5983},{"class":727,"line":5982},41,[5984,5989,5993],{"type":53,"tag":725,"props":5985,"children":5986},{"style":1993},[5987],{"type":58,"value":5988},"                  isRequired",{"type":53,"tag":725,"props":5990,"children":5991},{"style":1439},[5992],{"type":58,"value":2001},{"type":53,"tag":725,"props":5994,"children":5996},{"style":5995},"--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC",[5997],{"type":58,"value":5998}," true\n",{"type":53,"tag":725,"props":6000,"children":6002},{"class":727,"line":6001},42,[6003,6007,6011,6015],{"type":53,"tag":725,"props":6004,"children":6005},{"style":1439},[6006],{"type":58,"value":5926},{"type":53,"tag":725,"props":6008,"children":6009},{"style":1993},[6010],{"type":58,"value":5217},{"type":53,"tag":725,"props":6012,"children":6013},{"style":1439},[6014],{"type":58,"value":2001},{"type":53,"tag":725,"props":6016,"children":6017},{"style":738},[6018],{"type":58,"value":6019}," apiUrl\n",{"type":53,"tag":725,"props":6021,"children":6023},{"class":727,"line":6022},43,[6024,6028,6032],{"type":53,"tag":725,"props":6025,"children":6026},{"style":1993},[6027],{"type":58,"value":5952},{"type":53,"tag":725,"props":6029,"children":6030},{"style":1439},[6031],{"type":58,"value":2001},{"type":53,"tag":725,"props":6033,"children":6034},{"style":738},[6035],{"type":58,"value":6036}," API URL\n",{"type":53,"tag":725,"props":6038,"children":6040},{"class":727,"line":6039},44,[6041,6045,6049],{"type":53,"tag":725,"props":6042,"children":6043},{"style":1993},[6044],{"type":58,"value":5970},{"type":53,"tag":725,"props":6046,"children":6047},{"style":1439},[6048],{"type":58,"value":2001},{"type":53,"tag":725,"props":6050,"children":6051},{"style":738},[6052],{"type":58,"value":5979},{"type":53,"tag":725,"props":6054,"children":6056},{"class":727,"line":6055},45,[6057,6061,6065],{"type":53,"tag":725,"props":6058,"children":6059},{"style":1993},[6060],{"type":58,"value":5988},{"type":53,"tag":725,"props":6062,"children":6063},{"style":1439},[6064],{"type":58,"value":2001},{"type":53,"tag":725,"props":6066,"children":6067},{"style":5995},[6068],{"type":58,"value":5998},{"type":53,"tag":725,"props":6070,"children":6072},{"class":727,"line":6071},46,[6073,6078],{"type":53,"tag":725,"props":6074,"children":6075},{"style":1993},[6076],{"type":58,"value":6077},"          validateConnection",{"type":53,"tag":725,"props":6079,"children":6080},{"style":1439},[6081],{"type":58,"value":5016},{"type":53,"tag":725,"props":6083,"children":6085},{"class":727,"line":6084},47,[6086,6091,6095],{"type":53,"tag":725,"props":6087,"children":6088},{"style":1993},[6089],{"type":58,"value":6090},"            function",{"type":53,"tag":725,"props":6092,"children":6093},{"style":1439},[6094],{"type":58,"value":2001},{"type":53,"tag":725,"props":6096,"children":6097},{"style":738},[6098],{"type":58,"value":6099}," validate-connection\n",{"type":53,"tag":725,"props":6101,"children":6103},{"class":727,"line":6102},48,[6104,6108],{"type":53,"tag":725,"props":6105,"children":6106},{"style":1993},[6107],{"type":58,"value":5333},{"type":53,"tag":725,"props":6109,"children":6110},{"style":1439},[6111],{"type":58,"value":5016},{"type":53,"tag":725,"props":6113,"children":6115},{"class":727,"line":6114},49,[6116,6120,6124],{"type":53,"tag":725,"props":6117,"children":6118},{"style":1993},[6119],{"type":58,"value":5345},{"type":53,"tag":725,"props":6121,"children":6122},{"style":1439},[6123],{"type":58,"value":2001},{"type":53,"tag":725,"props":6125,"children":6126},{"style":738},[6127],{"type":58,"value":5354},{"type":53,"tag":725,"props":6129,"children":6131},{"class":727,"line":6130},50,[6132],{"type":53,"tag":725,"props":6133,"children":6134},{"emptyLinePlaceholder":1920},[6135],{"type":58,"value":1923},{"type":53,"tag":725,"props":6137,"children":6139},{"class":727,"line":6138},51,[6140,6144,6148],{"type":53,"tag":725,"props":6141,"children":6142},{"style":1993},[6143],{"type":58,"value":5369},{"type":53,"tag":725,"props":6145,"children":6146},{"style":1439},[6147],{"type":58,"value":2001},{"type":53,"tag":725,"props":6149,"children":6150},{"style":1984},[6151],{"type":58,"value":6152},"                              # function: is under modules:, NOT top-level\n",{"type":53,"tag":725,"props":6154,"children":6156},{"class":727,"line":6155},52,[6157,6161,6165,6169],{"type":53,"tag":725,"props":6158,"children":6159},{"style":1439},[6160],{"type":58,"value":5134},{"type":53,"tag":725,"props":6162,"children":6163},{"style":1993},[6164],{"type":58,"value":5217},{"type":53,"tag":725,"props":6166,"children":6167},{"style":1439},[6168],{"type":58,"value":2001},{"type":53,"tag":725,"props":6170,"children":6171},{"style":738},[6172],{"type":58,"value":5354},{"type":53,"tag":725,"props":6174,"children":6176},{"class":727,"line":6175},53,[6177,6181,6185],{"type":53,"tag":725,"props":6178,"children":6179},{"style":1993},[6180],{"type":58,"value":5400},{"type":53,"tag":725,"props":6182,"children":6183},{"style":1439},[6184],{"type":58,"value":2001},{"type":53,"tag":725,"props":6186,"children":6187},{"style":738},[6188],{"type":58,"value":5409},{"type":53,"tag":725,"props":6190,"children":6192},{"class":727,"line":6191},54,[6193,6197,6201,6205],{"type":53,"tag":725,"props":6194,"children":6195},{"style":1439},[6196],{"type":58,"value":5134},{"type":53,"tag":725,"props":6198,"children":6199},{"style":1993},[6200],{"type":58,"value":5217},{"type":53,"tag":725,"props":6202,"children":6203},{"style":1439},[6204],{"type":58,"value":2001},{"type":53,"tag":725,"props":6206,"children":6207},{"style":738},[6208],{"type":58,"value":6099},{"type":53,"tag":725,"props":6210,"children":6212},{"class":727,"line":6211},55,[6213,6217,6221],{"type":53,"tag":725,"props":6214,"children":6215},{"style":1993},[6216],{"type":58,"value":5400},{"type":53,"tag":725,"props":6218,"children":6219},{"style":1439},[6220],{"type":58,"value":2001},{"type":53,"tag":725,"props":6222,"children":6223},{"style":738},[6224],{"type":58,"value":6225}," index.validateConnectionHandler\n",{"type":53,"tag":668,"props":6227,"children":6228},{},[],{"type":53,"tag":91,"props":6230,"children":6232},{"id":6231},"handler-signatures",[6233],{"type":58,"value":6234},"Handler Signatures",{"type":53,"tag":771,"props":6236,"children":6237},{},[6238],{"type":53,"tag":61,"props":6239,"children":6240},{},[6241,6246,6248,6253,6255,6260,6262,6267,6269,6274,6276,6281],{"type":53,"tag":76,"props":6242,"children":6243},{},[6244],{"type":58,"value":6245},"Critical:",{"type":58,"value":6247}," Forge passes the request ",{"type":53,"tag":76,"props":6249,"children":6250},{},[6251],{"type":58,"value":6252},"directly as the first argument",{"type":58,"value":6254}," — it is NOT wrapped under ",{"type":53,"tag":67,"props":6256,"children":6258},{"className":6257},[],[6259],{"type":58,"value":191},{"type":58,"value":6261},". Config form values are at ",{"type":53,"tag":67,"props":6263,"children":6265},{"className":6264},[],[6266],{"type":58,"value":199},{"type":58,"value":6268},", not ",{"type":53,"tag":67,"props":6270,"children":6272},{"className":6271},[],[6273],{"type":58,"value":207},{"type":58,"value":6275},". Getting this wrong causes ",{"type":53,"tag":67,"props":6277,"children":6279},{"className":6278},[],[6280],{"type":58,"value":215},{"type":58,"value":89},{"type":53,"tag":678,"props":6283,"children":6285},{"id":6284},"onconnectionchange",[6286],{"type":58,"value":3758},{"type":53,"tag":714,"props":6288,"children":6290},{"className":1846,"code":6289,"language":1848,"meta":719,"style":719},"const { kvs } = require('@forge\u002Fkvs');\nconst { graph } = require('@forge\u002Fteamwork-graph');\n\nexports.onConnectionChangeHandler = async (request) => {\n  \u002F\u002F request.action, request.connectionId, request.configProperties\n  const { action, connectionId, configProperties } = request;\n\n  if (action === 'DELETED') {\n    \u002F\u002F Atlassian removes Teamwork Graph data automatically on disconnect.\n    \u002F\u002F Only clean up locally stored credentials.\n    await kvs.deleteSecret(connectionId);\n    return { success: true };\n  }\n\n  \u002F\u002F CREATED or UPDATED — persist credentials and ingest data\n  await kvs.setSecret(connectionId, configProperties);\n  await ingestAllData(connectionId, configProperties);\n  return { success: true };\n};\n",[6291],{"type":53,"tag":67,"props":6292,"children":6293},{"__ignoreMap":719},[6294,6346,6397,6404,6448,6456,6508,6515,6558,6566,6574,6612,6643,6651,6658,6666,6711,6747,6775],{"type":53,"tag":725,"props":6295,"children":6296},{"class":727,"line":728},[6297,6301,6305,6310,6314,6318,6322,6326,6330,6334,6338,6342],{"type":53,"tag":725,"props":6298,"children":6299},{"style":1858},[6300],{"type":58,"value":1861},{"type":53,"tag":725,"props":6302,"children":6303},{"style":1439},[6304],{"type":58,"value":1866},{"type":53,"tag":725,"props":6306,"children":6307},{"style":1424},[6308],{"type":58,"value":6309}," kvs ",{"type":53,"tag":725,"props":6311,"children":6312},{"style":1439},[6313],{"type":58,"value":1876},{"type":53,"tag":725,"props":6315,"children":6316},{"style":1439},[6317],{"type":58,"value":1881},{"type":53,"tag":725,"props":6319,"children":6320},{"style":1666},[6321],{"type":58,"value":1886},{"type":53,"tag":725,"props":6323,"children":6324},{"style":1424},[6325],{"type":58,"value":1891},{"type":53,"tag":725,"props":6327,"children":6328},{"style":1439},[6329],{"type":58,"value":1896},{"type":53,"tag":725,"props":6331,"children":6332},{"style":738},[6333],{"type":58,"value":231},{"type":53,"tag":725,"props":6335,"children":6336},{"style":1439},[6337],{"type":58,"value":1896},{"type":53,"tag":725,"props":6339,"children":6340},{"style":1424},[6341],{"type":58,"value":1909},{"type":53,"tag":725,"props":6343,"children":6344},{"style":1439},[6345],{"type":58,"value":1914},{"type":53,"tag":725,"props":6347,"children":6348},{"class":727,"line":1430},[6349,6353,6357,6361,6365,6369,6373,6377,6381,6385,6389,6393],{"type":53,"tag":725,"props":6350,"children":6351},{"style":1858},[6352],{"type":58,"value":1861},{"type":53,"tag":725,"props":6354,"children":6355},{"style":1439},[6356],{"type":58,"value":1866},{"type":53,"tag":725,"props":6358,"children":6359},{"style":1424},[6360],{"type":58,"value":1871},{"type":53,"tag":725,"props":6362,"children":6363},{"style":1439},[6364],{"type":58,"value":1876},{"type":53,"tag":725,"props":6366,"children":6367},{"style":1439},[6368],{"type":58,"value":1881},{"type":53,"tag":725,"props":6370,"children":6371},{"style":1666},[6372],{"type":58,"value":1886},{"type":53,"tag":725,"props":6374,"children":6375},{"style":1424},[6376],{"type":58,"value":1891},{"type":53,"tag":725,"props":6378,"children":6379},{"style":1439},[6380],{"type":58,"value":1896},{"type":53,"tag":725,"props":6382,"children":6383},{"style":738},[6384],{"type":58,"value":295},{"type":53,"tag":725,"props":6386,"children":6387},{"style":1439},[6388],{"type":58,"value":1896},{"type":53,"tag":725,"props":6390,"children":6391},{"style":1424},[6392],{"type":58,"value":1909},{"type":53,"tag":725,"props":6394,"children":6395},{"style":1439},[6396],{"type":58,"value":1914},{"type":53,"tag":725,"props":6398,"children":6399},{"class":727,"line":1464},[6400],{"type":53,"tag":725,"props":6401,"children":6402},{"emptyLinePlaceholder":1920},[6403],{"type":58,"value":1923},{"type":53,"tag":725,"props":6405,"children":6406},{"class":727,"line":1492},[6407,6412,6416,6420,6425,6429,6435,6439,6444],{"type":53,"tag":725,"props":6408,"children":6409},{"style":1439},[6410],{"type":58,"value":6411},"exports.",{"type":53,"tag":725,"props":6413,"children":6414},{"style":1666},[6415],{"type":58,"value":3790},{"type":53,"tag":725,"props":6417,"children":6418},{"style":1439},[6419],{"type":58,"value":1881},{"type":53,"tag":725,"props":6421,"children":6422},{"style":1858},[6423],{"type":58,"value":6424}," async",{"type":53,"tag":725,"props":6426,"children":6427},{"style":1439},[6428],{"type":58,"value":2667},{"type":53,"tag":725,"props":6430,"children":6432},{"style":6431},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic",[6433],{"type":58,"value":6434},"request",{"type":53,"tag":725,"props":6436,"children":6437},{"style":1439},[6438],{"type":58,"value":1909},{"type":53,"tag":725,"props":6440,"children":6441},{"style":1858},[6442],{"type":58,"value":6443}," =>",{"type":53,"tag":725,"props":6445,"children":6446},{"style":1439},[6447],{"type":58,"value":2424},{"type":53,"tag":725,"props":6449,"children":6450},{"class":727,"line":1522},[6451],{"type":53,"tag":725,"props":6452,"children":6453},{"style":1984},[6454],{"type":58,"value":6455},"  \u002F\u002F request.action, request.connectionId, request.configProperties\n",{"type":53,"tag":725,"props":6457,"children":6458},{"class":727,"line":2009},[6459,6464,6468,6473,6477,6482,6486,6491,6495,6499,6504],{"type":53,"tag":725,"props":6460,"children":6461},{"style":1858},[6462],{"type":58,"value":6463},"  const",{"type":53,"tag":725,"props":6465,"children":6466},{"style":1439},[6467],{"type":58,"value":1866},{"type":53,"tag":725,"props":6469,"children":6470},{"style":1424},[6471],{"type":58,"value":6472}," action",{"type":53,"tag":725,"props":6474,"children":6475},{"style":1439},[6476],{"type":58,"value":1981},{"type":53,"tag":725,"props":6478,"children":6479},{"style":1424},[6480],{"type":58,"value":6481}," connectionId",{"type":53,"tag":725,"props":6483,"children":6484},{"style":1439},[6485],{"type":58,"value":1981},{"type":53,"tag":725,"props":6487,"children":6488},{"style":1424},[6489],{"type":58,"value":6490}," configProperties",{"type":53,"tag":725,"props":6492,"children":6493},{"style":1439},[6494],{"type":58,"value":2355},{"type":53,"tag":725,"props":6496,"children":6497},{"style":1439},[6498],{"type":58,"value":1881},{"type":53,"tag":725,"props":6500,"children":6501},{"style":1424},[6502],{"type":58,"value":6503}," request",{"type":53,"tag":725,"props":6505,"children":6506},{"style":1439},[6507],{"type":58,"value":1914},{"type":53,"tag":725,"props":6509,"children":6510},{"class":727,"line":26},[6511],{"type":53,"tag":725,"props":6512,"children":6513},{"emptyLinePlaceholder":1920},[6514],{"type":58,"value":1923},{"type":53,"tag":725,"props":6516,"children":6517},{"class":727,"line":2049},[6518,6523,6527,6532,6537,6541,6546,6550,6554],{"type":53,"tag":725,"props":6519,"children":6520},{"style":1943},[6521],{"type":58,"value":6522},"  if",{"type":53,"tag":725,"props":6524,"children":6525},{"style":1993},[6526],{"type":58,"value":2667},{"type":53,"tag":725,"props":6528,"children":6529},{"style":1424},[6530],{"type":58,"value":6531},"action",{"type":53,"tag":725,"props":6533,"children":6534},{"style":1439},[6535],{"type":58,"value":6536}," ===",{"type":53,"tag":725,"props":6538,"children":6539},{"style":1439},[6540],{"type":58,"value":2032},{"type":53,"tag":725,"props":6542,"children":6543},{"style":738},[6544],{"type":58,"value":6545},"DELETED",{"type":53,"tag":725,"props":6547,"children":6548},{"style":1439},[6549],{"type":58,"value":1896},{"type":53,"tag":725,"props":6551,"children":6552},{"style":1993},[6553],{"type":58,"value":571},{"type":53,"tag":725,"props":6555,"children":6556},{"style":1439},[6557],{"type":58,"value":1968},{"type":53,"tag":725,"props":6559,"children":6560},{"class":727,"line":2084},[6561],{"type":53,"tag":725,"props":6562,"children":6563},{"style":1984},[6564],{"type":58,"value":6565},"    \u002F\u002F Atlassian removes Teamwork Graph data automatically on disconnect.\n",{"type":53,"tag":725,"props":6567,"children":6568},{"class":727,"line":2107},[6569],{"type":53,"tag":725,"props":6570,"children":6571},{"style":1984},[6572],{"type":58,"value":6573},"    \u002F\u002F Only clean up locally stored credentials.\n",{"type":53,"tag":725,"props":6575,"children":6576},{"class":727,"line":2137},[6577,6582,6587,6591,6596,6600,6604,6608],{"type":53,"tag":725,"props":6578,"children":6579},{"style":1943},[6580],{"type":58,"value":6581},"    await",{"type":53,"tag":725,"props":6583,"children":6584},{"style":1424},[6585],{"type":58,"value":6586}," kvs",{"type":53,"tag":725,"props":6588,"children":6589},{"style":1439},[6590],{"type":58,"value":89},{"type":53,"tag":725,"props":6592,"children":6593},{"style":1666},[6594],{"type":58,"value":6595},"deleteSecret",{"type":53,"tag":725,"props":6597,"children":6598},{"style":1993},[6599],{"type":58,"value":1891},{"type":53,"tag":725,"props":6601,"children":6602},{"style":1424},[6603],{"type":58,"value":2791},{"type":53,"tag":725,"props":6605,"children":6606},{"style":1993},[6607],{"type":58,"value":1909},{"type":53,"tag":725,"props":6609,"children":6610},{"style":1439},[6611],{"type":58,"value":1914},{"type":53,"tag":725,"props":6613,"children":6614},{"class":727,"line":2167},[6615,6620,6624,6629,6633,6638],{"type":53,"tag":725,"props":6616,"children":6617},{"style":1943},[6618],{"type":58,"value":6619},"    return",{"type":53,"tag":725,"props":6621,"children":6622},{"style":1439},[6623],{"type":58,"value":1866},{"type":53,"tag":725,"props":6625,"children":6626},{"style":1993},[6627],{"type":58,"value":6628}," success",{"type":53,"tag":725,"props":6630,"children":6631},{"style":1439},[6632],{"type":58,"value":2001},{"type":53,"tag":725,"props":6634,"children":6635},{"style":5995},[6636],{"type":58,"value":6637}," true",{"type":53,"tag":725,"props":6639,"children":6640},{"style":1439},[6641],{"type":58,"value":6642}," };\n",{"type":53,"tag":725,"props":6644,"children":6645},{"class":727,"line":2202},[6646],{"type":53,"tag":725,"props":6647,"children":6648},{"style":1439},[6649],{"type":58,"value":6650},"  }\n",{"type":53,"tag":725,"props":6652,"children":6653},{"class":727,"line":22},[6654],{"type":53,"tag":725,"props":6655,"children":6656},{"emptyLinePlaceholder":1920},[6657],{"type":58,"value":1923},{"type":53,"tag":725,"props":6659,"children":6660},{"class":727,"line":2240},[6661],{"type":53,"tag":725,"props":6662,"children":6663},{"style":1984},[6664],{"type":58,"value":6665},"  \u002F\u002F CREATED or UPDATED — persist credentials and ingest data\n",{"type":53,"tag":725,"props":6667,"children":6668},{"class":727,"line":2249},[6669,6674,6678,6682,6687,6691,6695,6699,6703,6707],{"type":53,"tag":725,"props":6670,"children":6671},{"style":1943},[6672],{"type":58,"value":6673},"  await",{"type":53,"tag":725,"props":6675,"children":6676},{"style":1424},[6677],{"type":58,"value":6586},{"type":53,"tag":725,"props":6679,"children":6680},{"style":1439},[6681],{"type":58,"value":89},{"type":53,"tag":725,"props":6683,"children":6684},{"style":1666},[6685],{"type":58,"value":6686},"setSecret",{"type":53,"tag":725,"props":6688,"children":6689},{"style":1993},[6690],{"type":58,"value":1891},{"type":53,"tag":725,"props":6692,"children":6693},{"style":1424},[6694],{"type":58,"value":2791},{"type":53,"tag":725,"props":6696,"children":6697},{"style":1439},[6698],{"type":58,"value":1981},{"type":53,"tag":725,"props":6700,"children":6701},{"style":1424},[6702],{"type":58,"value":6490},{"type":53,"tag":725,"props":6704,"children":6705},{"style":1993},[6706],{"type":58,"value":1909},{"type":53,"tag":725,"props":6708,"children":6709},{"style":1439},[6710],{"type":58,"value":1914},{"type":53,"tag":725,"props":6712,"children":6713},{"class":727,"line":2258},[6714,6718,6723,6727,6731,6735,6739,6743],{"type":53,"tag":725,"props":6715,"children":6716},{"style":1943},[6717],{"type":58,"value":6673},{"type":53,"tag":725,"props":6719,"children":6720},{"style":1666},[6721],{"type":58,"value":6722}," ingestAllData",{"type":53,"tag":725,"props":6724,"children":6725},{"style":1993},[6726],{"type":58,"value":1891},{"type":53,"tag":725,"props":6728,"children":6729},{"style":1424},[6730],{"type":58,"value":2791},{"type":53,"tag":725,"props":6732,"children":6733},{"style":1439},[6734],{"type":58,"value":1981},{"type":53,"tag":725,"props":6736,"children":6737},{"style":1424},[6738],{"type":58,"value":6490},{"type":53,"tag":725,"props":6740,"children":6741},{"style":1993},[6742],{"type":58,"value":1909},{"type":53,"tag":725,"props":6744,"children":6745},{"style":1439},[6746],{"type":58,"value":1914},{"type":53,"tag":725,"props":6748,"children":6749},{"class":727,"line":2267},[6750,6755,6759,6763,6767,6771],{"type":53,"tag":725,"props":6751,"children":6752},{"style":1943},[6753],{"type":58,"value":6754},"  return",{"type":53,"tag":725,"props":6756,"children":6757},{"style":1439},[6758],{"type":58,"value":1866},{"type":53,"tag":725,"props":6760,"children":6761},{"style":1993},[6762],{"type":58,"value":6628},{"type":53,"tag":725,"props":6764,"children":6765},{"style":1439},[6766],{"type":58,"value":2001},{"type":53,"tag":725,"props":6768,"children":6769},{"style":5995},[6770],{"type":58,"value":6637},{"type":53,"tag":725,"props":6772,"children":6773},{"style":1439},[6774],{"type":58,"value":6642},{"type":53,"tag":725,"props":6776,"children":6777},{"class":727,"line":2289},[6778],{"type":53,"tag":725,"props":6779,"children":6780},{"style":1439},[6781],{"type":58,"value":6782},"};\n",{"type":53,"tag":678,"props":6784,"children":6786},{"id":6785},"validateconnection",[6787],{"type":58,"value":4228},{"type":53,"tag":714,"props":6789,"children":6791},{"className":1846,"code":6790,"language":1848,"meta":719,"style":719},"const { fetch } = require('@forge\u002Fapi');\n\nexports.validateConnectionHandler = async (request) => {\n  \u002F\u002F request.configProperties — NOT event.payload.config\n  const { configProperties } = request;\n\n  \u002F\u002F Return { success: false, message } to reject — do NOT throw an Error.\n  \u002F\u002F Return { success: true } to accept.\n  const response = await fetch(`${configProperties['apiUrl']}\u002Fhealth`);\n  if (!response.ok) {\n    return { success: false, message: 'Invalid API credentials. Please check your settings.' };\n  }\n  return { success: true, message: 'Connection validated successfully.' };\n};\n",[6792],{"type":53,"tag":67,"props":6793,"children":6794},{"__ignoreMap":719},[6795,6847,6854,6893,6901,6932,6939,6947,6955,7033,7070,7124,7131,7183],{"type":53,"tag":725,"props":6796,"children":6797},{"class":727,"line":728},[6798,6802,6806,6811,6815,6819,6823,6827,6831,6835,6839,6843],{"type":53,"tag":725,"props":6799,"children":6800},{"style":1858},[6801],{"type":58,"value":1861},{"type":53,"tag":725,"props":6803,"children":6804},{"style":1439},[6805],{"type":58,"value":1866},{"type":53,"tag":725,"props":6807,"children":6808},{"style":1424},[6809],{"type":58,"value":6810}," fetch ",{"type":53,"tag":725,"props":6812,"children":6813},{"style":1439},[6814],{"type":58,"value":1876},{"type":53,"tag":725,"props":6816,"children":6817},{"style":1439},[6818],{"type":58,"value":1881},{"type":53,"tag":725,"props":6820,"children":6821},{"style":1666},[6822],{"type":58,"value":1886},{"type":53,"tag":725,"props":6824,"children":6825},{"style":1424},[6826],{"type":58,"value":1891},{"type":53,"tag":725,"props":6828,"children":6829},{"style":1439},[6830],{"type":58,"value":1896},{"type":53,"tag":725,"props":6832,"children":6833},{"style":738},[6834],{"type":58,"value":1804},{"type":53,"tag":725,"props":6836,"children":6837},{"style":1439},[6838],{"type":58,"value":1896},{"type":53,"tag":725,"props":6840,"children":6841},{"style":1424},[6842],{"type":58,"value":1909},{"type":53,"tag":725,"props":6844,"children":6845},{"style":1439},[6846],{"type":58,"value":1914},{"type":53,"tag":725,"props":6848,"children":6849},{"class":727,"line":1430},[6850],{"type":53,"tag":725,"props":6851,"children":6852},{"emptyLinePlaceholder":1920},[6853],{"type":58,"value":1923},{"type":53,"tag":725,"props":6855,"children":6856},{"class":727,"line":1464},[6857,6861,6865,6869,6873,6877,6881,6885,6889],{"type":53,"tag":725,"props":6858,"children":6859},{"style":1439},[6860],{"type":58,"value":6411},{"type":53,"tag":725,"props":6862,"children":6863},{"style":1666},[6864],{"type":58,"value":333},{"type":53,"tag":725,"props":6866,"children":6867},{"style":1439},[6868],{"type":58,"value":1881},{"type":53,"tag":725,"props":6870,"children":6871},{"style":1858},[6872],{"type":58,"value":6424},{"type":53,"tag":725,"props":6874,"children":6875},{"style":1439},[6876],{"type":58,"value":2667},{"type":53,"tag":725,"props":6878,"children":6879},{"style":6431},[6880],{"type":58,"value":6434},{"type":53,"tag":725,"props":6882,"children":6883},{"style":1439},[6884],{"type":58,"value":1909},{"type":53,"tag":725,"props":6886,"children":6887},{"style":1858},[6888],{"type":58,"value":6443},{"type":53,"tag":725,"props":6890,"children":6891},{"style":1439},[6892],{"type":58,"value":2424},{"type":53,"tag":725,"props":6894,"children":6895},{"class":727,"line":1492},[6896],{"type":53,"tag":725,"props":6897,"children":6898},{"style":1984},[6899],{"type":58,"value":6900},"  \u002F\u002F request.configProperties — NOT event.payload.config\n",{"type":53,"tag":725,"props":6902,"children":6903},{"class":727,"line":1522},[6904,6908,6912,6916,6920,6924,6928],{"type":53,"tag":725,"props":6905,"children":6906},{"style":1858},[6907],{"type":58,"value":6463},{"type":53,"tag":725,"props":6909,"children":6910},{"style":1439},[6911],{"type":58,"value":1866},{"type":53,"tag":725,"props":6913,"children":6914},{"style":1424},[6915],{"type":58,"value":6490},{"type":53,"tag":725,"props":6917,"children":6918},{"style":1439},[6919],{"type":58,"value":2355},{"type":53,"tag":725,"props":6921,"children":6922},{"style":1439},[6923],{"type":58,"value":1881},{"type":53,"tag":725,"props":6925,"children":6926},{"style":1424},[6927],{"type":58,"value":6503},{"type":53,"tag":725,"props":6929,"children":6930},{"style":1439},[6931],{"type":58,"value":1914},{"type":53,"tag":725,"props":6933,"children":6934},{"class":727,"line":2009},[6935],{"type":53,"tag":725,"props":6936,"children":6937},{"emptyLinePlaceholder":1920},[6938],{"type":58,"value":1923},{"type":53,"tag":725,"props":6940,"children":6941},{"class":727,"line":26},[6942],{"type":53,"tag":725,"props":6943,"children":6944},{"style":1984},[6945],{"type":58,"value":6946},"  \u002F\u002F Return { success: false, message } to reject — do NOT throw an Error.\n",{"type":53,"tag":725,"props":6948,"children":6949},{"class":727,"line":2049},[6950],{"type":53,"tag":725,"props":6951,"children":6952},{"style":1984},[6953],{"type":58,"value":6954},"  \u002F\u002F Return { success: true } to accept.\n",{"type":53,"tag":725,"props":6956,"children":6957},{"class":727,"line":2084},[6958,6962,6967,6971,6975,6980,6984,6989,6994,6998,7003,7007,7011,7015,7020,7025,7029],{"type":53,"tag":725,"props":6959,"children":6960},{"style":1858},[6961],{"type":58,"value":6463},{"type":53,"tag":725,"props":6963,"children":6964},{"style":1424},[6965],{"type":58,"value":6966}," response",{"type":53,"tag":725,"props":6968,"children":6969},{"style":1439},[6970],{"type":58,"value":1881},{"type":53,"tag":725,"props":6972,"children":6973},{"style":1943},[6974],{"type":58,"value":1946},{"type":53,"tag":725,"props":6976,"children":6977},{"style":1666},[6978],{"type":58,"value":6979}," fetch",{"type":53,"tag":725,"props":6981,"children":6982},{"style":1993},[6983],{"type":58,"value":1891},{"type":53,"tag":725,"props":6985,"children":6986},{"style":1439},[6987],{"type":58,"value":6988},"`${",{"type":53,"tag":725,"props":6990,"children":6991},{"style":1424},[6992],{"type":58,"value":6993},"configProperties[",{"type":53,"tag":725,"props":6995,"children":6996},{"style":1439},[6997],{"type":58,"value":1896},{"type":53,"tag":725,"props":6999,"children":7000},{"style":738},[7001],{"type":58,"value":7002},"apiUrl",{"type":53,"tag":725,"props":7004,"children":7005},{"style":1439},[7006],{"type":58,"value":1896},{"type":53,"tag":725,"props":7008,"children":7009},{"style":1424},[7010],{"type":58,"value":2360},{"type":53,"tag":725,"props":7012,"children":7013},{"style":1439},[7014],{"type":58,"value":1876},{"type":53,"tag":725,"props":7016,"children":7017},{"style":738},[7018],{"type":58,"value":7019},"\u002Fhealth",{"type":53,"tag":725,"props":7021,"children":7022},{"style":1439},[7023],{"type":58,"value":7024},"`",{"type":53,"tag":725,"props":7026,"children":7027},{"style":1993},[7028],{"type":58,"value":1909},{"type":53,"tag":725,"props":7030,"children":7031},{"style":1439},[7032],{"type":58,"value":1914},{"type":53,"tag":725,"props":7034,"children":7035},{"class":727,"line":2107},[7036,7040,7044,7048,7053,7057,7062,7066],{"type":53,"tag":725,"props":7037,"children":7038},{"style":1943},[7039],{"type":58,"value":6522},{"type":53,"tag":725,"props":7041,"children":7042},{"style":1993},[7043],{"type":58,"value":2667},{"type":53,"tag":725,"props":7045,"children":7046},{"style":1439},[7047],{"type":58,"value":2672},{"type":53,"tag":725,"props":7049,"children":7050},{"style":1424},[7051],{"type":58,"value":7052},"response",{"type":53,"tag":725,"props":7054,"children":7055},{"style":1439},[7056],{"type":58,"value":89},{"type":53,"tag":725,"props":7058,"children":7059},{"style":1424},[7060],{"type":58,"value":7061},"ok",{"type":53,"tag":725,"props":7063,"children":7064},{"style":1993},[7065],{"type":58,"value":571},{"type":53,"tag":725,"props":7067,"children":7068},{"style":1439},[7069],{"type":58,"value":1968},{"type":53,"tag":725,"props":7071,"children":7072},{"class":727,"line":2137},[7073,7077,7081,7085,7089,7094,7098,7103,7107,7111,7116,7120],{"type":53,"tag":725,"props":7074,"children":7075},{"style":1943},[7076],{"type":58,"value":6619},{"type":53,"tag":725,"props":7078,"children":7079},{"style":1439},[7080],{"type":58,"value":1866},{"type":53,"tag":725,"props":7082,"children":7083},{"style":1993},[7084],{"type":58,"value":6628},{"type":53,"tag":725,"props":7086,"children":7087},{"style":1439},[7088],{"type":58,"value":2001},{"type":53,"tag":725,"props":7090,"children":7091},{"style":5995},[7092],{"type":58,"value":7093}," false",{"type":53,"tag":725,"props":7095,"children":7096},{"style":1439},[7097],{"type":58,"value":1981},{"type":53,"tag":725,"props":7099,"children":7100},{"style":1993},[7101],{"type":58,"value":7102}," message",{"type":53,"tag":725,"props":7104,"children":7105},{"style":1439},[7106],{"type":58,"value":2001},{"type":53,"tag":725,"props":7108,"children":7109},{"style":1439},[7110],{"type":58,"value":2032},{"type":53,"tag":725,"props":7112,"children":7113},{"style":738},[7114],{"type":58,"value":7115},"Invalid API credentials. Please check your settings.",{"type":53,"tag":725,"props":7117,"children":7118},{"style":1439},[7119],{"type":58,"value":1896},{"type":53,"tag":725,"props":7121,"children":7122},{"style":1439},[7123],{"type":58,"value":6642},{"type":53,"tag":725,"props":7125,"children":7126},{"class":727,"line":2167},[7127],{"type":53,"tag":725,"props":7128,"children":7129},{"style":1439},[7130],{"type":58,"value":6650},{"type":53,"tag":725,"props":7132,"children":7133},{"class":727,"line":2202},[7134,7138,7142,7146,7150,7154,7158,7162,7166,7170,7175,7179],{"type":53,"tag":725,"props":7135,"children":7136},{"style":1943},[7137],{"type":58,"value":6754},{"type":53,"tag":725,"props":7139,"children":7140},{"style":1439},[7141],{"type":58,"value":1866},{"type":53,"tag":725,"props":7143,"children":7144},{"style":1993},[7145],{"type":58,"value":6628},{"type":53,"tag":725,"props":7147,"children":7148},{"style":1439},[7149],{"type":58,"value":2001},{"type":53,"tag":725,"props":7151,"children":7152},{"style":5995},[7153],{"type":58,"value":6637},{"type":53,"tag":725,"props":7155,"children":7156},{"style":1439},[7157],{"type":58,"value":1981},{"type":53,"tag":725,"props":7159,"children":7160},{"style":1993},[7161],{"type":58,"value":7102},{"type":53,"tag":725,"props":7163,"children":7164},{"style":1439},[7165],{"type":58,"value":2001},{"type":53,"tag":725,"props":7167,"children":7168},{"style":1439},[7169],{"type":58,"value":2032},{"type":53,"tag":725,"props":7171,"children":7172},{"style":738},[7173],{"type":58,"value":7174},"Connection validated successfully.",{"type":53,"tag":725,"props":7176,"children":7177},{"style":1439},[7178],{"type":58,"value":1896},{"type":53,"tag":725,"props":7180,"children":7181},{"style":1439},[7182],{"type":58,"value":6642},{"type":53,"tag":725,"props":7184,"children":7185},{"class":727,"line":22},[7186],{"type":53,"tag":725,"props":7187,"children":7188},{"style":1439},[7189],{"type":58,"value":6782},{"type":53,"tag":678,"props":7191,"children":7193},{"id":7192},"refreshingestion-scheduled-trigger",[7194],{"type":58,"value":7195},"refreshIngestion (scheduled trigger)",{"type":53,"tag":714,"props":7197,"children":7199},{"className":1846,"code":7198,"language":1848,"meta":719,"style":719},"exports.refreshIngestionHandler = async () => {\n  const activeConnections = await kvs.get('active-connections') ?? [];\n  for (const connectionId of activeConnections) {\n    const config = await kvs.getSecret(connectionId);\n    if (config) await ingestAllData(connectionId, config);\n  }\n};\n",[7200],{"type":53,"tag":67,"props":7201,"children":7202},{"__ignoreMap":719},[7203,7235,7303,7340,7390,7444,7451],{"type":53,"tag":725,"props":7204,"children":7205},{"class":727,"line":728},[7206,7210,7214,7218,7222,7227,7231],{"type":53,"tag":725,"props":7207,"children":7208},{"style":1439},[7209],{"type":58,"value":6411},{"type":53,"tag":725,"props":7211,"children":7212},{"style":1666},[7213],{"type":58,"value":4682},{"type":53,"tag":725,"props":7215,"children":7216},{"style":1439},[7217],{"type":58,"value":1881},{"type":53,"tag":725,"props":7219,"children":7220},{"style":1858},[7221],{"type":58,"value":6424},{"type":53,"tag":725,"props":7223,"children":7224},{"style":1439},[7225],{"type":58,"value":7226}," ()",{"type":53,"tag":725,"props":7228,"children":7229},{"style":1858},[7230],{"type":58,"value":6443},{"type":53,"tag":725,"props":7232,"children":7233},{"style":1439},[7234],{"type":58,"value":2424},{"type":53,"tag":725,"props":7236,"children":7237},{"class":727,"line":1430},[7238,7242,7247,7251,7255,7259,7263,7268,7272,7276,7281,7285,7289,7294,7299],{"type":53,"tag":725,"props":7239,"children":7240},{"style":1858},[7241],{"type":58,"value":6463},{"type":53,"tag":725,"props":7243,"children":7244},{"style":1424},[7245],{"type":58,"value":7246}," activeConnections",{"type":53,"tag":725,"props":7248,"children":7249},{"style":1439},[7250],{"type":58,"value":1881},{"type":53,"tag":725,"props":7252,"children":7253},{"style":1943},[7254],{"type":58,"value":1946},{"type":53,"tag":725,"props":7256,"children":7257},{"style":1424},[7258],{"type":58,"value":6586},{"type":53,"tag":725,"props":7260,"children":7261},{"style":1439},[7262],{"type":58,"value":89},{"type":53,"tag":725,"props":7264,"children":7265},{"style":1666},[7266],{"type":58,"value":7267},"get",{"type":53,"tag":725,"props":7269,"children":7270},{"style":1993},[7271],{"type":58,"value":1891},{"type":53,"tag":725,"props":7273,"children":7274},{"style":1439},[7275],{"type":58,"value":1896},{"type":53,"tag":725,"props":7277,"children":7278},{"style":738},[7279],{"type":58,"value":7280},"active-connections",{"type":53,"tag":725,"props":7282,"children":7283},{"style":1439},[7284],{"type":58,"value":1896},{"type":53,"tag":725,"props":7286,"children":7287},{"style":1993},[7288],{"type":58,"value":571},{"type":53,"tag":725,"props":7290,"children":7291},{"style":1439},[7292],{"type":58,"value":7293},"??",{"type":53,"tag":725,"props":7295,"children":7296},{"style":1993},[7297],{"type":58,"value":7298}," []",{"type":53,"tag":725,"props":7300,"children":7301},{"style":1439},[7302],{"type":58,"value":1914},{"type":53,"tag":725,"props":7304,"children":7305},{"class":727,"line":1464},[7306,7311,7315,7319,7323,7328,7332,7336],{"type":53,"tag":725,"props":7307,"children":7308},{"style":1943},[7309],{"type":58,"value":7310},"  for",{"type":53,"tag":725,"props":7312,"children":7313},{"style":1993},[7314],{"type":58,"value":2667},{"type":53,"tag":725,"props":7316,"children":7317},{"style":1858},[7318],{"type":58,"value":1861},{"type":53,"tag":725,"props":7320,"children":7321},{"style":1424},[7322],{"type":58,"value":6481},{"type":53,"tag":725,"props":7324,"children":7325},{"style":1439},[7326],{"type":58,"value":7327}," of",{"type":53,"tag":725,"props":7329,"children":7330},{"style":1424},[7331],{"type":58,"value":7246},{"type":53,"tag":725,"props":7333,"children":7334},{"style":1993},[7335],{"type":58,"value":571},{"type":53,"tag":725,"props":7337,"children":7338},{"style":1439},[7339],{"type":58,"value":1968},{"type":53,"tag":725,"props":7341,"children":7342},{"class":727,"line":1492},[7343,7348,7353,7357,7361,7365,7369,7374,7378,7382,7386],{"type":53,"tag":725,"props":7344,"children":7345},{"style":1858},[7346],{"type":58,"value":7347},"    const",{"type":53,"tag":725,"props":7349,"children":7350},{"style":1424},[7351],{"type":58,"value":7352}," config",{"type":53,"tag":725,"props":7354,"children":7355},{"style":1439},[7356],{"type":58,"value":1881},{"type":53,"tag":725,"props":7358,"children":7359},{"style":1943},[7360],{"type":58,"value":1946},{"type":53,"tag":725,"props":7362,"children":7363},{"style":1424},[7364],{"type":58,"value":6586},{"type":53,"tag":725,"props":7366,"children":7367},{"style":1439},[7368],{"type":58,"value":89},{"type":53,"tag":725,"props":7370,"children":7371},{"style":1666},[7372],{"type":58,"value":7373},"getSecret",{"type":53,"tag":725,"props":7375,"children":7376},{"style":1993},[7377],{"type":58,"value":1891},{"type":53,"tag":725,"props":7379,"children":7380},{"style":1424},[7381],{"type":58,"value":2791},{"type":53,"tag":725,"props":7383,"children":7384},{"style":1993},[7385],{"type":58,"value":1909},{"type":53,"tag":725,"props":7387,"children":7388},{"style":1439},[7389],{"type":58,"value":1914},{"type":53,"tag":725,"props":7391,"children":7392},{"class":727,"line":1522},[7393,7398,7402,7407,7411,7416,7420,7424,7428,7432,7436,7440],{"type":53,"tag":725,"props":7394,"children":7395},{"style":1943},[7396],{"type":58,"value":7397},"    if",{"type":53,"tag":725,"props":7399,"children":7400},{"style":1993},[7401],{"type":58,"value":2667},{"type":53,"tag":725,"props":7403,"children":7404},{"style":1424},[7405],{"type":58,"value":7406},"config",{"type":53,"tag":725,"props":7408,"children":7409},{"style":1993},[7410],{"type":58,"value":571},{"type":53,"tag":725,"props":7412,"children":7413},{"style":1943},[7414],{"type":58,"value":7415},"await",{"type":53,"tag":725,"props":7417,"children":7418},{"style":1666},[7419],{"type":58,"value":6722},{"type":53,"tag":725,"props":7421,"children":7422},{"style":1993},[7423],{"type":58,"value":1891},{"type":53,"tag":725,"props":7425,"children":7426},{"style":1424},[7427],{"type":58,"value":2791},{"type":53,"tag":725,"props":7429,"children":7430},{"style":1439},[7431],{"type":58,"value":1981},{"type":53,"tag":725,"props":7433,"children":7434},{"style":1424},[7435],{"type":58,"value":7352},{"type":53,"tag":725,"props":7437,"children":7438},{"style":1993},[7439],{"type":58,"value":1909},{"type":53,"tag":725,"props":7441,"children":7442},{"style":1439},[7443],{"type":58,"value":1914},{"type":53,"tag":725,"props":7445,"children":7446},{"class":727,"line":2009},[7447],{"type":53,"tag":725,"props":7448,"children":7449},{"style":1439},[7450],{"type":58,"value":6650},{"type":53,"tag":725,"props":7452,"children":7453},{"class":727,"line":26},[7454],{"type":53,"tag":725,"props":7455,"children":7456},{"style":1439},[7457],{"type":58,"value":6782},{"type":53,"tag":668,"props":7459,"children":7460},{},[],{"type":53,"tag":91,"props":7462,"children":7464},{"id":7463},"object-types",[7465],{"type":58,"value":7466},"Object Types",{"type":53,"tag":61,"props":7468,"children":7469},{},[7470,7472,7477],{"type":58,"value":7471},"Objects in ",{"type":53,"tag":76,"props":7473,"children":7474},{},[7475],{"type":58,"value":7476},"bold",{"type":58,"value":7478}," are indexed in Rovo Search and Rovo Chat.",{"type":53,"tag":608,"props":7480,"children":7481},{},[7482,7503],{"type":53,"tag":612,"props":7483,"children":7484},{},[7485],{"type":53,"tag":616,"props":7486,"children":7487},{},[7488,7493,7498],{"type":53,"tag":620,"props":7489,"children":7490},{},[7491],{"type":58,"value":7492},"Object Type",{"type":53,"tag":620,"props":7494,"children":7495},{},[7496],{"type":58,"value":7497},"Indexed in Rovo",{"type":53,"tag":620,"props":7499,"children":7500},{},[7501],{"type":58,"value":7502},"Best for",{"type":53,"tag":631,"props":7504,"children":7505},{},[7506,7527,7547,7567,7587,7607,7627,7647,7667,7687,7708,7728,7748,7768,7788,7808,7829,7849],{"type":53,"tag":616,"props":7507,"children":7508},{},[7509,7517,7522],{"type":53,"tag":638,"props":7510,"children":7511},{},[7512],{"type":53,"tag":67,"props":7513,"children":7515},{"className":7514},[],[7516],{"type":58,"value":846},{"type":53,"tag":638,"props":7518,"children":7519},{},[7520],{"type":58,"value":7521},"✅",{"type":53,"tag":638,"props":7523,"children":7524},{},[7525],{"type":58,"value":7526},"Files, pages, wiki articles, reports",{"type":53,"tag":616,"props":7528,"children":7529},{},[7530,7538,7542],{"type":53,"tag":638,"props":7531,"children":7532},{},[7533],{"type":53,"tag":67,"props":7534,"children":7536},{"className":7535},[],[7537],{"type":58,"value":913},{"type":53,"tag":638,"props":7539,"children":7540},{},[7541],{"type":58,"value":7521},{"type":53,"tag":638,"props":7543,"children":7544},{},[7545],{"type":58,"value":7546},"Chat messages, emails, comments",{"type":53,"tag":616,"props":7548,"children":7549},{},[7550,7558,7562],{"type":53,"tag":638,"props":7551,"children":7552},{},[7553],{"type":53,"tag":67,"props":7554,"children":7556},{"className":7555},[],[7557],{"type":58,"value":902},{"type":53,"tag":638,"props":7559,"children":7560},{},[7561],{"type":58,"value":7521},{"type":53,"tag":638,"props":7563,"children":7564},{},[7565],{"type":58,"value":7566},"Tasks, tickets, issues",{"type":53,"tag":616,"props":7568,"children":7569},{},[7570,7578,7582],{"type":53,"tag":638,"props":7571,"children":7572},{},[7573],{"type":53,"tag":67,"props":7574,"children":7576},{"className":7575},[],[7577],{"type":58,"value":931},{"type":53,"tag":638,"props":7579,"children":7580},{},[7581],{"type":58,"value":7521},{"type":53,"tag":638,"props":7583,"children":7584},{},[7585],{"type":58,"value":7586},"Projects, workspaces",{"type":53,"tag":616,"props":7588,"children":7589},{},[7590,7598,7602],{"type":53,"tag":638,"props":7591,"children":7592},{},[7593],{"type":53,"tag":67,"props":7594,"children":7596},{"className":7595},[],[7597],{"type":58,"value":1030},{"type":53,"tag":638,"props":7599,"children":7600},{},[7601],{"type":58,"value":7521},{"type":53,"tag":638,"props":7603,"children":7604},{},[7605],{"type":58,"value":7606},"Team spaces, org units",{"type":53,"tag":616,"props":7608,"children":7609},{},[7610,7618,7622],{"type":53,"tag":638,"props":7611,"children":7612},{},[7613],{"type":53,"tag":67,"props":7614,"children":7616},{"className":7615},[],[7617],{"type":58,"value":975},{"type":53,"tag":638,"props":7619,"children":7620},{},[7621],{"type":58,"value":7521},{"type":53,"tag":638,"props":7623,"children":7624},{},[7625],{"type":58,"value":7626},"Design files (Figma, etc.)",{"type":53,"tag":616,"props":7628,"children":7629},{},[7630,7638,7642],{"type":53,"tag":638,"props":7631,"children":7632},{},[7633],{"type":53,"tag":67,"props":7634,"children":7636},{"className":7635},[],[7637],{"type":58,"value":942},{"type":53,"tag":638,"props":7639,"children":7640},{},[7641],{"type":58,"value":7521},{"type":53,"tag":638,"props":7643,"children":7644},{},[7645],{"type":58,"value":7646},"Code repositories",{"type":53,"tag":616,"props":7648,"children":7649},{},[7650,7658,7662],{"type":53,"tag":638,"props":7651,"children":7652},{},[7653],{"type":53,"tag":67,"props":7654,"children":7656},{"className":7655},[],[7657],{"type":58,"value":953},{"type":53,"tag":638,"props":7659,"children":7660},{},[7661],{"type":58,"value":7521},{"type":53,"tag":638,"props":7663,"children":7664},{},[7665],{"type":58,"value":7666},"PRs, merge requests",{"type":53,"tag":616,"props":7668,"children":7669},{},[7670,7678,7682],{"type":53,"tag":638,"props":7671,"children":7672},{},[7673],{"type":53,"tag":67,"props":7674,"children":7676},{"className":7675},[],[7677],{"type":58,"value":964},{"type":53,"tag":638,"props":7679,"children":7680},{},[7681],{"type":58,"value":7521},{"type":53,"tag":638,"props":7683,"children":7684},{},[7685],{"type":58,"value":7686},"Git commits",{"type":53,"tag":616,"props":7688,"children":7689},{},[7690,7699,7703],{"type":53,"tag":638,"props":7691,"children":7692},{},[7693],{"type":53,"tag":67,"props":7694,"children":7696},{"className":7695},[],[7697],{"type":58,"value":7698},"atlassian:branch",{"type":53,"tag":638,"props":7700,"children":7701},{},[7702],{"type":58,"value":7521},{"type":53,"tag":638,"props":7704,"children":7705},{},[7706],{"type":58,"value":7707},"Git branches",{"type":53,"tag":616,"props":7709,"children":7710},{},[7711,7719,7723],{"type":53,"tag":638,"props":7712,"children":7713},{},[7714],{"type":53,"tag":67,"props":7715,"children":7717},{"className":7716},[],[7718],{"type":58,"value":1008},{"type":53,"tag":638,"props":7720,"children":7721},{},[7722],{"type":58,"value":7521},{"type":53,"tag":638,"props":7724,"children":7725},{},[7726],{"type":58,"value":7727},"Threads, channels",{"type":53,"tag":616,"props":7729,"children":7730},{},[7731,7739,7743],{"type":53,"tag":638,"props":7732,"children":7733},{},[7734],{"type":53,"tag":67,"props":7735,"children":7737},{"className":7736},[],[7738],{"type":58,"value":986},{"type":53,"tag":638,"props":7740,"children":7741},{},[7742],{"type":58,"value":7521},{"type":53,"tag":638,"props":7744,"children":7745},{},[7746],{"type":58,"value":7747},"Video recordings",{"type":53,"tag":616,"props":7749,"children":7750},{},[7751,7759,7763],{"type":53,"tag":638,"props":7752,"children":7753},{},[7754],{"type":53,"tag":67,"props":7755,"children":7757},{"className":7756},[],[7758],{"type":58,"value":997},{"type":53,"tag":638,"props":7760,"children":7761},{},[7762],{"type":58,"value":7521},{"type":53,"tag":638,"props":7764,"children":7765},{},[7766],{"type":58,"value":7767},"Meetings, events",{"type":53,"tag":616,"props":7769,"children":7770},{},[7771,7779,7783],{"type":53,"tag":638,"props":7772,"children":7773},{},[7774],{"type":53,"tag":67,"props":7775,"children":7777},{"className":7776},[],[7778],{"type":58,"value":920},{"type":53,"tag":638,"props":7780,"children":7781},{},[7782],{"type":58,"value":7521},{"type":53,"tag":638,"props":7784,"children":7785},{},[7786],{"type":58,"value":7787},"Review comments",{"type":53,"tag":616,"props":7789,"children":7790},{},[7791,7799,7803],{"type":53,"tag":638,"props":7792,"children":7793},{},[7794],{"type":53,"tag":67,"props":7795,"children":7797},{"className":7796},[],[7798],{"type":58,"value":1019},{"type":53,"tag":638,"props":7800,"children":7801},{},[7802],{"type":58,"value":7521},{"type":53,"tag":638,"props":7804,"children":7805},{},[7806],{"type":58,"value":7807},"Customer accounts, orgs",{"type":53,"tag":616,"props":7809,"children":7810},{},[7811,7819,7824],{"type":53,"tag":638,"props":7812,"children":7813},{},[7814],{"type":53,"tag":67,"props":7815,"children":7817},{"className":7816},[],[7818],{"type":58,"value":1342},{"type":53,"tag":638,"props":7820,"children":7821},{},[7822],{"type":58,"value":7823},"❌",{"type":53,"tag":638,"props":7825,"children":7826},{},[7827],{"type":58,"value":7828},"CI\u002FCD builds",{"type":53,"tag":616,"props":7830,"children":7831},{},[7832,7840,7844],{"type":53,"tag":638,"props":7833,"children":7834},{},[7835],{"type":53,"tag":67,"props":7836,"children":7838},{"className":7837},[],[7839],{"type":58,"value":1349},{"type":53,"tag":638,"props":7841,"children":7842},{},[7843],{"type":58,"value":7823},{"type":53,"tag":638,"props":7845,"children":7846},{},[7847],{"type":58,"value":7848},"Deployments",{"type":53,"tag":616,"props":7850,"children":7851},{},[7852,7860,7864],{"type":53,"tag":638,"props":7853,"children":7854},{},[7855],{"type":53,"tag":67,"props":7856,"children":7858},{"className":7857},[],[7859],{"type":58,"value":1356},{"type":53,"tag":638,"props":7861,"children":7862},{},[7863],{"type":58,"value":7823},{"type":53,"tag":638,"props":7865,"children":7866},{},[7867],{"type":58,"value":7868},"Test cases",{"type":53,"tag":668,"props":7870,"children":7871},{},[],{"type":53,"tag":91,"props":7873,"children":7875},{"id":7874},"rovo-search-rovo-chat-surfacing",[7876],{"type":58,"value":7877},"Rovo Search \u002F Rovo Chat Surfacing",{"type":53,"tag":61,"props":7879,"children":7880},{},[7881],{"type":58,"value":7882},"Once ingested:",{"type":53,"tag":879,"props":7884,"children":7885},{},[7886,7897,7906],{"type":53,"tag":102,"props":7887,"children":7888},{},[7889,7891,7895],{"type":58,"value":7890},"Objects appear in ",{"type":53,"tag":76,"props":7892,"children":7893},{},[7894],{"type":58,"value":80},{"type":58,"value":7896}," under a subfilter named after the connector's nickname (set by admin at connection time)",{"type":53,"tag":102,"props":7898,"children":7899},{},[7900,7904],{"type":53,"tag":76,"props":7901,"children":7902},{},[7903],{"type":58,"value":87},{"type":58,"value":7905}," can reference and cite connector objects in responses when queried about topics related to the ingested content",{"type":53,"tag":102,"props":7907,"children":7908},{},[7909,7911,7916],{"type":58,"value":7910},"Data is not available immediately — allow a few minutes for indexing after ",{"type":53,"tag":67,"props":7912,"children":7914},{"className":7913},[],[7915],{"type":58,"value":3758},{"type":58,"value":7917}," fires",{"type":53,"tag":61,"props":7919,"children":7920},{},[7921],{"type":58,"value":7922},"To verify ingestion is working:",{"type":53,"tag":98,"props":7924,"children":7925},{},[7926,7931,7949],{"type":53,"tag":102,"props":7927,"children":7928},{},[7929],{"type":58,"value":7930},"Open Rovo Search on the Jira site",{"type":53,"tag":102,"props":7932,"children":7933},{},[7934,7936,7942,7943],{"type":58,"value":7935},"Search for text that appears in an ingested object's ",{"type":53,"tag":67,"props":7937,"children":7939},{"className":7938},[],[7940],{"type":58,"value":7941},"name",{"type":58,"value":443},{"type":53,"tag":67,"props":7944,"children":7946},{"className":7945},[],[7947],{"type":58,"value":7948},"properties",{"type":53,"tag":102,"props":7950,"children":7951},{},[7952],{"type":58,"value":7953},"Filter by the connector nickname to narrow results",{"type":53,"tag":668,"props":7955,"children":7956},{},[],{"type":53,"tag":91,"props":7958,"children":7960},{"id":7959},"batching-pattern-for-large-datasets",[7961],{"type":58,"value":7962},"Batching Pattern for Large Datasets",{"type":53,"tag":714,"props":7964,"children":7966},{"className":1846,"code":7965,"language":1848,"meta":719,"style":719},"const { graph } = require('@forge\u002Fteamwork-graph');\n\nconst BATCH_SIZE = 100;\n\nasync function ingestAllData(connectionId, config) {\n  const items = await fetchExternalData(config);\n\n  for (let i = 0; i \u003C items.length; i += BATCH_SIZE) {\n    const batch = items.slice(i, i + BATCH_SIZE);\n    const result = await graph.setObjects({\n      connectionId,          \u002F\u002F required in every call\n      objects: batch.map(item => ({\n        schemaVersion: '1.0',\n        id: item.id,                      \u002F\u002F unique per connectionId\n        updateSequenceNumber: 1,\n        displayName: item.title,\n        url: item.url,\n        createdAt: item.createdAt,\n        lastUpdatedAt: item.updatedAt,\n        \u002F\u002F Replace with user\u002Fgroup principals if source system has access controls.\n        permissions: [{\n          accessControls: [{ principals: [{ type: 'EVERYONE' }] }],\n        }],\n        'atlassian:document': {\n          type: { category: 'DOCUMENT', mimeType: item.mimeType },\n          content: { mimeType: item.mimeType, text: item.title },\n        },\n      })),\n    });\n    if (!result.success) {\n      console.error(`[connector] setObjects error in batch ${Math.floor(i \u002F BATCH_SIZE) + 1}:`, result.error);\n    }\n  }\n}\n",[7967],{"type":53,"tag":67,"props":7968,"children":7969},{"__ignoreMap":719},[7970,8021,8028,8053,8060,8101,8142,8149,8231,8294,8333,8350,8396,8424,8458,8478,8507,8536,8565,8594,8602,8622,8699,8714,8738,8806,8871,8878,8894,8910,8946,9053,9061,9068],{"type":53,"tag":725,"props":7971,"children":7972},{"class":727,"line":728},[7973,7977,7981,7985,7989,7993,7997,8001,8005,8009,8013,8017],{"type":53,"tag":725,"props":7974,"children":7975},{"style":1858},[7976],{"type":58,"value":1861},{"type":53,"tag":725,"props":7978,"children":7979},{"style":1439},[7980],{"type":58,"value":1866},{"type":53,"tag":725,"props":7982,"children":7983},{"style":1424},[7984],{"type":58,"value":1871},{"type":53,"tag":725,"props":7986,"children":7987},{"style":1439},[7988],{"type":58,"value":1876},{"type":53,"tag":725,"props":7990,"children":7991},{"style":1439},[7992],{"type":58,"value":1881},{"type":53,"tag":725,"props":7994,"children":7995},{"style":1666},[7996],{"type":58,"value":1886},{"type":53,"tag":725,"props":7998,"children":7999},{"style":1424},[8000],{"type":58,"value":1891},{"type":53,"tag":725,"props":8002,"children":8003},{"style":1439},[8004],{"type":58,"value":1896},{"type":53,"tag":725,"props":8006,"children":8007},{"style":738},[8008],{"type":58,"value":295},{"type":53,"tag":725,"props":8010,"children":8011},{"style":1439},[8012],{"type":58,"value":1896},{"type":53,"tag":725,"props":8014,"children":8015},{"style":1424},[8016],{"type":58,"value":1909},{"type":53,"tag":725,"props":8018,"children":8019},{"style":1439},[8020],{"type":58,"value":1914},{"type":53,"tag":725,"props":8022,"children":8023},{"class":727,"line":1430},[8024],{"type":53,"tag":725,"props":8025,"children":8026},{"emptyLinePlaceholder":1920},[8027],{"type":58,"value":1923},{"type":53,"tag":725,"props":8029,"children":8030},{"class":727,"line":1464},[8031,8035,8040,8044,8049],{"type":53,"tag":725,"props":8032,"children":8033},{"style":1858},[8034],{"type":58,"value":1861},{"type":53,"tag":725,"props":8036,"children":8037},{"style":1424},[8038],{"type":58,"value":8039}," BATCH_SIZE ",{"type":53,"tag":725,"props":8041,"children":8042},{"style":1439},[8043],{"type":58,"value":1940},{"type":53,"tag":725,"props":8045,"children":8046},{"style":2097},[8047],{"type":58,"value":8048}," 100",{"type":53,"tag":725,"props":8050,"children":8051},{"style":1439},[8052],{"type":58,"value":1914},{"type":53,"tag":725,"props":8054,"children":8055},{"class":727,"line":1492},[8056],{"type":53,"tag":725,"props":8057,"children":8058},{"emptyLinePlaceholder":1920},[8059],{"type":58,"value":1923},{"type":53,"tag":725,"props":8061,"children":8062},{"class":727,"line":1522},[8063,8068,8073,8077,8081,8085,8089,8093,8097],{"type":53,"tag":725,"props":8064,"children":8065},{"style":1858},[8066],{"type":58,"value":8067},"async",{"type":53,"tag":725,"props":8069,"children":8070},{"style":1858},[8071],{"type":58,"value":8072}," function",{"type":53,"tag":725,"props":8074,"children":8075},{"style":1666},[8076],{"type":58,"value":6722},{"type":53,"tag":725,"props":8078,"children":8079},{"style":1439},[8080],{"type":58,"value":1891},{"type":53,"tag":725,"props":8082,"children":8083},{"style":6431},[8084],{"type":58,"value":2791},{"type":53,"tag":725,"props":8086,"children":8087},{"style":1439},[8088],{"type":58,"value":1981},{"type":53,"tag":725,"props":8090,"children":8091},{"style":6431},[8092],{"type":58,"value":7352},{"type":53,"tag":725,"props":8094,"children":8095},{"style":1439},[8096],{"type":58,"value":1909},{"type":53,"tag":725,"props":8098,"children":8099},{"style":1439},[8100],{"type":58,"value":2424},{"type":53,"tag":725,"props":8102,"children":8103},{"class":727,"line":2009},[8104,8108,8113,8117,8121,8126,8130,8134,8138],{"type":53,"tag":725,"props":8105,"children":8106},{"style":1858},[8107],{"type":58,"value":6463},{"type":53,"tag":725,"props":8109,"children":8110},{"style":1424},[8111],{"type":58,"value":8112}," items",{"type":53,"tag":725,"props":8114,"children":8115},{"style":1439},[8116],{"type":58,"value":1881},{"type":53,"tag":725,"props":8118,"children":8119},{"style":1943},[8120],{"type":58,"value":1946},{"type":53,"tag":725,"props":8122,"children":8123},{"style":1666},[8124],{"type":58,"value":8125}," fetchExternalData",{"type":53,"tag":725,"props":8127,"children":8128},{"style":1993},[8129],{"type":58,"value":1891},{"type":53,"tag":725,"props":8131,"children":8132},{"style":1424},[8133],{"type":58,"value":7406},{"type":53,"tag":725,"props":8135,"children":8136},{"style":1993},[8137],{"type":58,"value":1909},{"type":53,"tag":725,"props":8139,"children":8140},{"style":1439},[8141],{"type":58,"value":1914},{"type":53,"tag":725,"props":8143,"children":8144},{"class":727,"line":26},[8145],{"type":53,"tag":725,"props":8146,"children":8147},{"emptyLinePlaceholder":1920},[8148],{"type":58,"value":1923},{"type":53,"tag":725,"props":8150,"children":8151},{"class":727,"line":2049},[8152,8156,8160,8165,8170,8174,8179,8184,8188,8192,8196,8200,8205,8209,8213,8218,8223,8227],{"type":53,"tag":725,"props":8153,"children":8154},{"style":1943},[8155],{"type":58,"value":7310},{"type":53,"tag":725,"props":8157,"children":8158},{"style":1993},[8159],{"type":58,"value":2667},{"type":53,"tag":725,"props":8161,"children":8162},{"style":1858},[8163],{"type":58,"value":8164},"let",{"type":53,"tag":725,"props":8166,"children":8167},{"style":1424},[8168],{"type":58,"value":8169}," i",{"type":53,"tag":725,"props":8171,"children":8172},{"style":1439},[8173],{"type":58,"value":1881},{"type":53,"tag":725,"props":8175,"children":8176},{"style":2097},[8177],{"type":58,"value":8178}," 0",{"type":53,"tag":725,"props":8180,"children":8181},{"style":1439},[8182],{"type":58,"value":8183},";",{"type":53,"tag":725,"props":8185,"children":8186},{"style":1424},[8187],{"type":58,"value":8169},{"type":53,"tag":725,"props":8189,"children":8190},{"style":1439},[8191],{"type":58,"value":1442},{"type":53,"tag":725,"props":8193,"children":8194},{"style":1424},[8195],{"type":58,"value":8112},{"type":53,"tag":725,"props":8197,"children":8198},{"style":1439},[8199],{"type":58,"value":89},{"type":53,"tag":725,"props":8201,"children":8202},{"style":1424},[8203],{"type":58,"value":8204},"length",{"type":53,"tag":725,"props":8206,"children":8207},{"style":1439},[8208],{"type":58,"value":8183},{"type":53,"tag":725,"props":8210,"children":8211},{"style":1424},[8212],{"type":58,"value":8169},{"type":53,"tag":725,"props":8214,"children":8215},{"style":1439},[8216],{"type":58,"value":8217}," +=",{"type":53,"tag":725,"props":8219,"children":8220},{"style":1424},[8221],{"type":58,"value":8222}," BATCH_SIZE",{"type":53,"tag":725,"props":8224,"children":8225},{"style":1993},[8226],{"type":58,"value":571},{"type":53,"tag":725,"props":8228,"children":8229},{"style":1439},[8230],{"type":58,"value":1968},{"type":53,"tag":725,"props":8232,"children":8233},{"class":727,"line":2084},[8234,8238,8243,8247,8251,8255,8260,8264,8269,8273,8277,8282,8286,8290],{"type":53,"tag":725,"props":8235,"children":8236},{"style":1858},[8237],{"type":58,"value":7347},{"type":53,"tag":725,"props":8239,"children":8240},{"style":1424},[8241],{"type":58,"value":8242}," batch",{"type":53,"tag":725,"props":8244,"children":8245},{"style":1439},[8246],{"type":58,"value":1881},{"type":53,"tag":725,"props":8248,"children":8249},{"style":1424},[8250],{"type":58,"value":8112},{"type":53,"tag":725,"props":8252,"children":8253},{"style":1439},[8254],{"type":58,"value":89},{"type":53,"tag":725,"props":8256,"children":8257},{"style":1666},[8258],{"type":58,"value":8259},"slice",{"type":53,"tag":725,"props":8261,"children":8262},{"style":1993},[8263],{"type":58,"value":1891},{"type":53,"tag":725,"props":8265,"children":8266},{"style":1424},[8267],{"type":58,"value":8268},"i",{"type":53,"tag":725,"props":8270,"children":8271},{"style":1439},[8272],{"type":58,"value":1981},{"type":53,"tag":725,"props":8274,"children":8275},{"style":1424},[8276],{"type":58,"value":8169},{"type":53,"tag":725,"props":8278,"children":8279},{"style":1439},[8280],{"type":58,"value":8281}," +",{"type":53,"tag":725,"props":8283,"children":8284},{"style":1424},[8285],{"type":58,"value":8222},{"type":53,"tag":725,"props":8287,"children":8288},{"style":1993},[8289],{"type":58,"value":1909},{"type":53,"tag":725,"props":8291,"children":8292},{"style":1439},[8293],{"type":58,"value":1914},{"type":53,"tag":725,"props":8295,"children":8296},{"class":727,"line":2107},[8297,8301,8305,8309,8313,8317,8321,8325,8329],{"type":53,"tag":725,"props":8298,"children":8299},{"style":1858},[8300],{"type":58,"value":7347},{"type":53,"tag":725,"props":8302,"children":8303},{"style":1424},[8304],{"type":58,"value":2734},{"type":53,"tag":725,"props":8306,"children":8307},{"style":1439},[8308],{"type":58,"value":1881},{"type":53,"tag":725,"props":8310,"children":8311},{"style":1943},[8312],{"type":58,"value":1946},{"type":53,"tag":725,"props":8314,"children":8315},{"style":1424},[8316],{"type":58,"value":1951},{"type":53,"tag":725,"props":8318,"children":8319},{"style":1439},[8320],{"type":58,"value":89},{"type":53,"tag":725,"props":8322,"children":8323},{"style":1666},[8324],{"type":58,"value":319},{"type":53,"tag":725,"props":8326,"children":8327},{"style":1993},[8328],{"type":58,"value":1891},{"type":53,"tag":725,"props":8330,"children":8331},{"style":1439},[8332],{"type":58,"value":1968},{"type":53,"tag":725,"props":8334,"children":8335},{"class":727,"line":2137},[8336,8341,8345],{"type":53,"tag":725,"props":8337,"children":8338},{"style":1424},[8339],{"type":58,"value":8340},"      connectionId",{"type":53,"tag":725,"props":8342,"children":8343},{"style":1439},[8344],{"type":58,"value":1981},{"type":53,"tag":725,"props":8346,"children":8347},{"style":1984},[8348],{"type":58,"value":8349},"          \u002F\u002F required in every call\n",{"type":53,"tag":725,"props":8351,"children":8352},{"class":727,"line":2167},[8353,8358,8362,8366,8370,8375,8379,8384,8388,8392],{"type":53,"tag":725,"props":8354,"children":8355},{"style":1993},[8356],{"type":58,"value":8357},"      objects",{"type":53,"tag":725,"props":8359,"children":8360},{"style":1439},[8361],{"type":58,"value":2001},{"type":53,"tag":725,"props":8363,"children":8364},{"style":1424},[8365],{"type":58,"value":8242},{"type":53,"tag":725,"props":8367,"children":8368},{"style":1439},[8369],{"type":58,"value":89},{"type":53,"tag":725,"props":8371,"children":8372},{"style":1666},[8373],{"type":58,"value":8374},"map",{"type":53,"tag":725,"props":8376,"children":8377},{"style":1993},[8378],{"type":58,"value":1891},{"type":53,"tag":725,"props":8380,"children":8381},{"style":6431},[8382],{"type":58,"value":8383},"item",{"type":53,"tag":725,"props":8385,"children":8386},{"style":1858},[8387],{"type":58,"value":6443},{"type":53,"tag":725,"props":8389,"children":8390},{"style":1993},[8391],{"type":58,"value":2667},{"type":53,"tag":725,"props":8393,"children":8394},{"style":1439},[8395],{"type":58,"value":1968},{"type":53,"tag":725,"props":8397,"children":8398},{"class":727,"line":2202},[8399,8404,8408,8412,8416,8420],{"type":53,"tag":725,"props":8400,"children":8401},{"style":1993},[8402],{"type":58,"value":8403},"        schemaVersion",{"type":53,"tag":725,"props":8405,"children":8406},{"style":1439},[8407],{"type":58,"value":2001},{"type":53,"tag":725,"props":8409,"children":8410},{"style":1439},[8411],{"type":58,"value":2032},{"type":53,"tag":725,"props":8413,"children":8414},{"style":738},[8415],{"type":58,"value":2037},{"type":53,"tag":725,"props":8417,"children":8418},{"style":1439},[8419],{"type":58,"value":1896},{"type":53,"tag":725,"props":8421,"children":8422},{"style":1439},[8423],{"type":58,"value":2046},{"type":53,"tag":725,"props":8425,"children":8426},{"class":727,"line":22},[8427,8432,8436,8441,8445,8449,8453],{"type":53,"tag":725,"props":8428,"children":8429},{"style":1993},[8430],{"type":58,"value":8431},"        id",{"type":53,"tag":725,"props":8433,"children":8434},{"style":1439},[8435],{"type":58,"value":2001},{"type":53,"tag":725,"props":8437,"children":8438},{"style":1424},[8439],{"type":58,"value":8440}," item",{"type":53,"tag":725,"props":8442,"children":8443},{"style":1439},[8444],{"type":58,"value":89},{"type":53,"tag":725,"props":8446,"children":8447},{"style":1424},[8448],{"type":58,"value":2783},{"type":53,"tag":725,"props":8450,"children":8451},{"style":1439},[8452],{"type":58,"value":1981},{"type":53,"tag":725,"props":8454,"children":8455},{"style":1984},[8456],{"type":58,"value":8457},"                      \u002F\u002F unique per connectionId\n",{"type":53,"tag":725,"props":8459,"children":8460},{"class":727,"line":2240},[8461,8466,8470,8474],{"type":53,"tag":725,"props":8462,"children":8463},{"style":1993},[8464],{"type":58,"value":8465},"        updateSequenceNumber",{"type":53,"tag":725,"props":8467,"children":8468},{"style":1439},[8469],{"type":58,"value":2001},{"type":53,"tag":725,"props":8471,"children":8472},{"style":2097},[8473],{"type":58,"value":2100},{"type":53,"tag":725,"props":8475,"children":8476},{"style":1439},[8477],{"type":58,"value":2046},{"type":53,"tag":725,"props":8479,"children":8480},{"class":727,"line":2249},[8481,8486,8490,8494,8498,8503],{"type":53,"tag":725,"props":8482,"children":8483},{"style":1993},[8484],{"type":58,"value":8485},"        displayName",{"type":53,"tag":725,"props":8487,"children":8488},{"style":1439},[8489],{"type":58,"value":2001},{"type":53,"tag":725,"props":8491,"children":8492},{"style":1424},[8493],{"type":58,"value":8440},{"type":53,"tag":725,"props":8495,"children":8496},{"style":1439},[8497],{"type":58,"value":89},{"type":53,"tag":725,"props":8499,"children":8500},{"style":1424},[8501],{"type":58,"value":8502},"title",{"type":53,"tag":725,"props":8504,"children":8505},{"style":1439},[8506],{"type":58,"value":2046},{"type":53,"tag":725,"props":8508,"children":8509},{"class":727,"line":2258},[8510,8515,8519,8523,8527,8532],{"type":53,"tag":725,"props":8511,"children":8512},{"style":1993},[8513],{"type":58,"value":8514},"        url",{"type":53,"tag":725,"props":8516,"children":8517},{"style":1439},[8518],{"type":58,"value":2001},{"type":53,"tag":725,"props":8520,"children":8521},{"style":1424},[8522],{"type":58,"value":8440},{"type":53,"tag":725,"props":8524,"children":8525},{"style":1439},[8526],{"type":58,"value":89},{"type":53,"tag":725,"props":8528,"children":8529},{"style":1424},[8530],{"type":58,"value":8531},"url",{"type":53,"tag":725,"props":8533,"children":8534},{"style":1439},[8535],{"type":58,"value":2046},{"type":53,"tag":725,"props":8537,"children":8538},{"class":727,"line":2267},[8539,8544,8548,8552,8556,8561],{"type":53,"tag":725,"props":8540,"children":8541},{"style":1993},[8542],{"type":58,"value":8543},"        createdAt",{"type":53,"tag":725,"props":8545,"children":8546},{"style":1439},[8547],{"type":58,"value":2001},{"type":53,"tag":725,"props":8549,"children":8550},{"style":1424},[8551],{"type":58,"value":8440},{"type":53,"tag":725,"props":8553,"children":8554},{"style":1439},[8555],{"type":58,"value":89},{"type":53,"tag":725,"props":8557,"children":8558},{"style":1424},[8559],{"type":58,"value":8560},"createdAt",{"type":53,"tag":725,"props":8562,"children":8563},{"style":1439},[8564],{"type":58,"value":2046},{"type":53,"tag":725,"props":8566,"children":8567},{"class":727,"line":2289},[8568,8573,8577,8581,8585,8590],{"type":53,"tag":725,"props":8569,"children":8570},{"style":1993},[8571],{"type":58,"value":8572},"        lastUpdatedAt",{"type":53,"tag":725,"props":8574,"children":8575},{"style":1439},[8576],{"type":58,"value":2001},{"type":53,"tag":725,"props":8578,"children":8579},{"style":1424},[8580],{"type":58,"value":8440},{"type":53,"tag":725,"props":8582,"children":8583},{"style":1439},[8584],{"type":58,"value":89},{"type":53,"tag":725,"props":8586,"children":8587},{"style":1424},[8588],{"type":58,"value":8589},"updatedAt",{"type":53,"tag":725,"props":8591,"children":8592},{"style":1439},[8593],{"type":58,"value":2046},{"type":53,"tag":725,"props":8595,"children":8596},{"class":727,"line":2310},[8597],{"type":53,"tag":725,"props":8598,"children":8599},{"style":1984},[8600],{"type":58,"value":8601},"        \u002F\u002F Replace with user\u002Fgroup principals if source system has access controls.\n",{"type":53,"tag":725,"props":8603,"children":8604},{"class":727,"line":2367},[8605,8610,8614,8618],{"type":53,"tag":725,"props":8606,"children":8607},{"style":1993},[8608],{"type":58,"value":8609},"        permissions",{"type":53,"tag":725,"props":8611,"children":8612},{"style":1439},[8613],{"type":58,"value":2001},{"type":53,"tag":725,"props":8615,"children":8616},{"style":1993},[8617],{"type":58,"value":2282},{"type":53,"tag":725,"props":8619,"children":8620},{"style":1439},[8621],{"type":58,"value":1968},{"type":53,"tag":725,"props":8623,"children":8624},{"class":727,"line":2384},[8625,8630,8634,8638,8642,8646,8650,8654,8658,8662,8666,8670,8674,8678,8682,8687,8691,8695],{"type":53,"tag":725,"props":8626,"children":8627},{"style":1993},[8628],{"type":58,"value":8629},"          accessControls",{"type":53,"tag":725,"props":8631,"children":8632},{"style":1439},[8633],{"type":58,"value":2001},{"type":53,"tag":725,"props":8635,"children":8636},{"style":1993},[8637],{"type":58,"value":2282},{"type":53,"tag":725,"props":8639,"children":8640},{"style":1439},[8641],{"type":58,"value":2329},{"type":53,"tag":725,"props":8643,"children":8644},{"style":1993},[8645],{"type":58,"value":4817},{"type":53,"tag":725,"props":8647,"children":8648},{"style":1439},[8649],{"type":58,"value":2001},{"type":53,"tag":725,"props":8651,"children":8652},{"style":1993},[8653],{"type":58,"value":2282},{"type":53,"tag":725,"props":8655,"children":8656},{"style":1439},[8657],{"type":58,"value":2329},{"type":53,"tag":725,"props":8659,"children":8660},{"style":1993},[8661],{"type":58,"value":2334},{"type":53,"tag":725,"props":8663,"children":8664},{"style":1439},[8665],{"type":58,"value":2001},{"type":53,"tag":725,"props":8667,"children":8668},{"style":1439},[8669],{"type":58,"value":2032},{"type":53,"tag":725,"props":8671,"children":8672},{"style":738},[8673],{"type":58,"value":1297},{"type":53,"tag":725,"props":8675,"children":8676},{"style":1439},[8677],{"type":58,"value":1896},{"type":53,"tag":725,"props":8679,"children":8680},{"style":1439},[8681],{"type":58,"value":2355},{"type":53,"tag":725,"props":8683,"children":8684},{"style":1993},[8685],{"type":58,"value":8686},"] ",{"type":53,"tag":725,"props":8688,"children":8689},{"style":1439},[8690],{"type":58,"value":1876},{"type":53,"tag":725,"props":8692,"children":8693},{"style":1993},[8694],{"type":58,"value":2360},{"type":53,"tag":725,"props":8696,"children":8697},{"style":1439},[8698],{"type":58,"value":2046},{"type":53,"tag":725,"props":8700,"children":8701},{"class":727,"line":2401},[8702,8706,8710],{"type":53,"tag":725,"props":8703,"children":8704},{"style":1439},[8705],{"type":58,"value":2373},{"type":53,"tag":725,"props":8707,"children":8708},{"style":1993},[8709],{"type":58,"value":2360},{"type":53,"tag":725,"props":8711,"children":8712},{"style":1439},[8713],{"type":58,"value":2046},{"type":53,"tag":725,"props":8715,"children":8716},{"class":727,"line":2427},[8717,8722,8726,8730,8734],{"type":53,"tag":725,"props":8718,"children":8719},{"style":1439},[8720],{"type":58,"value":8721},"        '",{"type":53,"tag":725,"props":8723,"children":8724},{"style":1993},[8725],{"type":58,"value":846},{"type":53,"tag":725,"props":8727,"children":8728},{"style":1439},[8729],{"type":58,"value":1896},{"type":53,"tag":725,"props":8731,"children":8732},{"style":1439},[8733],{"type":58,"value":2001},{"type":53,"tag":725,"props":8735,"children":8736},{"style":1439},[8737],{"type":58,"value":2424},{"type":53,"tag":725,"props":8739,"children":8740},{"class":727,"line":2444},[8741,8746,8750,8754,8759,8763,8767,8771,8775,8779,8784,8788,8792,8796,8801],{"type":53,"tag":725,"props":8742,"children":8743},{"style":1993},[8744],{"type":58,"value":8745},"          type",{"type":53,"tag":725,"props":8747,"children":8748},{"style":1439},[8749],{"type":58,"value":2001},{"type":53,"tag":725,"props":8751,"children":8752},{"style":1439},[8753],{"type":58,"value":1866},{"type":53,"tag":725,"props":8755,"children":8756},{"style":1993},[8757],{"type":58,"value":8758}," category",{"type":53,"tag":725,"props":8760,"children":8761},{"style":1439},[8762],{"type":58,"value":2001},{"type":53,"tag":725,"props":8764,"children":8765},{"style":1439},[8766],{"type":58,"value":2032},{"type":53,"tag":725,"props":8768,"children":8769},{"style":738},[8770],{"type":58,"value":2463},{"type":53,"tag":725,"props":8772,"children":8773},{"style":1439},[8774],{"type":58,"value":1896},{"type":53,"tag":725,"props":8776,"children":8777},{"style":1439},[8778],{"type":58,"value":1981},{"type":53,"tag":725,"props":8780,"children":8781},{"style":1993},[8782],{"type":58,"value":8783}," mimeType",{"type":53,"tag":725,"props":8785,"children":8786},{"style":1439},[8787],{"type":58,"value":2001},{"type":53,"tag":725,"props":8789,"children":8790},{"style":1424},[8791],{"type":58,"value":8440},{"type":53,"tag":725,"props":8793,"children":8794},{"style":1439},[8795],{"type":58,"value":89},{"type":53,"tag":725,"props":8797,"children":8798},{"style":1424},[8799],{"type":58,"value":8800},"mimeType",{"type":53,"tag":725,"props":8802,"children":8803},{"style":1439},[8804],{"type":58,"value":8805}," },\n",{"type":53,"tag":725,"props":8807,"children":8808},{"class":727,"line":2479},[8809,8814,8818,8822,8826,8830,8834,8838,8842,8846,8851,8855,8859,8863,8867],{"type":53,"tag":725,"props":8810,"children":8811},{"style":1993},[8812],{"type":58,"value":8813},"          content",{"type":53,"tag":725,"props":8815,"children":8816},{"style":1439},[8817],{"type":58,"value":2001},{"type":53,"tag":725,"props":8819,"children":8820},{"style":1439},[8821],{"type":58,"value":1866},{"type":53,"tag":725,"props":8823,"children":8824},{"style":1993},[8825],{"type":58,"value":8783},{"type":53,"tag":725,"props":8827,"children":8828},{"style":1439},[8829],{"type":58,"value":2001},{"type":53,"tag":725,"props":8831,"children":8832},{"style":1424},[8833],{"type":58,"value":8440},{"type":53,"tag":725,"props":8835,"children":8836},{"style":1439},[8837],{"type":58,"value":89},{"type":53,"tag":725,"props":8839,"children":8840},{"style":1424},[8841],{"type":58,"value":8800},{"type":53,"tag":725,"props":8843,"children":8844},{"style":1439},[8845],{"type":58,"value":1981},{"type":53,"tag":725,"props":8847,"children":8848},{"style":1993},[8849],{"type":58,"value":8850}," text",{"type":53,"tag":725,"props":8852,"children":8853},{"style":1439},[8854],{"type":58,"value":2001},{"type":53,"tag":725,"props":8856,"children":8857},{"style":1424},[8858],{"type":58,"value":8440},{"type":53,"tag":725,"props":8860,"children":8861},{"style":1439},[8862],{"type":58,"value":89},{"type":53,"tag":725,"props":8864,"children":8865},{"style":1424},[8866],{"type":58,"value":8502},{"type":53,"tag":725,"props":8868,"children":8869},{"style":1439},[8870],{"type":58,"value":8805},{"type":53,"tag":725,"props":8872,"children":8873},{"class":727,"line":2509},[8874],{"type":53,"tag":725,"props":8875,"children":8876},{"style":1439},[8877],{"type":58,"value":2515},{"type":53,"tag":725,"props":8879,"children":8880},{"class":727,"line":2518},[8881,8885,8890],{"type":53,"tag":725,"props":8882,"children":8883},{"style":1439},[8884],{"type":58,"value":2390},{"type":53,"tag":725,"props":8886,"children":8887},{"style":1993},[8888],{"type":58,"value":8889},"))",{"type":53,"tag":725,"props":8891,"children":8892},{"style":1439},[8893],{"type":58,"value":2046},{"type":53,"tag":725,"props":8895,"children":8896},{"class":727,"line":2535},[8897,8902,8906],{"type":53,"tag":725,"props":8898,"children":8899},{"style":1439},[8900],{"type":58,"value":8901},"    }",{"type":53,"tag":725,"props":8903,"children":8904},{"style":1993},[8905],{"type":58,"value":1909},{"type":53,"tag":725,"props":8907,"children":8908},{"style":1439},[8909],{"type":58,"value":1914},{"type":53,"tag":725,"props":8911,"children":8912},{"class":727,"line":2563},[8913,8917,8921,8925,8929,8933,8938,8942],{"type":53,"tag":725,"props":8914,"children":8915},{"style":1943},[8916],{"type":58,"value":7397},{"type":53,"tag":725,"props":8918,"children":8919},{"style":1993},[8920],{"type":58,"value":2667},{"type":53,"tag":725,"props":8922,"children":8923},{"style":1439},[8924],{"type":58,"value":2672},{"type":53,"tag":725,"props":8926,"children":8927},{"style":1424},[8928],{"type":58,"value":2677},{"type":53,"tag":725,"props":8930,"children":8931},{"style":1439},[8932],{"type":58,"value":89},{"type":53,"tag":725,"props":8934,"children":8935},{"style":1424},[8936],{"type":58,"value":8937},"success",{"type":53,"tag":725,"props":8939,"children":8940},{"style":1993},[8941],{"type":58,"value":571},{"type":53,"tag":725,"props":8943,"children":8944},{"style":1439},[8945],{"type":58,"value":1968},{"type":53,"tag":725,"props":8947,"children":8948},{"class":727,"line":2593},[8949,8954,8958,8962,8966,8970,8975,8980,8985,8989,8994,8999,9003,9008,9013,9017,9021,9025,9029,9033,9037,9041,9045,9049],{"type":53,"tag":725,"props":8950,"children":8951},{"style":1424},[8952],{"type":58,"value":8953},"      console",{"type":53,"tag":725,"props":8955,"children":8956},{"style":1439},[8957],{"type":58,"value":89},{"type":53,"tag":725,"props":8959,"children":8960},{"style":1666},[8961],{"type":58,"value":2708},{"type":53,"tag":725,"props":8963,"children":8964},{"style":1993},[8965],{"type":58,"value":1891},{"type":53,"tag":725,"props":8967,"children":8968},{"style":1439},[8969],{"type":58,"value":7024},{"type":53,"tag":725,"props":8971,"children":8972},{"style":738},[8973],{"type":58,"value":8974},"[connector] setObjects error in batch ",{"type":53,"tag":725,"props":8976,"children":8977},{"style":1439},[8978],{"type":58,"value":8979},"${",{"type":53,"tag":725,"props":8981,"children":8982},{"style":1424},[8983],{"type":58,"value":8984},"Math",{"type":53,"tag":725,"props":8986,"children":8987},{"style":1439},[8988],{"type":58,"value":89},{"type":53,"tag":725,"props":8990,"children":8991},{"style":1666},[8992],{"type":58,"value":8993},"floor",{"type":53,"tag":725,"props":8995,"children":8996},{"style":1424},[8997],{"type":58,"value":8998},"(i ",{"type":53,"tag":725,"props":9000,"children":9001},{"style":1439},[9002],{"type":58,"value":4484},{"type":53,"tag":725,"props":9004,"children":9005},{"style":1424},[9006],{"type":58,"value":9007}," BATCH_SIZE) ",{"type":53,"tag":725,"props":9009,"children":9010},{"style":1439},[9011],{"type":58,"value":9012},"+",{"type":53,"tag":725,"props":9014,"children":9015},{"style":2097},[9016],{"type":58,"value":2100},{"type":53,"tag":725,"props":9018,"children":9019},{"style":1439},[9020],{"type":58,"value":1876},{"type":53,"tag":725,"props":9022,"children":9023},{"style":738},[9024],{"type":58,"value":2001},{"type":53,"tag":725,"props":9026,"children":9027},{"style":1439},[9028],{"type":58,"value":7024},{"type":53,"tag":725,"props":9030,"children":9031},{"style":1439},[9032],{"type":58,"value":1981},{"type":53,"tag":725,"props":9034,"children":9035},{"style":1424},[9036],{"type":58,"value":2734},{"type":53,"tag":725,"props":9038,"children":9039},{"style":1439},[9040],{"type":58,"value":89},{"type":53,"tag":725,"props":9042,"children":9043},{"style":1424},[9044],{"type":58,"value":2708},{"type":53,"tag":725,"props":9046,"children":9047},{"style":1993},[9048],{"type":58,"value":1909},{"type":53,"tag":725,"props":9050,"children":9051},{"style":1439},[9052],{"type":58,"value":1914},{"type":53,"tag":725,"props":9054,"children":9055},{"class":727,"line":2601},[9056],{"type":53,"tag":725,"props":9057,"children":9058},{"style":1439},[9059],{"type":58,"value":9060},"    }\n",{"type":53,"tag":725,"props":9062,"children":9063},{"class":727,"line":2610},[9064],{"type":53,"tag":725,"props":9065,"children":9066},{"style":1439},[9067],{"type":58,"value":6650},{"type":53,"tag":725,"props":9069,"children":9070},{"class":727,"line":2619},[9071],{"type":53,"tag":725,"props":9072,"children":9073},{"style":1439},[9074],{"type":58,"value":2759},{"type":53,"tag":668,"props":9076,"children":9077},{},[],{"type":53,"tag":91,"props":9079,"children":9081},{"id":9080},"scheduled-re-ingestion-optional",[9082],{"type":58,"value":9083},"Scheduled Re-Ingestion (optional)",{"type":53,"tag":61,"props":9085,"children":9086},{},[9087],{"type":58,"value":9088},"To keep data fresh, add a scheduled trigger that re-runs ingestion periodically:",{"type":53,"tag":714,"props":9090,"children":9092},{"className":4997,"code":9091,"language":4999,"meta":719,"style":719},"# In manifest.yml — under modules:\nscheduledTrigger:\n  - key: refresh-trigger\n    function: refresh-ingestion\n    interval: day   # prefer 'day' or 'hour'; avoid 'fiveMinutes'\n\n# Under function:\n  - key: refresh-ingestion\n    handler: index.refreshIngestionHandler\n",[9093],{"type":53,"tag":67,"props":9094,"children":9095},{"__ignoreMap":719},[9096,9104,9115,9136,9153,9175,9182,9190,9209],{"type":53,"tag":725,"props":9097,"children":9098},{"class":727,"line":728},[9099],{"type":53,"tag":725,"props":9100,"children":9101},{"style":1984},[9102],{"type":58,"value":9103},"# In manifest.yml — under modules:\n",{"type":53,"tag":725,"props":9105,"children":9106},{"class":727,"line":1430},[9107,9111],{"type":53,"tag":725,"props":9108,"children":9109},{"style":1993},[9110],{"type":58,"value":1097},{"type":53,"tag":725,"props":9112,"children":9113},{"style":1439},[9114],{"type":58,"value":5016},{"type":53,"tag":725,"props":9116,"children":9117},{"class":727,"line":1464},[9118,9123,9127,9131],{"type":53,"tag":725,"props":9119,"children":9120},{"style":1439},[9121],{"type":58,"value":9122},"  -",{"type":53,"tag":725,"props":9124,"children":9125},{"style":1993},[9126],{"type":58,"value":5217},{"type":53,"tag":725,"props":9128,"children":9129},{"style":1439},[9130],{"type":58,"value":2001},{"type":53,"tag":725,"props":9132,"children":9133},{"style":738},[9134],{"type":58,"value":9135}," refresh-trigger\n",{"type":53,"tag":725,"props":9137,"children":9138},{"class":727,"line":1492},[9139,9144,9148],{"type":53,"tag":725,"props":9140,"children":9141},{"style":1993},[9142],{"type":58,"value":9143},"    function",{"type":53,"tag":725,"props":9145,"children":9146},{"style":1439},[9147],{"type":58,"value":2001},{"type":53,"tag":725,"props":9149,"children":9150},{"style":738},[9151],{"type":58,"value":9152}," refresh-ingestion\n",{"type":53,"tag":725,"props":9154,"children":9155},{"class":727,"line":1522},[9156,9161,9165,9170],{"type":53,"tag":725,"props":9157,"children":9158},{"style":1993},[9159],{"type":58,"value":9160},"    interval",{"type":53,"tag":725,"props":9162,"children":9163},{"style":1439},[9164],{"type":58,"value":2001},{"type":53,"tag":725,"props":9166,"children":9167},{"style":738},[9168],{"type":58,"value":9169}," day",{"type":53,"tag":725,"props":9171,"children":9172},{"style":1984},[9173],{"type":58,"value":9174},"   # prefer 'day' or 'hour'; avoid 'fiveMinutes'\n",{"type":53,"tag":725,"props":9176,"children":9177},{"class":727,"line":2009},[9178],{"type":53,"tag":725,"props":9179,"children":9180},{"emptyLinePlaceholder":1920},[9181],{"type":58,"value":1923},{"type":53,"tag":725,"props":9183,"children":9184},{"class":727,"line":26},[9185],{"type":53,"tag":725,"props":9186,"children":9187},{"style":1984},[9188],{"type":58,"value":9189},"# Under function:\n",{"type":53,"tag":725,"props":9191,"children":9192},{"class":727,"line":2049},[9193,9197,9201,9205],{"type":53,"tag":725,"props":9194,"children":9195},{"style":1439},[9196],{"type":58,"value":9122},{"type":53,"tag":725,"props":9198,"children":9199},{"style":1993},[9200],{"type":58,"value":5217},{"type":53,"tag":725,"props":9202,"children":9203},{"style":1439},[9204],{"type":58,"value":2001},{"type":53,"tag":725,"props":9206,"children":9207},{"style":738},[9208],{"type":58,"value":9152},{"type":53,"tag":725,"props":9210,"children":9211},{"class":727,"line":2084},[9212,9217,9221],{"type":53,"tag":725,"props":9213,"children":9214},{"style":1993},[9215],{"type":58,"value":9216},"    handler",{"type":53,"tag":725,"props":9218,"children":9219},{"style":1439},[9220],{"type":58,"value":2001},{"type":53,"tag":725,"props":9222,"children":9223},{"style":738},[9224],{"type":58,"value":9225}," index.refreshIngestionHandler\n",{"type":53,"tag":714,"props":9227,"children":9229},{"className":1846,"code":9228,"language":1848,"meta":719,"style":719},"const { kvs } = require('@forge\u002Fkvs');\n\n\u002F\u002F Track active connections in onConnectionChangeHandler:\n\u002F\u002F   await kvs.set('active-connections', [...activeConnections, connectionId]);\n\u002F\u002F   await kvs.setSecret(connectionId, configProperties);  \u002F\u002F store credentials securely\n\nexports.refreshIngestionHandler = async () => {\n  const activeConnections = await kvs.get('active-connections') ?? [];\n  for (const connectionId of activeConnections) {\n    const config = await kvs.getSecret(connectionId);  \u002F\u002F retrieve stored credentials\n    if (config) await ingestAllData(connectionId, config);\n  }\n};\n",[9230],{"type":53,"tag":67,"props":9231,"children":9232},{"__ignoreMap":719},[9233,9284,9291,9299,9307,9320,9327,9358,9421,9456,9508,9559,9566],{"type":53,"tag":725,"props":9234,"children":9235},{"class":727,"line":728},[9236,9240,9244,9248,9252,9256,9260,9264,9268,9272,9276,9280],{"type":53,"tag":725,"props":9237,"children":9238},{"style":1858},[9239],{"type":58,"value":1861},{"type":53,"tag":725,"props":9241,"children":9242},{"style":1439},[9243],{"type":58,"value":1866},{"type":53,"tag":725,"props":9245,"children":9246},{"style":1424},[9247],{"type":58,"value":6309},{"type":53,"tag":725,"props":9249,"children":9250},{"style":1439},[9251],{"type":58,"value":1876},{"type":53,"tag":725,"props":9253,"children":9254},{"style":1439},[9255],{"type":58,"value":1881},{"type":53,"tag":725,"props":9257,"children":9258},{"style":1666},[9259],{"type":58,"value":1886},{"type":53,"tag":725,"props":9261,"children":9262},{"style":1424},[9263],{"type":58,"value":1891},{"type":53,"tag":725,"props":9265,"children":9266},{"style":1439},[9267],{"type":58,"value":1896},{"type":53,"tag":725,"props":9269,"children":9270},{"style":738},[9271],{"type":58,"value":231},{"type":53,"tag":725,"props":9273,"children":9274},{"style":1439},[9275],{"type":58,"value":1896},{"type":53,"tag":725,"props":9277,"children":9278},{"style":1424},[9279],{"type":58,"value":1909},{"type":53,"tag":725,"props":9281,"children":9282},{"style":1439},[9283],{"type":58,"value":1914},{"type":53,"tag":725,"props":9285,"children":9286},{"class":727,"line":1430},[9287],{"type":53,"tag":725,"props":9288,"children":9289},{"emptyLinePlaceholder":1920},[9290],{"type":58,"value":1923},{"type":53,"tag":725,"props":9292,"children":9293},{"class":727,"line":1464},[9294],{"type":53,"tag":725,"props":9295,"children":9296},{"style":1984},[9297],{"type":58,"value":9298},"\u002F\u002F Track active connections in onConnectionChangeHandler:\n",{"type":53,"tag":725,"props":9300,"children":9301},{"class":727,"line":1492},[9302],{"type":53,"tag":725,"props":9303,"children":9304},{"style":1984},[9305],{"type":58,"value":9306},"\u002F\u002F   await kvs.set('active-connections', [...activeConnections, connectionId]);\n",{"type":53,"tag":725,"props":9308,"children":9309},{"class":727,"line":1522},[9310,9315],{"type":53,"tag":725,"props":9311,"children":9312},{"style":1984},[9313],{"type":58,"value":9314},"\u002F\u002F   await kvs.setSecret(connectionId, configProperties);",{"type":53,"tag":725,"props":9316,"children":9317},{"style":1984},[9318],{"type":58,"value":9319},"  \u002F\u002F store credentials securely\n",{"type":53,"tag":725,"props":9321,"children":9322},{"class":727,"line":2009},[9323],{"type":53,"tag":725,"props":9324,"children":9325},{"emptyLinePlaceholder":1920},[9326],{"type":58,"value":1923},{"type":53,"tag":725,"props":9328,"children":9329},{"class":727,"line":26},[9330,9334,9338,9342,9346,9350,9354],{"type":53,"tag":725,"props":9331,"children":9332},{"style":1439},[9333],{"type":58,"value":6411},{"type":53,"tag":725,"props":9335,"children":9336},{"style":1666},[9337],{"type":58,"value":4682},{"type":53,"tag":725,"props":9339,"children":9340},{"style":1439},[9341],{"type":58,"value":1881},{"type":53,"tag":725,"props":9343,"children":9344},{"style":1858},[9345],{"type":58,"value":6424},{"type":53,"tag":725,"props":9347,"children":9348},{"style":1439},[9349],{"type":58,"value":7226},{"type":53,"tag":725,"props":9351,"children":9352},{"style":1858},[9353],{"type":58,"value":6443},{"type":53,"tag":725,"props":9355,"children":9356},{"style":1439},[9357],{"type":58,"value":2424},{"type":53,"tag":725,"props":9359,"children":9360},{"class":727,"line":2049},[9361,9365,9369,9373,9377,9381,9385,9389,9393,9397,9401,9405,9409,9413,9417],{"type":53,"tag":725,"props":9362,"children":9363},{"style":1858},[9364],{"type":58,"value":6463},{"type":53,"tag":725,"props":9366,"children":9367},{"style":1424},[9368],{"type":58,"value":7246},{"type":53,"tag":725,"props":9370,"children":9371},{"style":1439},[9372],{"type":58,"value":1881},{"type":53,"tag":725,"props":9374,"children":9375},{"style":1943},[9376],{"type":58,"value":1946},{"type":53,"tag":725,"props":9378,"children":9379},{"style":1424},[9380],{"type":58,"value":6586},{"type":53,"tag":725,"props":9382,"children":9383},{"style":1439},[9384],{"type":58,"value":89},{"type":53,"tag":725,"props":9386,"children":9387},{"style":1666},[9388],{"type":58,"value":7267},{"type":53,"tag":725,"props":9390,"children":9391},{"style":1993},[9392],{"type":58,"value":1891},{"type":53,"tag":725,"props":9394,"children":9395},{"style":1439},[9396],{"type":58,"value":1896},{"type":53,"tag":725,"props":9398,"children":9399},{"style":738},[9400],{"type":58,"value":7280},{"type":53,"tag":725,"props":9402,"children":9403},{"style":1439},[9404],{"type":58,"value":1896},{"type":53,"tag":725,"props":9406,"children":9407},{"style":1993},[9408],{"type":58,"value":571},{"type":53,"tag":725,"props":9410,"children":9411},{"style":1439},[9412],{"type":58,"value":7293},{"type":53,"tag":725,"props":9414,"children":9415},{"style":1993},[9416],{"type":58,"value":7298},{"type":53,"tag":725,"props":9418,"children":9419},{"style":1439},[9420],{"type":58,"value":1914},{"type":53,"tag":725,"props":9422,"children":9423},{"class":727,"line":2084},[9424,9428,9432,9436,9440,9444,9448,9452],{"type":53,"tag":725,"props":9425,"children":9426},{"style":1943},[9427],{"type":58,"value":7310},{"type":53,"tag":725,"props":9429,"children":9430},{"style":1993},[9431],{"type":58,"value":2667},{"type":53,"tag":725,"props":9433,"children":9434},{"style":1858},[9435],{"type":58,"value":1861},{"type":53,"tag":725,"props":9437,"children":9438},{"style":1424},[9439],{"type":58,"value":6481},{"type":53,"tag":725,"props":9441,"children":9442},{"style":1439},[9443],{"type":58,"value":7327},{"type":53,"tag":725,"props":9445,"children":9446},{"style":1424},[9447],{"type":58,"value":7246},{"type":53,"tag":725,"props":9449,"children":9450},{"style":1993},[9451],{"type":58,"value":571},{"type":53,"tag":725,"props":9453,"children":9454},{"style":1439},[9455],{"type":58,"value":1968},{"type":53,"tag":725,"props":9457,"children":9458},{"class":727,"line":2107},[9459,9463,9467,9471,9475,9479,9483,9487,9491,9495,9499,9503],{"type":53,"tag":725,"props":9460,"children":9461},{"style":1858},[9462],{"type":58,"value":7347},{"type":53,"tag":725,"props":9464,"children":9465},{"style":1424},[9466],{"type":58,"value":7352},{"type":53,"tag":725,"props":9468,"children":9469},{"style":1439},[9470],{"type":58,"value":1881},{"type":53,"tag":725,"props":9472,"children":9473},{"style":1943},[9474],{"type":58,"value":1946},{"type":53,"tag":725,"props":9476,"children":9477},{"style":1424},[9478],{"type":58,"value":6586},{"type":53,"tag":725,"props":9480,"children":9481},{"style":1439},[9482],{"type":58,"value":89},{"type":53,"tag":725,"props":9484,"children":9485},{"style":1666},[9486],{"type":58,"value":7373},{"type":53,"tag":725,"props":9488,"children":9489},{"style":1993},[9490],{"type":58,"value":1891},{"type":53,"tag":725,"props":9492,"children":9493},{"style":1424},[9494],{"type":58,"value":2791},{"type":53,"tag":725,"props":9496,"children":9497},{"style":1993},[9498],{"type":58,"value":1909},{"type":53,"tag":725,"props":9500,"children":9501},{"style":1439},[9502],{"type":58,"value":8183},{"type":53,"tag":725,"props":9504,"children":9505},{"style":1984},[9506],{"type":58,"value":9507},"  \u002F\u002F retrieve stored credentials\n",{"type":53,"tag":725,"props":9509,"children":9510},{"class":727,"line":2137},[9511,9515,9519,9523,9527,9531,9535,9539,9543,9547,9551,9555],{"type":53,"tag":725,"props":9512,"children":9513},{"style":1943},[9514],{"type":58,"value":7397},{"type":53,"tag":725,"props":9516,"children":9517},{"style":1993},[9518],{"type":58,"value":2667},{"type":53,"tag":725,"props":9520,"children":9521},{"style":1424},[9522],{"type":58,"value":7406},{"type":53,"tag":725,"props":9524,"children":9525},{"style":1993},[9526],{"type":58,"value":571},{"type":53,"tag":725,"props":9528,"children":9529},{"style":1943},[9530],{"type":58,"value":7415},{"type":53,"tag":725,"props":9532,"children":9533},{"style":1666},[9534],{"type":58,"value":6722},{"type":53,"tag":725,"props":9536,"children":9537},{"style":1993},[9538],{"type":58,"value":1891},{"type":53,"tag":725,"props":9540,"children":9541},{"style":1424},[9542],{"type":58,"value":2791},{"type":53,"tag":725,"props":9544,"children":9545},{"style":1439},[9546],{"type":58,"value":1981},{"type":53,"tag":725,"props":9548,"children":9549},{"style":1424},[9550],{"type":58,"value":7352},{"type":53,"tag":725,"props":9552,"children":9553},{"style":1993},[9554],{"type":58,"value":1909},{"type":53,"tag":725,"props":9556,"children":9557},{"style":1439},[9558],{"type":58,"value":1914},{"type":53,"tag":725,"props":9560,"children":9561},{"class":727,"line":2167},[9562],{"type":53,"tag":725,"props":9563,"children":9564},{"style":1439},[9565],{"type":58,"value":6650},{"type":53,"tag":725,"props":9567,"children":9568},{"class":727,"line":2202},[9569],{"type":53,"tag":725,"props":9570,"children":9571},{"style":1439},[9572],{"type":58,"value":6782},{"type":53,"tag":668,"props":9574,"children":9575},{},[],{"type":53,"tag":91,"props":9577,"children":9579},{"id":9578},"scripts",[9580],{"type":58,"value":9581},"Scripts",{"type":53,"tag":608,"props":9583,"children":9584},{},[9585,9605],{"type":53,"tag":612,"props":9586,"children":9587},{},[9588],{"type":53,"tag":616,"props":9589,"children":9590},{},[9591,9596,9601],{"type":53,"tag":620,"props":9592,"children":9593},{},[9594],{"type":58,"value":9595},"Script",{"type":53,"tag":620,"props":9597,"children":9598},{},[9599],{"type":58,"value":9600},"Skill directory",{"type":53,"tag":620,"props":9602,"children":9603},{},[9604],{"type":58,"value":629},{"type":53,"tag":631,"props":9606,"children":9607},{},[9608,9640],{"type":53,"tag":616,"props":9609,"children":9610},{},[9611,9619,9629],{"type":53,"tag":638,"props":9612,"children":9613},{},[9614],{"type":53,"tag":67,"props":9615,"children":9617},{"className":9616},[],[9618],{"type":58,"value":145},{"type":53,"tag":638,"props":9620,"children":9621},{},[9622,9627],{"type":53,"tag":67,"props":9623,"children":9625},{"className":9624},[],[9626],{"type":58,"value":3310},{"type":58,"value":9628}," (this skill)",{"type":53,"tag":638,"props":9630,"children":9631},{},[9632,9634],{"type":58,"value":9633},"Scaffold a new connector app — generates manifest.yml, src\u002Findex.ts, installs SDK. Run: ",{"type":53,"tag":67,"props":9635,"children":9637},{"className":9636},[],[9638],{"type":58,"value":9639},"python3 -m scripts.scaffold_connector",{"type":53,"tag":616,"props":9641,"children":9642},{},[9643,9652,9668],{"type":53,"tag":638,"props":9644,"children":9645},{},[9646],{"type":53,"tag":67,"props":9647,"children":9649},{"className":9648},[],[9650],{"type":58,"value":9651},"scripts\u002Fdeploy_forge_app.py",{"type":53,"tag":638,"props":9653,"children":9654},{},[9655,9661,9662,9667],{"type":53,"tag":67,"props":9656,"children":9658},{"className":9657},[],[9659],{"type":58,"value":9660},"skills\u002Fforge-app-builder\u002F",{"type":58,"value":2667},{"type":53,"tag":76,"props":9663,"children":9664},{},[9665],{"type":58,"value":9666},"different skill",{"type":58,"value":1909},{"type":53,"tag":638,"props":9669,"children":9670},{},[9671,9673],{"type":58,"value":9672},"Deploy and install on Jira. Run from the forge-app-builder directory: ",{"type":53,"tag":67,"props":9674,"children":9676},{"className":9675},[],[9677],{"type":58,"value":9678},"python3 -m scripts.deploy_forge_app",{"type":53,"tag":61,"props":9680,"children":9681},{},[9682,9684,9688,9690,9695],{"type":58,"value":9683},"The scaffold script is in this skill's directory. The deploy script is in the ",{"type":53,"tag":76,"props":9685,"children":9686},{},[9687],{"type":58,"value":3302},{"type":58,"value":9689}," skill directory — always ",{"type":53,"tag":67,"props":9691,"children":9693},{"className":9692},[],[9694],{"type":58,"value":1669},{"type":58,"value":9696}," there (or derive the path from this SKILL.md's location) before running it.",{"type":53,"tag":668,"props":9698,"children":9699},{},[],{"type":53,"tag":91,"props":9701,"children":9703},{"id":9702},"troubleshooting",[9704],{"type":58,"value":9705},"Troubleshooting",{"type":53,"tag":608,"props":9707,"children":9708},{},[9709,9725],{"type":53,"tag":612,"props":9710,"children":9711},{},[9712],{"type":53,"tag":616,"props":9713,"children":9714},{},[9715,9720],{"type":53,"tag":620,"props":9716,"children":9717},{},[9718],{"type":58,"value":9719},"Problem",{"type":53,"tag":620,"props":9721,"children":9722},{},[9723],{"type":58,"value":9724},"Action",{"type":53,"tag":631,"props":9726,"children":9727},{},[9728,9753,9789,9830,9859,9900,9934,9974,10004,10029,10052,10077,10105,10150],{"type":53,"tag":616,"props":9729,"children":9730},{},[9731,9741],{"type":53,"tag":638,"props":9732,"children":9733},{},[9734,9739],{"type":53,"tag":67,"props":9735,"children":9737},{"className":9736},[],[9738],{"type":58,"value":72},{"type":58,"value":9740}," not recognized in manifest",{"type":53,"tag":638,"props":9742,"children":9743},{},[9744,9746,9751],{"type":58,"value":9745},"Run ",{"type":53,"tag":67,"props":9747,"children":9749},{"className":9748},[],[9750],{"type":58,"value":517},{"type":58,"value":9752}," — it will identify the exact field causing the error",{"type":53,"tag":616,"props":9754,"children":9755},{},[9756,9765],{"type":53,"tag":638,"props":9757,"children":9758},{},[9759],{"type":53,"tag":67,"props":9760,"children":9762},{"className":9761},[],[9763],{"type":58,"value":9764},"TypeError: Cannot destructure property 'config' of 'event.payload'",{"type":53,"tag":638,"props":9766,"children":9767},{},[9768,9770,9775,9777,9782,9784],{"type":58,"value":9769},"Handler using ",{"type":53,"tag":67,"props":9771,"children":9773},{"className":9772},[],[9774],{"type":58,"value":207},{"type":58,"value":9776}," — change to ",{"type":53,"tag":67,"props":9778,"children":9780},{"className":9779},[],[9781],{"type":58,"value":199},{"type":58,"value":9783},". Forge passes request directly, not nested under ",{"type":53,"tag":67,"props":9785,"children":9787},{"className":9786},[],[9788],{"type":58,"value":191},{"type":53,"tag":616,"props":9790,"children":9791},{},[9792,9801],{"type":53,"tag":638,"props":9793,"children":9794},{},[9795],{"type":53,"tag":67,"props":9796,"children":9798},{"className":9797},[],[9799],{"type":58,"value":9800},"TypeError: Cannot read properties of undefined (reading 'set')",{"type":53,"tag":638,"props":9802,"children":9803},{},[9804,9806,9811,9812,9817,9819,9824,9825],{"type":58,"value":9805},"Using ",{"type":53,"tag":67,"props":9807,"children":9809},{"className":9808},[],[9810],{"type":58,"value":264},{"type":58,"value":243},{"type":53,"tag":67,"props":9813,"children":9815},{"className":9814},[],[9816],{"type":58,"value":256},{"type":58,"value":9818}," — switch to ",{"type":53,"tag":67,"props":9820,"children":9822},{"className":9821},[],[9823],{"type":58,"value":241},{"type":58,"value":243},{"type":53,"tag":67,"props":9826,"children":9828},{"className":9827},[],[9829],{"type":58,"value":231},{"type":53,"tag":616,"props":9831,"children":9832},{},[9833,9842],{"type":53,"tag":638,"props":9834,"children":9835},{},[9836],{"type":53,"tag":67,"props":9837,"children":9839},{"className":9838},[],[9840],{"type":58,"value":9841},"graph.setObjects is not a function",{"type":53,"tag":638,"props":9843,"children":9844},{},[9845,9847,9852,9854],{"type":58,"value":9846},"Wrong import — use ",{"type":53,"tag":67,"props":9848,"children":9850},{"className":9849},[],[9851],{"type":58,"value":303},{"type":58,"value":9853}," then call ",{"type":53,"tag":67,"props":9855,"children":9857},{"className":9856},[],[9858],{"type":58,"value":311},{"type":53,"tag":616,"props":9860,"children":9861},{},[9862,9878],{"type":53,"tag":638,"props":9863,"children":9864},{},[9865,9870,9872],{"type":53,"tag":67,"props":9866,"children":9868},{"className":9867},[],[9869],{"type":58,"value":517},{"type":58,"value":9871},": invalid scopes ",{"type":53,"tag":67,"props":9873,"children":9875},{"className":9874},[],[9876],{"type":58,"value":9877},"read\u002Fwrite:graph:teamwork",{"type":53,"tag":638,"props":9879,"children":9880},{},[9881,9883,9888,9889,9894,9895],{"type":58,"value":9882},"Replace with ",{"type":53,"tag":67,"props":9884,"children":9886},{"className":9885},[],[9887],{"type":58,"value":480},{"type":58,"value":389},{"type":53,"tag":67,"props":9890,"children":9892},{"className":9891},[],[9893],{"type":58,"value":487},{"type":58,"value":389},{"type":53,"tag":67,"props":9896,"children":9898},{"className":9897},[],[9899],{"type":58,"value":494},{"type":53,"tag":616,"props":9901,"children":9902},{},[9903,9919],{"type":53,"tag":638,"props":9904,"children":9905},{},[9906,9911,9913],{"type":53,"tag":67,"props":9907,"children":9909},{"className":9908},[],[9910],{"type":58,"value":517},{"type":58,"value":9912},": ",{"type":53,"tag":67,"props":9914,"children":9916},{"className":9915},[],[9917],{"type":58,"value":9918},"document should NOT have additional property 'function'",{"type":53,"tag":638,"props":9920,"children":9921},{},[9922,9927,9929],{"type":53,"tag":67,"props":9923,"children":9925},{"className":9924},[],[9926],{"type":58,"value":395},{"type":58,"value":9928}," is at the top level — move it inside ",{"type":53,"tag":67,"props":9930,"children":9932},{"className":9931},[],[9933],{"type":58,"value":403},{"type":53,"tag":616,"props":9935,"children":9936},{},[9937,9952],{"type":53,"tag":638,"props":9938,"children":9939},{},[9940,9945,9946],{"type":53,"tag":67,"props":9941,"children":9943},{"className":9942},[],[9944],{"type":58,"value":517},{"type":58,"value":9912},{"type":53,"tag":67,"props":9947,"children":9949},{"className":9948},[],[9950],{"type":58,"value":9951},"formConfiguration must have required property 'form'",{"type":53,"tag":638,"props":9953,"children":9954},{},[9955,9957,9962,9963,9968,9969],{"type":58,"value":9956},"Replace ",{"type":53,"tag":67,"props":9958,"children":9960},{"className":9959},[],[9961],{"type":58,"value":441},{"type":58,"value":4900},{"type":53,"tag":67,"props":9964,"children":9966},{"className":9965},[],[9967],{"type":58,"value":449},{"type":58,"value":1099},{"type":53,"tag":67,"props":9970,"children":9972},{"className":9971},[],[9973],{"type":58,"value":4971},{"type":53,"tag":616,"props":9975,"children":9976},{},[9977,9987],{"type":53,"tag":638,"props":9978,"children":9979},{},[9980,9985],{"type":53,"tag":67,"props":9981,"children":9983},{"className":9982},[],[9984],{"type":58,"value":517},{"type":58,"value":9986}," warning: deprecated egress entries",{"type":53,"tag":638,"props":9988,"children":9989},{},[9990,9991,9996,9998],{"type":58,"value":9745},{"type":53,"tag":67,"props":9992,"children":9994},{"className":9993},[],[9995],{"type":58,"value":4954},{"type":58,"value":9997}," to auto-convert bare URL strings to ",{"type":53,"tag":67,"props":9999,"children":10001},{"className":10000},[],[10002],{"type":58,"value":10003},"{ address: 'url' }",{"type":53,"tag":616,"props":10005,"children":10006},{},[10007,10017],{"type":53,"tag":638,"props":10008,"children":10009},{},[10010,10015],{"type":53,"tag":67,"props":10011,"children":10013},{"className":10012},[],[10014],{"type":58,"value":789},{"type":58,"value":10016}," command not found",{"type":53,"tag":638,"props":10018,"children":10019},{},[10020,10022,10027],{"type":58,"value":10021},"Does not exist in Forge CLI 12.x. Have user run ",{"type":53,"tag":67,"props":10023,"children":10025},{"className":10024},[],[10026],{"type":58,"value":582},{"type":58,"value":10028}," interactively to select a developer space",{"type":53,"tag":616,"props":10030,"children":10031},{},[10032,10042],{"type":53,"tag":638,"props":10033,"children":10034},{},[10035,10040],{"type":53,"tag":67,"props":10036,"children":10038},{"className":10037},[],[10039],{"type":58,"value":582},{"type":58,"value":10041}," fails with non-TTY error",{"type":53,"tag":638,"props":10043,"children":10044},{},[10045,10050],{"type":53,"tag":67,"props":10046,"children":10048},{"className":10047},[],[10049],{"type":58,"value":582},{"type":58,"value":10051}," needs an interactive terminal — ask the user to run it; then write manifest and source files into the created directory",{"type":53,"tag":616,"props":10053,"children":10054},{},[10055,10065],{"type":53,"tag":638,"props":10056,"children":10057},{},[10058,10063],{"type":53,"tag":67,"props":10059,"children":10061},{"className":10060},[],[10062],{"type":58,"value":3758},{"type":58,"value":10064}," not triggered",{"type":53,"tag":638,"props":10066,"children":10067},{},[10068,10070,10075],{"type":58,"value":10069},"Verify admin clicked \"Connect\" in Atlassian Administration → Connected apps; run ",{"type":53,"tag":67,"props":10071,"children":10073},{"className":10072},[],[10074],{"type":58,"value":598},{"type":58,"value":10076}," to confirm the function fires",{"type":53,"tag":616,"props":10078,"children":10079},{},[10080,10085],{"type":53,"tag":638,"props":10081,"children":10082},{},[10083],{"type":58,"value":10084},"Objects not appearing in Rovo Search",{"type":53,"tag":638,"props":10086,"children":10087},{},[10088,10090,10096,10098,10103],{"type":58,"value":10089},"Wait ~5 minutes for indexing; run ",{"type":53,"tag":67,"props":10091,"children":10093},{"className":10092},[],[10094],{"type":58,"value":10095},"forge logs -e development --since 15m",{"type":58,"value":10097}," to check for ",{"type":53,"tag":67,"props":10099,"children":10101},{"className":10100},[],[10102],{"type":58,"value":319},{"type":58,"value":10104}," errors",{"type":53,"tag":616,"props":10106,"children":10107},{},[10108,10120],{"type":53,"tag":638,"props":10109,"children":10110},{},[10111,10113,10118],{"type":58,"value":10112},"403 on ",{"type":53,"tag":67,"props":10114,"children":10116},{"className":10115},[],[10117],{"type":58,"value":295},{"type":58,"value":10119}," calls",{"type":53,"tag":638,"props":10121,"children":10122},{},[10123,10125,10130,10131,10136,10137,10142,10144],{"type":58,"value":10124},"Ensure ",{"type":53,"tag":67,"props":10126,"children":10128},{"className":10127},[],[10129],{"type":58,"value":480},{"type":58,"value":389},{"type":53,"tag":67,"props":10132,"children":10134},{"className":10133},[],[10135],{"type":58,"value":487},{"type":58,"value":389},{"type":53,"tag":67,"props":10138,"children":10140},{"className":10139},[],[10141],{"type":58,"value":494},{"type":58,"value":10143}," are in manifest scopes, then redeploy and ",{"type":53,"tag":67,"props":10145,"children":10147},{"className":10146},[],[10148],{"type":58,"value":10149},"forge install --upgrade",{"type":53,"tag":616,"props":10151,"children":10152},{},[10153,10163],{"type":53,"tag":638,"props":10154,"children":10155},{},[10156,10161],{"type":53,"tag":67,"props":10157,"children":10159},{"className":10158},[],[10160],{"type":58,"value":127},{"type":58,"value":10162}," required",{"type":53,"tag":638,"props":10164,"children":10165},{},[10166,10168,10176,10178],{"type":58,"value":10167},"Create API token at ",{"type":53,"tag":10169,"props":10170,"children":10174},"a",{"href":10171,"rel":10172},"https:\u002F\u002Fid.atlassian.com\u002Fmanage\u002Fapi-tokens",[10173],"nofollow",[10175],{"type":58,"value":10171},{"type":58,"value":10177},", then run ",{"type":53,"tag":67,"props":10179,"children":10181},{"className":10180},[],[10182],{"type":58,"value":127},{"type":53,"tag":668,"props":10184,"children":10185},{},[],{"type":53,"tag":668,"props":10187,"children":10188},{},[],{"type":53,"tag":91,"props":10190,"children":10192},{"id":10191},"naming-and-logo-guidelines",[10193],{"type":58,"value":10194},"Naming and Logo Guidelines",{"type":53,"tag":879,"props":10196,"children":10197},{},[10198,10223,10234],{"type":53,"tag":102,"props":10199,"children":10200},{},[10201,10202,10207,10209,10215,10216,10222],{"type":58,"value":1829},{"type":53,"tag":76,"props":10203,"children":10204},{},[10205],{"type":58,"value":10206},"official service name",{"type":58,"value":10208}," as the connector name (e.g. ",{"type":53,"tag":67,"props":10210,"children":10212},{"className":10211},[],[10213],{"type":58,"value":10214},"Google Drive",{"type":58,"value":6268},{"type":53,"tag":67,"props":10217,"children":10219},{"className":10218},[],[10220],{"type":58,"value":10221},"Drive Connector by Acme",{"type":58,"value":1909},{"type":53,"tag":102,"props":10224,"children":10225},{},[10226,10227,10232],{"type":58,"value":1829},{"type":53,"tag":76,"props":10228,"children":10229},{},[10230],{"type":58,"value":10231},"official service logo",{"type":58,"value":10233}," for icons — do not modify or combine with your own branding",{"type":53,"tag":102,"props":10235,"children":10236},{},[10237,10239,10244],{"type":58,"value":10238},"These guidelines apply only to the ",{"type":53,"tag":67,"props":10240,"children":10242},{"className":10241},[],[10243],{"type":58,"value":72},{"type":58,"value":10245}," module; your Forge app itself may use your own branding",{"type":53,"tag":10247,"props":10248,"children":10249},"style",{},[10250],{"type":58,"value":10251},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":10253,"total":2427},[10254,10274,10292,10309,10322,10333,10348,10364,10379,10385,10399,10409],{"slug":10255,"name":10255,"fn":10256,"description":10257,"org":10258,"tags":10259,"stars":10271,"repoUrl":10272,"updatedAt":10273},"capture-tasks-from-meeting-notes","create Jira tasks from meeting notes","Analyze meeting notes to find action items and create Jira tasks for assigned work. When an agent needs to: (1) Create Jira tasks or tickets from meeting notes, (2) Extract or find action items from notes or Confluence pages, (3) Parse meeting notes for assigned tasks, or (4) Analyze notes and generate tasks for team members. Identifies assignees, looks up account IDs, and creates tasks with proper context.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10260,10263,10265,10268],{"name":10261,"slug":10262,"type":15},"Automation","automation",{"name":10264,"slug":44,"type":15},"Jira",{"name":10266,"slug":10267,"type":15},"Meetings","meetings",{"name":10269,"slug":10270,"type":15},"Task Management","task-management",848,"https:\u002F\u002Fgithub.com\u002Fatlassian\u002Fatlassian-mcp-server","2026-07-12T07:58:45.323861",{"slug":10275,"name":10275,"fn":10276,"description":10277,"org":10278,"tags":10279,"stars":10271,"repoUrl":10272,"updatedAt":10291},"generate-status-report","generate project status reports for Confluence","Generate project status reports from Jira issues and publish to Confluence. When an agent needs to: (1) Create a status report for a project, (2) Summarize project progress or updates, (3) Generate weekly\u002Fdaily reports from Jira, (4) Publish status summaries to Confluence, or (5) Analyze project blockers and completion. Queries Jira issues, categorizes by status\u002Fpriority, and creates formatted reports for delivery managers and executives.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10280,10281,10284,10285,10288],{"name":9,"slug":8,"type":15},{"name":10282,"slug":10283,"type":15},"Confluence","confluence",{"name":10264,"slug":44,"type":15},{"name":10286,"slug":10287,"type":15},"Project Management","project-management",{"name":10289,"slug":10290,"type":15},"Reporting","reporting","2026-07-12T07:58:38.457696",{"slug":10293,"name":10293,"fn":10294,"description":10295,"org":10296,"tags":10297,"stars":10271,"repoUrl":10272,"updatedAt":10308},"jira-sprint-dashboard","create Jira sprint dashboards","Create a visual Jira sprint dashboard from Jira project, space, sprint, board, filter, JQL, work item keys, or Jira URL data. Use when the user asks for a Jira sprint dashboard, standup dashboard, sprint review, delivery review, engineering manager dashboard, WIP review, planning view, closeout view, or a visual snapshot of Jira work that is more useful than a flat report. Use the richest dashboard format supported by the current agent, such as Cursor Canvas, an interactive artifact, HTML, or Markdown.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10298,10301,10304,10305],{"name":10299,"slug":10300,"type":15},"Agile","agile",{"name":10302,"slug":10303,"type":15},"Dashboards","dashboards",{"name":10264,"slug":44,"type":15},{"name":10306,"slug":10307,"type":15},"Sprint Planning","sprint-planning","2026-07-12T07:58:41.031798",{"slug":10310,"name":10310,"fn":10311,"description":10312,"org":10313,"tags":10314,"stars":10271,"repoUrl":10272,"updatedAt":10321},"search-company-knowledge","search internal company knowledge bases","Search across company knowledge bases (Confluence, Jira, internal docs) to find and explain internal concepts, processes, and technical details. When an agent needs to: (1) Find or search for information about systems, terminology, processes, deployment, authentication, infrastructure, architecture, or technical concepts, (2) Search internal documentation, knowledge base, company docs, or our docs, (3) Explain what something is, how it works, or look up information, or (4) Synthesize information from multiple sources. Searches in parallel and provides cited answers.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10315,10316,10317,10318],{"name":10282,"slug":10283,"type":15},{"name":13,"slug":14,"type":15},{"name":10264,"slug":44,"type":15},{"name":10319,"slug":10320,"type":15},"Knowledge Management","knowledge-management","2026-07-12T07:58:39.684132",{"slug":10323,"name":10323,"fn":10324,"description":10325,"org":10326,"tags":10327,"stars":10271,"repoUrl":10272,"updatedAt":10332},"spec-to-backlog","convert Confluence specifications to Jira backlogs","Automatically convert Confluence specification documents into structured Jira backlogs with Epics and implementation tickets. When an agent needs to: (1) Create Jira tickets from a Confluence page, (2) Generate a backlog from a specification, (3) Break down a spec into implementation tasks, or (4) Convert requirements into Jira issues. Handles reading Confluence pages, analyzing specifications, creating Epics with proper structure, and generating detailed implementation tickets linked to the Epic.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10328,10329,10330,10331],{"name":10299,"slug":10300,"type":15},{"name":10282,"slug":10283,"type":15},{"name":10264,"slug":44,"type":15},{"name":10286,"slug":10287,"type":15},"2026-07-12T07:58:37.200385",{"slug":10334,"name":10334,"fn":10335,"description":10336,"org":10337,"tags":10338,"stars":10271,"repoUrl":10272,"updatedAt":10347},"triage-issue","triage bug reports in Jira","Intelligently triage bug reports and error messages by searching for duplicates in Jira and offering to create new issues or add comments to existing ones. When an agent needs to: (1) Triage a bug report or error message, (2) Check if an issue is a duplicate, (3) Find similar past issues, (4) Create a new bug ticket with proper context, or (5) Add information to an existing ticket. Searches Jira for similar issues, identifies duplicates, checks fix history, and helps create well-structured bug reports.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10339,10342,10343,10344],{"name":10340,"slug":10341,"type":15},"Debugging","debugging",{"name":10264,"slug":44,"type":15},{"name":10286,"slug":10287,"type":15},{"name":10345,"slug":10346,"type":15},"Triage","triage","2026-07-12T07:58:33.007343",{"slug":3302,"name":3302,"fn":10349,"description":10350,"org":10351,"tags":10352,"stars":22,"repoUrl":23,"updatedAt":10363},"build and deploy Atlassian Forge apps","Guides building, deploying, troubleshooting, and installing Atlassian Forge apps — custom extensions built with the Forge CLI (forge create, forge deploy, forge install). Use when the user wants to create a Forge app (issue panels, dashboard gadgets, Confluence macros, global pages), is encountering Forge CLI errors or deployment issues (e.g. forge install failures, environment errors), or needs help with Forge-specific concepts like resolvers, UI Kit, manifest scopes, or developer spaces. Do not use for general Jira configuration, automation rules, JQL queries, or Atlassian REST API usage outside of a Forge app context.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10353,10354,10357,10360],{"name":9,"slug":8,"type":15},{"name":10355,"slug":10356,"type":15},"CLI","cli",{"name":10358,"slug":10359,"type":15},"Deployment","deployment",{"name":10361,"slug":10362,"type":15},"Plugin Development","plugin-development","2026-07-12T07:58:52.007851",{"slug":10365,"name":10365,"fn":10366,"description":10367,"org":10368,"tags":10369,"stars":22,"repoUrl":23,"updatedAt":10378},"forge-app-review","review Atlassian Forge app readiness","Performs a lightweight pre-release readiness review of Atlassian Forge apps across manifest\u002Fmodule wiring, architecture, runtime compatibility, dependency posture, tests, deploy readiness, and obvious security, cost, or reliability smells. Use when the user asks \"review my Forge app\", \"pre-deploy check\", \"is this app ready to ship\", \"review manifest\", \"general app review\", \"release readiness\", or asks for a broad quality pass. Do not use for deep security audits\u002FSAST\u002Fexploitability review, cost optimization, or diagnosing a known broken app; route those to forge-security-review, forge-cost-optimizer, or forge-debugger respectively.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10370,10371,10374,10375],{"name":9,"slug":8,"type":15},{"name":10372,"slug":10373,"type":15},"Code Analysis","code-analysis",{"name":10358,"slug":10359,"type":15},{"name":10376,"slug":10377,"type":15},"QA","qa","2026-07-12T07:58:50.744672",{"slug":4,"name":4,"fn":5,"description":6,"org":10380,"tags":10381,"stars":22,"repoUrl":23,"updatedAt":24},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10382,10383,10384],{"name":20,"slug":21,"type":15},{"name":17,"slug":18,"type":15},{"name":13,"slug":14,"type":15},{"slug":10386,"name":10386,"fn":10387,"description":10388,"org":10389,"tags":10390,"stars":22,"repoUrl":23,"updatedAt":10398},"forge-cost-optimizer","optimize Atlassian Forge platform costs","Optimizes Atlassian Forge apps to reduce platform consumption and avoid unnecessary costs using Atlassian's \"Optimise Forge platform costs\" guidance. Use when the user asks to optimize Forge app costs, reduce Forge invocations, lower GB-seconds, reduce storage or log usage, tune memory, replace polling, improve scheduled triggers, reduce KVS writes, move work to the frontend, use bridge APIs, batch API calls, add caching, or evaluate Forge Remote trade-offs. By default, perform an audit first and offer to make the recommended changes after presenting the audit. Only modify files immediately when the user explicitly asks the agent to implement or apply optimizations.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10391,10392,10395],{"name":9,"slug":8,"type":15},{"name":10393,"slug":10394,"type":15},"Cost Optimization","cost-optimization",{"name":10396,"slug":10397,"type":15},"Operations","operations","2026-07-12T07:58:53.557299",{"slug":10400,"name":10400,"fn":10401,"description":10402,"org":10403,"tags":10404,"stars":22,"repoUrl":23,"updatedAt":10408},"forge-debugger","diagnose and fix Atlassian Forge apps","Diagnoses and fixes issues in Atlassian Forge apps. Use this skill whenever a Forge app has errors, crashes, shows blank UI, fails to deploy, doesn't appear after installation, has permission issues, or produces unexpected output. Trigger on any mention of forge logs, forge deploy errors, resolver errors, blank panels, missing scopes, Custom UI not rendering, production vs dev discrepancies, or any Jira\u002FConfluence app that \"stopped working\". Also trigger when the user asks to debug, troubleshoot, investigate, or fix a Forge app issue — even if they haven't used the word \"Forge\" but describe a Jira panel or Confluence macro acting up.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10405,10406,10407],{"name":9,"slug":8,"type":15},{"name":10340,"slug":10341,"type":15},{"name":10358,"slug":10359,"type":15},"2026-07-12T07:58:47.226713",{"slug":10410,"name":10410,"fn":10411,"description":10412,"org":10413,"tags":10414,"stars":22,"repoUrl":23,"updatedAt":10422},"forge-security-review","perform security reviews for Forge apps","Performs a white-box security review of Atlassian Forge apps using structured, Forge-specific security rules and evidence-driven reporting. Use when the user asks for a Forge security review, security audit, vuln assessment, pentest-style code review, authz review, tenant isolation analysis, web trigger hardening, or static analysis execution for a Forge app.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10415,10418,10419],{"name":10416,"slug":10417,"type":15},"Audit","audit",{"name":10372,"slug":10373,"type":15},{"name":10420,"slug":10421,"type":15},"Security","security","2026-07-12T07:58:54.806538",{"items":10424,"total":2009},[10425,10432,10439,10445,10451,10457],{"slug":3302,"name":3302,"fn":10349,"description":10350,"org":10426,"tags":10427,"stars":22,"repoUrl":23,"updatedAt":10363},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10428,10429,10430,10431],{"name":9,"slug":8,"type":15},{"name":10355,"slug":10356,"type":15},{"name":10358,"slug":10359,"type":15},{"name":10361,"slug":10362,"type":15},{"slug":10365,"name":10365,"fn":10366,"description":10367,"org":10433,"tags":10434,"stars":22,"repoUrl":23,"updatedAt":10378},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10435,10436,10437,10438],{"name":9,"slug":8,"type":15},{"name":10372,"slug":10373,"type":15},{"name":10358,"slug":10359,"type":15},{"name":10376,"slug":10377,"type":15},{"slug":4,"name":4,"fn":5,"description":6,"org":10440,"tags":10441,"stars":22,"repoUrl":23,"updatedAt":24},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10442,10443,10444],{"name":20,"slug":21,"type":15},{"name":17,"slug":18,"type":15},{"name":13,"slug":14,"type":15},{"slug":10386,"name":10386,"fn":10387,"description":10388,"org":10446,"tags":10447,"stars":22,"repoUrl":23,"updatedAt":10398},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10448,10449,10450],{"name":9,"slug":8,"type":15},{"name":10393,"slug":10394,"type":15},{"name":10396,"slug":10397,"type":15},{"slug":10400,"name":10400,"fn":10401,"description":10402,"org":10452,"tags":10453,"stars":22,"repoUrl":23,"updatedAt":10408},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10454,10455,10456],{"name":9,"slug":8,"type":15},{"name":10340,"slug":10341,"type":15},{"name":10358,"slug":10359,"type":15},{"slug":10410,"name":10410,"fn":10411,"description":10412,"org":10458,"tags":10459,"stars":22,"repoUrl":23,"updatedAt":10422},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[10460,10461,10462],{"name":10416,"slug":10417,"type":15},{"name":10372,"slug":10373,"type":15},{"name":10420,"slug":10421,"type":15}]