Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 42 additions & 2 deletions docs/src/process-development/linter-tool/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,47 @@
title: Changelog
icon: code
---
## Version 0.1.2 (Latest)
## Version 0.1.3 (Latest)

Released as GitHub artifact `linter-cli-0.1.3.jar` and Maven Central module `dev.dsf.linter:linter-core:0.1.3`. DSF integrates this release as a dependency of `dsf-maven-plugin` for the `lint` goal.

### Features

- **Lint exclusions** — Suppress selected findings via `dsf-linter-exclusions.json` (CLI `--exclusions` / Maven `dsf.lint.exclusionsFile`, plus auto-discovery).
- **HTML report source navigation** — Embedded BPMN/FHIR sources with a viewer modal and highlighting.
- **Remote JAR extraction lifecycle** — Extracted remote JAR directories are persisted across runs.
- **BPMN: process-level message start event** — Processes must have a message start event as a direct child of `<process>` (`BPMN_MESSAGE_START_EVENT_NOT_FOUND`).
- **BPMN: finer-grained empty-name types** — Per-element lint types instead of a single generic empty-name type where applicable.
- **Spring / API v2: `ActivityPrototypeBeanCreator`** — Spring checks recognize APBC-registered activities and warn on V2 activities registered only as `@Bean` (or twice).
- **Spring bean scope checks** — Prototype vs singleton / mutable-state validation for BPMN-referenced beans.
- **Additional validation rules** — BPMN class references against Spring config, Task input coding (CodeSystem/ValueSet), and related BPMN/FHIR checks.

### Integration

- **`dsf-maven-plugin:lint`** — DSF depends on `linter-core` **0.1.3** and exposes build-time linting (default phase `verify`) with the same exclusion format as the CLI. See [Maven Plugin Integration](./linter-tool.md#maven-plugin-integration).

### Bug Fixes

- **Missing `ProcessPluginDefinition` no longer aborts** — Emits ERROR `PLUGIN_DEFINITION_NO_PLUGIN_FOUND` and still writes regular HTML/JSON reports (`--no-fail` / `dsf.lint.failOnErrors=false` control exit status).
- **False positives for API v2 Spring beans** — Correct handling when activities are registered via `ActivityPrototypeBeanCreator`.
- **FHIR Task input coding false positive** — Fixed incorrect “coding system not in value set” findings on valid ping tasks.
- **Message event implementation checks** — Aligned with DSF API v1/v2; Camunda field injection expressions allowed for API v2.
- **Lint type / message corrections** — Fixed incorrect types/messages for start/end events not part of a subprocess and related BPMN findings.

### Severity Adjustments

- Empty user-task name and empty inclusive-gateway name (multiple outgoing flows): **ERROR → WARN**
- `QUESTIONNAIRE_INVALID_META_PROFILE`: severity downgraded
- Message intermediate throw event message reference: reported as **INFO** (`BPMN_MESSAGE_INTERMEDIATE_THROW_EVENT_HAS_MESSAGE_REFERENCE`)

### Build & Publishing

- Maven Central publishing alignment and GitHub Release workflow (JAR + checksum)
- CI improvements (CodeQL, JavaDoc, Java 25 publish action) and dependency cleanups

**Upgrade is recommended for all users of v0.1.2**, especially when linting API v2 plugins, using HTML reports, exclusions, or hitting abort-on-missing-plugin behavior.

## Version 0.1.2

### Bug Fixes

Expand Down Expand Up @@ -37,4 +77,4 @@ icon: code
- Task identifier system and value format validation (`FHIR_TASK_IDENTIFIER_MISSING_SYSTEM`, `FHIR_TASK_IDENTIFIER_INVALID_SYSTEM`, `FHIR_TASK_IDENTIFIER_INVALID_FORMAT`)
- Plugin configuration validation:
- Plugin resource version validation (`PLUGIN_DEFINITION_RESOURCE_VERSION_NULL`)
- HTML and JSON report generation
- HTML and JSON report generation
15 changes: 9 additions & 6 deletions docs/src/process-development/linter-tool/development.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ icon: code

1. **Import Project**:
- Import as Maven project
- Set JDK to 17 or higher
- Set JDK to **25**
- Ensure Maven dependencies are resolved

2. **Code Style** (optional):
Expand Down Expand Up @@ -75,12 +75,15 @@ vim linter-core/src/main/java/dev/dsf/linter/service/BpmnLintingService.java
# 2. Build the project
mvn clean package -DskipTests

# 3. Test with a sample plugin
java -jar linter-cli/target/linter-cli-0.1.2.jar \
--path test-plugin.jar --html --verbose
# 3. Test with a sample plugin (CLI)
java -jar linter-cli/target/linter-cli-0.1.3.jar \
--path test-plugin.jar --html --verbose --exclusions dsf-linter-exclusions.json

# Or exercise the Maven glue in a process plugin project:
# mvn -f path/to/process-plugin verify -Ddsf.lint.html=true -Ddsf.lint.verbose=true

# 4. Check the generated report
open /tmp/dsf-linter-report-test-plugin/dsf-linter-report/index.html
open /tmp/dsf-linter-report-test-plugin/dsf-linter-report/report.html

# 5. Run unit tests
mvn test
Expand All @@ -97,7 +100,7 @@ git commit -m "Description of changes"
```bash
# Start the linter with debugger enabled
java -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=5005 \
-jar linter-cli/target/linter-cli-0.1.2.jar \
-jar linter-cli/target/linter-cli-0.1.3.jar \
--path plugin.jar --html --verbose

# Attach debugger from IDE to localhost:5005
Expand Down
Loading
Loading