| Dimension | Shared | Only in A | Only in B | Overlap |
|---|---|---|---|---|
| Sections | 0 | 1 | 5 | 0% |
| Commands | 0 | 2 | 5 | 0% |
| Section tags | 0 | 0 | 3 | 0% |
What each file covers
Sections
0 shared · 1 only in A · 5 only in B- − Application BOM Guidelines
- + Backend Application Guidelines
- + Structure
- + Commands
- + Conventions
- + Boundaries
Commands
0 shared · 2 only in A · 5 only in B- − gradle/libs.versions.toml
- − ./gradlew build
- + ./gradlew :application:test
- + ./gradlew :application:bootRun
- + ./gradlew :application:copyUiDist
- + ./gradlew generateOpenApiDocs
- + ./gradlew generateOpenApiDocs && pnpm -C ui api-client:gen
Section tags
0 shared · 0 only in A · 3 only in B- + code-style
- + architecture
- + agent-behaviour
Line diff
halo-dev/halo · platform/application/AGENTS.md
@@ −1 @@
1# Application BOM Guidelines
2
3`platform/application/` is a Java platform BOM constraining dependencies shared by the backend.
4
5- Declare shared dependency versions in `gradle/libs.versions.toml` and reference them from `build.gradle`; add constraints here only when a dependency is used across backend modules.
6- Changes ripple through the whole backend build — verify with `./gradlew build`.
7- New shared dependencies require approval before merging.
8
9
halo-dev/halo · application/AGENTS.md
@@ +1 @@
1# Backend Application Guidelines
2
3`application/` is the WebFlux + R2DBC backend: services, routers, security, migrations, and packaging. Everything here is reactive — never block threads.
4
5## Structure
6
7- `application/src/main/java/` — services, routers, endpoints, and configuration.
8- `application/src/main/resources/application*.yaml` — environment configuration.
9- `application/src/main/resources/db/migration/{h2,mariadb,mysql,postgresql}/` — per-dialect migrations.
10- `application/src/main/resources/extensions/` — extension schemas and role templates.
11- `application/src/test/` — backend tests.
12
13## Commands
14
15- `./gradlew :application:test` — run backend tests.
16- `./gradlew :application:bootRun` — start the backend dev server.
17- `./gradlew :application:copyUiDist` — embed the built UI into the JAR.
18- `./gradlew generateOpenApiDocs` — emit the OpenAPI spec used to regenerate the UI client.
19
20## Conventions
21
22- Keep reactive flows non-blocking; no blocking I/O in request paths.
23- Database migrations are versioned per dialect — never auto-generate them, and review them with the `application/` guide in mind.
24- Tests: JUnit 5 with Spring Boot test support; name unit tests `XxxTest` and integration tests `XxxIntegrationTest`.
25- After DTO, route, or schema changes, regenerate the UI client (`./gradlew generateOpenApiDocs && pnpm -C ui api-client:gen`) and update `ui/` usage.
26
27## Boundaries
28
29- Ask before adding database migrations, changing security configuration, or introducing new dependencies.
30
31
@@ −1 +1 @@
1−# Application BOM Guidelines
1+# Backend Application Guidelines
22
3−`platform/application/` is a Java platform BOM constraining dependencies shared by the backend.
3+`application/` is the WebFlux + R2DBC backend: services, routers, security, migrations, and packaging. Everything here is reactive — never block threads.
44
5−- Declare shared dependency versions in `gradle/libs.versions.toml` and reference them from `build.gradle`; add constraints here only when a dependency is used across backend modules.
6−- Changes ripple through the whole backend build — verify with `./gradlew build`.
7−- New shared dependencies require approval before merging.
5+## Structure
6+
7+- `application/src/main/java/` — services, routers, endpoints, and configuration.
8+- `application/src/main/resources/application*.yaml` — environment configuration.
9+- `application/src/main/resources/db/migration/{h2,mariadb,mysql,postgresql}/` — per-dialect migrations.
10+- `application/src/main/resources/extensions/` — extension schemas and role templates.
11+- `application/src/test/` — backend tests.
12+
13+## Commands
14+
15+- `./gradlew :application:test` — run backend tests.
16+- `./gradlew :application:bootRun` — start the backend dev server.
17+- `./gradlew :application:copyUiDist` — embed the built UI into the JAR.
18+- `./gradlew generateOpenApiDocs` — emit the OpenAPI spec used to regenerate the UI client.
19+
20+## Conventions
21+
22+- Keep reactive flows non-blocking; no blocking I/O in request paths.
23+- Database migrations are versioned per dialect — never auto-generate them, and review them with the `application/` guide in mind.
24+- Tests: JUnit 5 with Spring Boot test support; name unit tests `XxxTest` and integration tests `XxxIntegrationTest`.
25+- After DTO, route, or schema changes, regenerate the UI client (`./gradlew generateOpenApiDocs && pnpm -C ui api-client:gen`) and update `ui/` usage.
26+
27+## Boundaries
28+
29+- Ask before adding database migrations, changing security configuration, or introducing new dependencies.
830
931
