Auto-wire generated sources into compilation

[kirich1409]

What changed

FeaturedPlugin and FeaturedApplicationPlugin now register their generated source directories into the consuming module's compilation automatically — applying the plugins requires zero manual srcDir/dependsOn boilerplate.

• New GeneratedSourceWiring.kt with per-project-type helpers:
  • KMP commonMain and Kotlin/JVM main receive a task-carrying Provider<Directory> (task.flatMap { it.outputDir }); Gradle auto-infers the dependency for every consumer (compile*Kotlin*, *SourcesJar, metadata, …).
  • Plain AGP (com.android.application/library) receives a resolved File plus an explicit dependsOn — AGP's source set rejects providers at configuration time.
  • com.android.kotlin.multiplatform.library is covered by the KMP branch (it co-applies org.jetbrains.kotlin.multiplatform).
• generateFeaturedRegistry now exposes an @OutputDirectory (dedicated generated/featured/registry dir, distinct from generateConfigParam's commonMain to avoid overlapping outputs), so the aggregator wires via the same task-carrying-provider mechanism.
• Removed the now-redundant manual srcDir/dependsOn wiring from the sample feature modules and the shared aggregator (dogfood proof).
• Docs updated (root + plugin CLAUDE.md, task KDoc) to describe auto-wiring.

Why

Closes #249. Previously a consumer had to hand-wire tasks.named("generateConfigParam") into a source set and add an explicit dependsOn — awkward on AGP 9 (kotlin { sourceSets["main"] } fails; android.sourceSets["main"].kotlin.srcDir(provider) is rejected). The plugin can detect the project type and wire correctly itself; the previously-documented "manual wiring is intentional" rationale is disproven.

Release Notes

### Changed

• The Featured Gradle plugins now auto-wire generated sources into compilation. Consumer modules no longer need a manual sourceSets … srcDir(tasks.named("generateConfigParam")) / generateFeaturedRegistry declaration — applying dev.androidbroadcast.featured / dev.androidbroadcast.featured.application is sufficient. Existing manual wiring remains harmless (deduped) but can be deleted.

How to test

Clean build proves zero-boilerplate wiring across all supported project shapes (all green):

./gradlew clean
./gradlew :featured-gradle-plugin:test            # 321 tests incl. GeneratedSourceWiringTest (per-shape compile-proof)
./gradlew :sample:feature-ui:assemble             # KMP dogfood, manual wiring removed
./gradlew :sample:android-app:assembleDebug       # AGP consumer end-to-end (pulls KMP-android-library feature modules)
./gradlew :sample:shared:assemble                 # aggregator dogfood
./gradlew spotlessCheck

Status

Gate	Result
/check (clean build + tests + spotless)	✅ all green
/finalize (review→fix→simplify)	✅ PASS — 1 round, 6 findings fixed
/acceptance (build-proof contract)	✅ VERIFIED

Acknowledged WARNs (see swarm-report/249-finalize.md): no dedicated com.android.kotlin.multiplatform.library TestKit fixture (covered end-to-end by the sample dogfood), no-supported-plugin silent no-wiring (misuse case), AGP dependsOn predicate may miss lint/sources-jar for plain-AGP consumers (untested low-likelihood edge).

Build-config/codegen-wiring change with no runtime behavior change — the proof is that modules compile and the sample app builds with all manual wiring deleted.

Artifacts (gitignored, local)

• Plan/approach: swarm-report/249-autowire-state.md
• Finalize: swarm-report/249-finalize.md
• Acceptance: swarm-report/249-acceptance.md

🤖 Generated with Claude Code

[cubic-dev-ai]

2 issues found across 41 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="featured-gradle-plugin/src/test/fixtures/aggregator-multi-module-project/app/src/main/kotlin/WiringProof.kt">

<violation number="1" location="featured-gradle-plugin/src/test/fixtures/aggregator-multi-module-project/app/src/main/kotlin/WiringProof.kt:3">
P3: Comment references wrong output directory: GeneratedFeaturedRegistry lives at build/generated/featured/registry, not build/generated/featured/commonMain</violation>
</file>

<sub>Reply with feedback, questions, or to request a fix.

Re-trigger cubic</sub>