# aidevme/solution-blueprint-ci architecture

> Architecture diagram of the GitHub repository aidevme/solution-blueprint-ci, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aidevme/solution-blueprint-ci
- Repository: https://github.com/aidevme/solution-blueprint-ci

## Overview

solution-blueprint-ci is an early-stage CI documentation engine for Dataverse and Power Platform solutions. Users provide an environment, solution names, credentials, and output options through the CLI, GitHub Action, or Azure DevOps task; wrappers pass those options to the core, which is intended to query Dataverse and generate blueprint outputs. The sampled generator is still a stub, so analysis and export stages are documented capabilities rather than confirmed runtime behavior. The README supports the wrapper flow and planned capabilities; source excerpts establish CLI parsing and the token-based client.

Main entry points: [`packages/core/src/generate.ts`](https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/core/src/generate.ts) (Blueprint generation), [`packages/core/src/dataverse/TokenDataverseClient.ts`](https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/core/src/dataverse/TokenDataverseClient.ts) (Dataverse client), [`packages/cli/src/index.ts`](https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/cli/src/index.ts) (CLI command), [`packages/cli/src/args.ts`](https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/cli/src/args.ts) (CLI options)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entrypoints["CI entrypoints"]
  node_cli["CLI command<br/>[index.ts]"]
  node_cliargs["CLI options<br/>[args.ts]"]
  node_gh["GitHub Action<br/>[index.ts]"]
  node_ado["ADO task<br/>[index.ts]"]
end

subgraph group_core["Blueprint core"]
  node_options["Option parsing<br/>[options.ts]"]
  node_generator["Blueprint generation<br/>[generate.ts]"]
  node_analysis["Solution analysis"]
  node_export["Blueprint exports"]
end

subgraph group_connectivity["Dataverse access"]
  node_credentials["Credential loading<br/>[tokenProvider.ts]"]
  node_client["Dataverse client"]
  node_clientcontract["Client contract"]
end

node_user(("Pipeline user"))
node_entra{{"Entra ID"}}
node_dataverse[("Dataverse environment")]

node_user -->|"runs"| node_cli
node_user -->|"configures"| node_gh
node_user -->|"configures"| node_ado
node_cli -->|"parses with"| node_cliargs
node_cliargs -->|"uses parsers"| node_options
node_cli -->|"calls"| node_generator
node_gh -->|"delegates to"| node_generator
node_ado -->|"delegates to"| node_generator
node_generator -.->|"intended to analyze"| node_analysis
node_generator -.->|"intended to export"| node_export
node_credentials -->|"requests token"| node_entra
node_client -->|"gets token"| node_credentials
node_client -->|"implements"| node_clientcontract
node_client -->|"queries"| node_dataverse
node_generator -.->|"intended to query"| node_client

click node_cli "https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/cli/src/index.ts"
click node_cliargs "https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/cli/src/args.ts"
click node_gh "https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/gh-action/src/index.ts"
click node_ado "https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/ado-task/src/index.ts"
click node_options "https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/core/src/options.ts"
click node_generator "https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/core/src/generate.ts"
click node_analysis "https://github.com/aidevme/solution-blueprint-ci/tree/main/packages/core/src"
click node_export "https://github.com/aidevme/solution-blueprint-ci/tree/main/packages/core/src"
click node_credentials "https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/core/src/dataverse/tokenProvider.ts"
click node_client "https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/core/src/dataverse/TokenDataverseClient.ts"
click node_clientcontract "https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/core/src/dataverse/IDataverseClient.ts"

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_cli,node_cliargs,node_gh,node_ado,node_user toneBlue
class node_options,node_generator,node_analysis,node_export,node_dataverse toneAmber
class node_credentials,node_client,node_clientcontract toneMint
class node_entra toneIndigo
```

## Components

### CI entrypoints

- [CLI command](https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/cli/src/index.ts): `packages/cli/src/index.ts`
- [CLI options](https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/cli/src/args.ts): `packages/cli/src/args.ts`
- [GitHub Action](https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/gh-action/src/index.ts): `packages/gh-action/src/index.ts`
- [ADO task](https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/ado-task/src/index.ts): `packages/ado-task/src/index.ts`

### Blueprint core

- [Option parsing](https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/core/src/options.ts): `packages/core/src/options.ts`
- [Blueprint generation](https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/core/src/generate.ts): `packages/core/src/generate.ts`
- [Solution analysis](https://github.com/aidevme/solution-blueprint-ci/tree/main/packages/core/src): `packages/core/src`
- [Blueprint exports](https://github.com/aidevme/solution-blueprint-ci/tree/main/packages/core/src): `packages/core/src`

### Dataverse access

- [Credential loading](https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/core/src/dataverse/tokenProvider.ts): `packages/core/src/dataverse/tokenProvider.ts`
- [Dataverse client](https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/core/src/dataverse/TokenDataverseClient.ts): `packages/core/src/dataverse/TokenDataverseClient.ts`
- [Client contract](https://github.com/aidevme/solution-blueprint-ci/blob/main/packages/core/src/dataverse/IDataverseClient.ts): `packages/core/src/dataverse/IDataverseClient.ts`

### Other components

- **Pipeline user**
- **Entra ID**
- **Dataverse environment**

## Connections

- Pipeline user → CLI command: runs (evidence: `README.md`)
- Pipeline user → GitHub Action: configures (evidence: `README.md`)
- Pipeline user → ADO task: configures (evidence: `README.md`)
- CLI command → CLI options: parses with (evidence: `packages/cli/src/index.ts`)
- CLI options → Option parsing: uses parsers (evidence: `packages/cli/src/args.ts`)
- CLI command → Blueprint generation: calls (evidence: `packages/cli/src/index.ts`)
- GitHub Action → Blueprint generation: delegates to (evidence: `README.md`)
- ADO task → Blueprint generation: delegates to (evidence: `README.md`)
- Blueprint generation → Solution analysis: intended to analyze (evidence: `README.md`)
- Blueprint generation → Blueprint exports: intended to export (evidence: `README.md`)
- Credential loading → Entra ID: requests token (evidence: `packages/core/src/dataverse/tokenProvider.ts`)
- Dataverse client → Credential loading: gets token (evidence: `packages/core/src/dataverse/TokenDataverseClient.ts`)
- Dataverse client → Client contract: implements (evidence: `packages/core/src/dataverse/TokenDataverseClient.ts`)
- Dataverse client → Dataverse environment: queries (evidence: `packages/core/src/dataverse/TokenDataverseClient.ts`)
- Blueprint generation → Dataverse client: intended to query
