StigGenerateMarkdownTask
Generates Markdown documentation for a single element (viewpoint pages, metric tables, direct P7 diagram links, and known-gap sections).
Up-to-date capable: declares @OutputFile / @OutputDirectory outputs. If model classes, metric reports, and configuration inputs are unchanged, Gradle skips re-execution.
Not cacheable: generates documentation files in place. Not yet audited for cache correctness — output depends on many dynamic inputs (diagram files, metric reports, compiled model state) whose path-sensitivity annotations have not been fully verified.
Properties
Root of the git repository that contains this module's sources. Used together with projectRoot to compute the path prefix from git root to project root so that GitHub blob URLs in check-results tables point to the correct location (e.g. models/stig-project/activities/...).
Path of the git repository root that contains this module's sources. Used together with projectRoot to compute source-link path prefixes. Tracked as a scalar path for the same reason as dokkaBuildProvenanceRepositoryRootPath.
Project checkout root whose provenance row may receive authoritative CI review metadata.
Consumer project version (e.g. "1.2.3" or "1.2.3-SNAPSHOT").
Path of the git repository root used for fallback provenance. This is tracked as a scalar path, not as an input directory: the task reads git metadata from this location, but it must not scan the whole checkout and accidentally consume other tasks' build outputs under it.
STIG plugin version (e.g. "1.1.0" or "dev").
Actual publication directories and module names, including referenced modules in a local preview.
When true, image-asset paths are computed for the Dokka module-preview layout (build/dokka/module-preview/) where the module name is a single flat directory (dots preserved), instead of the aggregate layout where dots become nested directories. Defaults to false (aggregate mode).
Package prefix combined with dokkaBuildProvenanceModuleName and the viewpoint name to identify report assets uniquely across modules. Package includes use the module's source package directories, independently of its Gradle path.
Modules whose model pages exist in the selected HTML publication.
Module source-tree roots scanned by the scaffold pass for per-package Markdown headers (# Package X). Typical values: this module's src/main/kotlin and stig/src/main/kotlin. Empty / unset means scaffold-writing is a no-op.
Generated roots have local IDEA links, never links to nonexistent Git source files.
Canonical model problems from stigCheckModel, used directly by HTML rendering.
Model-check inventory used to render invocation and result counts without reading derived SARIF.
Libraries have declaration documentation but no architectural CREATE viewpoint pages.
Shared report preparation supplies locations and issues without loading the model again.
Canonical task problem logs emitted by com.stigway.gradle.support.GradleStigProblemReporter. These are rendered on the activity root page as a separate task-problems table.