# blackteal-energy/github-issues-asana-tasks-action architecture

> Architecture diagram of the GitHub repository blackteal-energy/github-issues-asana-tasks-action, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/blackteal-energy/github-issues-asana-tasks-action
- Repository: https://github.com/blackteal-energy/github-issues-asana-tasks-action

## Overview

This GitHub Action mirrors GitHub Issues into Asana: it extracts a project ID from the issue body, creates a task for new issues, adds a story for new comments, and updates task completion on close or reopen. The entry point owns event dispatch and invokes the relevant transformations and Asana operations. The graph preserves the distinct conversion, lookup, creation, comment, and completion stages. Relationships are based on the shown entry point, module imports/calls, and README workflow; unsampled behavior is not inferred.

Main entry points: [`index.js`](https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/index.js) (Action entry), [`lib/asana-task-add-story.js`](https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/asana-task-add-story.js) (Comment story), [`lib/util/issue-to-task.js`](https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/util/issue-to-task.js) (Issue conversion), [`lib/util/comment-to-story.js`](https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/util/comment-to-story.js) (Comment conversion)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dispatch["Event dispatch"]
  node_entry["Action entry<br/>[index.js]"]
end

subgraph group_conversion["Issue conversion"]
  node_project["Project ID parser"]
  node_issueconvert["Issue conversion<br/>[issue-to-task.js]"]
  node_commentconvert["Comment conversion"]
  node_markdown["Markdown renderer"]
end

subgraph group_asana["Asana operations"]
  node_lookup["Task lookup<br/>[asana-task-find.js]"]
  node_create["Task creation"]
  node_story["Comment story"]
  node_completion["Task completion"]
end

node_github(("GitHub events"))
node_asanaapi["Asana API"]

node_github -->|"triggers action"| node_entry
node_entry -->|"extracts project"| node_project
node_entry -->|"converts issue"| node_issueconvert
node_entry -->|"searches task"| node_lookup
node_entry -->|"creates task"| node_create
node_entry -->|"sets completion"| node_completion
node_entry -->|"adds comment"| node_story
node_issueconvert -->|"renders notes"| node_markdown
node_commentconvert -->|"renders story"| node_markdown
node_story -->|"converts comment"| node_commentconvert
node_lookup -->|"queries project tasks"| node_asanaapi
node_create -->|"creates task"| node_asanaapi
node_story -->|"creates story"| node_asanaapi
node_completion -->|"updates task"| node_asanaapi

click node_entry "https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/index.js"
click node_project "https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/util/project-id-from-url.js"
click node_issueconvert "https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/util/issue-to-task.js"
click node_commentconvert "https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/util/comment-to-story.js"
click node_markdown "https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/util/markdown-to-asana-html.js"
click node_lookup "https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/asana-task-find.js"
click node_create "https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/asana-task-create.js"
click node_story "https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/asana-task-add-story.js"
click node_completion "https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/asana-task-completed.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry toneBlue
class node_project,node_issueconvert,node_commentconvert,node_markdown toneAmber
class node_lookup,node_create,node_story,node_completion,node_asanaapi toneMint
class node_github toneIndigo
```

## Components

### Event dispatch

- [Action entry](https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/index.js): `index.js`

### Issue conversion

- [Project ID parser](https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/util/project-id-from-url.js): `lib/util/project-id-from-url.js`
- [Issue conversion](https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/util/issue-to-task.js): `lib/util/issue-to-task.js`
- [Comment conversion](https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/util/comment-to-story.js): `lib/util/comment-to-story.js`
- [Markdown renderer](https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/util/markdown-to-asana-html.js): `lib/util/markdown-to-asana-html.js`

### Asana operations

- [Task lookup](https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/asana-task-find.js): `lib/asana-task-find.js`
- [Task creation](https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/asana-task-create.js): `lib/asana-task-create.js`
- [Comment story](https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/asana-task-add-story.js): `lib/asana-task-add-story.js`
- [Task completion](https://github.com/blackteal-energy/github-issues-asana-tasks-action/blob/main/lib/asana-task-completed.js): `lib/asana-task-completed.js`

### Other components

- **GitHub events**
- **Asana API**

## Connections

- GitHub events → Action entry: triggers action (evidence: `README.md`)
- Action entry → Project ID parser: extracts project (evidence: `index.js`)
- Action entry → Issue conversion: converts issue (evidence: `index.js`)
- Action entry → Task lookup: searches task (evidence: `index.js`)
- Action entry → Task creation: creates task (evidence: `index.js`)
- Action entry → Task completion: sets completion (evidence: `index.js`)
- Action entry → Comment story: adds comment (evidence: `index.js`)
- Issue conversion → Markdown renderer: renders notes (evidence: `lib/util/issue-to-task.js`)
- Comment conversion → Markdown renderer: renders story (evidence: `lib/util/comment-to-story.js`)
- Comment story → Comment conversion: converts comment (evidence: `lib/asana-task-add-story.js`)
- Task lookup → Asana API: queries project tasks (evidence: `lib/asana-task-find.js`)
- Task creation → Asana API: creates task (evidence: `lib/asana-task-create.js`)
- Comment story → Asana API: creates story (evidence: `lib/asana-task-add-story.js`)
- Task completion → Asana API: updates task (evidence: `lib/asana-task-completed.js`)
