Skip to content

Add CodeBoarding architecture analysis - #1

Merged
ivanmilevtues merged 1 commit into
mainfrom
codeboarding/setup-action
Oct 10, 2026
Merged

ivanmilevtues merged 1 commit into
mainfrom
codeboarding/setup-action

Conversation

@ivanmilevtues

@ivanmilevtues ivanmilevtues commented Oct 10, 2026 •

Copy link
Copy Markdown
Member

Preview first, merge when ready

View your map · Configure & merge

The preview runs on this pull request. Merge the workflow to keep maps updated. Settings can be changed in this same pull request before merging.

This PR adds CodeBoarding in one workflow file, codeboarding.yml, with two jobs:

  • review keeps an architecture-diff comment current on pull requests and publishes their diagrams for the viewer.
  • sync saves the diagram of main on pushes and manual runs.

Sync delivery

Sync commits the generated baseline directly to main.

Works out of the box

Just merge it: the Action runs on the free tier, with no secret to add. The
id-token: write permission lets it identify your repo to CodeBoarding’s hosted LLM,
metered against a weekly limit for the repository owner.

Want more, or unmetered, usage?

Switching is a change to this workflow file rather than a secret you add, because the
file names which credentials a run uses. Use Configure & merge in the viewer to pick:

  • a CodeBoarding plan (unmetered, and raises the analysis-depth ceiling from 3 to 10), or
  • your own provider key: OpenRouter, Anthropic, OpenAI, Google, AWS Bedrock and
    others.

Before merging, this updates the same setup pull request and tells you which secret to
add under Settings → Secrets and variables → Actions.
After merging, use repository settings in the dashboard to open an update PR.

Opened for you by CodeBoarding.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 10, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-10T19:15:52.734905Z 1ca9104 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@github-actions

github-actions Bot commented Oct 10, 2026 •

Copy link
Copy Markdown

CodeBoarding review

Status: 0 changed components (no analysed file changed)

See the full change in CodeBoarding.

graph LR
    n_Coding_Agent_Application["Coding Agent Application"]
    n_AI_Model_Providers_and_Runtime["AI Model Providers and Runtime"]
    n_Durable_Execution_Engine["Durable Execution Engine"]
    n_Protocol_and_Service_Mesh["Protocol and Service Mesh"]
    n_Terminal_User_Interface_Framework["Terminal User Interface Framework"]
    n_Build_and_Maintenance_Scripts["Build and Maintenance Scripts"]
    n_Model_Context_Protocol_Client["Model Context Protocol Client"]
    n_Codemode_Sandbox_Runtime["Codemode Sandbox Runtime"]
    n_Telemetry_Instrumentation["Telemetry Instrumentation"]
    n_Coding_Agent_Application -- "queries models and configures agent execution v…" --> n_AI_Model_Providers_and_Runtime
    n_Coding_Agent_Application -- "renders terminal interface with" --> n_Terminal_User_Interface_Framework
    n_Coding_Agent_Application -- "configures workflows and extensions in" --> n_Durable_Execution_Engine
    n_Coding_Agent_Application -- "establishes connections and binds services via" --> n_Protocol_and_Service_Mesh
    n_Coding_Agent_Application -- "authorizes and communicates through" --> n_Model_Context_Protocol_Client
    n_Coding_Agent_Application -- "executes sandboxed code via" --> n_Codemode_Sandbox_Runtime
    n_AI_Model_Providers_and_Runtime -- "prompts user login via" --> n_Coding_Agent_Application
    n_Durable_Execution_Engine -- "invokes model runtime completions in" --> n_Coding_Agent_Application
    n_Durable_Execution_Engine -- "queries model configurations from" --> n_AI_Model_Providers_and_Runtime
    n_Durable_Execution_Engine -- "utilizes context and serialization utilities fr…" --> n_Protocol_and_Service_Mesh
    n_Protocol_and_Service_Mesh -- "hosts and manages services defined in" --> n_Coding_Agent_Application
    n_Protocol_and_Service_Mesh -- "replicates committed state from" --> n_Durable_Execution_Engine
    n_Terminal_User_Interface_Framework -- "triggers user interface rendering in" --> n_Coding_Agent_Application
    n_Build_and_Maintenance_Scripts -- "verifies and generates catalog definitions from" --> n_AI_Model_Providers_and_Runtime
    n_Build_and_Maintenance_Scripts -- "invokes session and storage utilities in" --> n_Coding_Agent_Application
    n_Build_and_Maintenance_Scripts -- "manages session documents via" --> n_Durable_Execution_Engine
    n_Model_Context_Protocol_Client -- "persists OAuth credentials via" --> n_Coding_Agent_Application
    n_Codemode_Sandbox_Runtime -- "calls back into tool execution in" --> n_Coding_Agent_Application
    classDef added fill:#1f883d,stroke:#0b5d23,color:#ffffff;
    classDef modified fill:#bf8700,stroke:#7d4e00,color:#ffffff;
    classDef deleted fill:#cf222e,stroke:#82071e,color:#ffffff,stroke-dasharray:5 3;
Loading

download artifacts · run 38078815308

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1ca91041ca

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

actions: read # continue from an analysis an earlier run published
id-token: write # identifies this repo to CodeBoarding's hosted tier
steps:
- uses: CodeBoarding/CodeBoarding-action@refactor/review-baseline-pipeline

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Pin the privileged action to an immutable commit

In the sync job, every push to main executes a mutable upstream branch while granting contents: write and id-token: write. If that branch is force-pushed, compromised, or receives an unsafe update, the new code immediately runs with permission to modify this repository. Pin both action uses to a reviewed full commit SHA instead.

Useful? React with 👍 / 👎.

Comment on lines +39 to +40
(github.event_name == 'pull_request' && github.event.action != 'closed' &&
github.event.pull_request.head.repo.full_name == github.repository) ||

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Handle Dependabot pull requests before starting the review job

For a Dependabot PR, head.repo.full_name still equals this repository, so this condition starts the job even though GitHub treats Dependabot-triggered workflows like fork workflows and restricts their token to read-only access. The action relies on id-token: write for hosted authentication and pull-requests: write/issues: write to publish its result, so these runs cannot complete the configured review flow. Exclude Dependabot here or route it through a separately secured privileged workflow.

Useful? React with 👍 / 👎.

@ivanmilevtues
ivanmilevtues merged commit 9207741 into main Oct 10, 2026
5 checks passed
@ivanmilevtues
ivanmilevtues deleted the codeboarding/setup-action branch October 10, 2026 19:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant