get_modeling_project
Retrieves comprehensive information about a specific SysML v2 project.
Purpose
This tool provides a complete project overview with configurable options to include or exclude branches and commits, making it ideal for understanding project structure, identifying available versions, and tracking recent development activity. Returns detailed information about each branch (including default branch, head commits) and recent commits with author and timestamp data.
Tags: AM Read Basic
Input parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id |
string | Yes | - | Project UUID or name |
include_branches |
boolean | No | true | Include branch information |
include_commits |
boolean | No | true | Include commit history |
commit_limit |
integer | No | 10 | Max recent commits (min: 1) |
Output schema
| Field | Type | Description |
|---|---|---|
| project.id | string | Unique identifier for the project |
| project.name | string | Name of the project |
| project.description | string | Description of the project |
| project.is_library | boolean | Indicates if the project is a library project |
| project.default_configuration_id | string | UUID of the default branch configuration |
| project.created.timestamp | string | ISO 8601 timestamp when the project was created |
| project.created.by | string | UUID of the user who created the project |
| project.modified.timestamp | string | ISO 8601 timestamp when the project was last modified |
| project.modified.by | string | UUID of the user who last modified the project |
| branches[].id | string | Unique identifier for the branch |
| branches[].name | string | Name of the branch |
| branches[].description | string | Description of the branch |
| branches[].is_default | boolean | Indicates if this is the default branch |
| branches[].head_commit | string | UUID of the latest commit on this branch |
| branches[].created | string | ISO 8601 timestamp when the branch was created |
| recent_commits[].id | string | Unique identifier for the commit |
| recent_commits[].description | string | Commit message describing the changes |
| recent_commits[].created | string | ISO 8601 timestamp when the commit was created |
| recent_commits[].author | string | UUID of the user who created the commit |
| recent_commits[].parent_commit | string | UUID of the parent commit in the version chain |
Common use cases
- Project overview
- Get complete project information for analysis. For example: Show me details about the vehicle system project.
- Branch discovery
- Find available branches for version exploration. For example: What branches exist in this project?
- Recent activity
- View recent commits to understand latest changes. For example: What are the recent changes to this project?