Generate Component Markdown
trestle_author_component_generateGenerates editable Markdown files for each control implementation a component-definition claims, so authors can write implementation prose and YAML headers for later assembly.
Instructions
Generate component in markdown form from a component-definition in the trestle workspace.
This writes one markdown file per control implementation, per component, under
///. The markdown is where an author writes
the implementation prose and the rule/parameter yaml header that
trestle_author_component_assemble reads back.
Note that generate only writes what the component-definition already declares: it will not create implemented requirements for controls the component-definition does not claim.
Args: params (TrestleAuthorComponentGenerateInput): Input parameters with: - name (str): Source component-definition model name (required) - output (str): Output markdown folder (required) - force_overwrite (bool): Overwrite existing markdown content, discarding edits (default: false) - trestle_root (Optional[str]): Trestle workspace root path - verbose (bool): Display verbose output
Returns: str: Success or error message
Examples:
- Use when: "Generate editable markdown for this component definition"
- Use when: "Let me write implementation prose for each control a
component claims"
- Don't use when: There is no component-definition in the workspace yet;
import one, or create one with trestle_task_csv_to_oscal_cd.
- Don't use when: You only want to regenerate without losing edits —
force_overwrite discards author prose.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"params": "<params>"
},
"name": "trestle_author_component_generate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |