Settings plugin architecture with data object pattern (#1)

* Refactor to settings plugin architecture with data object pattern

- Each plugin follows data object pattern (matching srcx/wrkx)
- Settings plugins applied in settings.gradle.kts, tasks on root project
- Per-module artifact IDs for correct Maven publishing
- Kover coverage enforcement
- Architecture tests verifying data object structure
- Tested end-to-end: plugin applies, tasks register, CLI executes

* Remove .kotlin/ from git, add to .gitignore

* Add per-module READMEs, full task coverage, arg-building tests

- READMEs for all 5 modules with CLI versions, install instructions, task docs
- 35 new task classes (53 total across 4 agents)
- Arg-building tests for run/exec tasks
- Root README updated with module links

* Achieve 90%+ coverage — extract buildCommand(), add comprehensive tests

- Extract buildCommand() on every task for testability
- Add Cli.execAndPrint() shared helper
- 97 new tests across 4 modules
- Kover minBound at 90%

* Standardize install instructions — Homebrew + bun for all CLIs

* Add bypass/dangerous flags as first-class extension properties

* Align build-logic with wrkx/srcx conventions

- Split conventions: clkx-module, clkx-toolchain, clkx-plugin, clkx-publish,
  clkx-testing, clkx-detekt, clkx-ktlint, clkx-conventions (uber)
- Add ClkxSettingsPlugin for foojay toolchain resolution
- Add detekt.yml config
- Add slopTest source set with konsist
- Kover at 90% with @TaskAction and SettingsPlugin exclusions
- clkx-library for exec module (JavaLibrary publishing)

* Split conventions (clkx-cover, clkx-konsist) + fix critical bugs

- Split clkx-testing into clkx-testing (kotest), clkx-cover (kover),
  clkx-konsist (slopTest + konsist)
- Fix --allowedTools to --allowed-tools (kebab-case)
- Fix property name collision: -Pname to -PmcpName/-PpluginName
- Fix daemon tasks (mcp serve, opencode serve) using execDaemon()
- Add Cli.execDaemon() for long-running processes

Author: ClankerGuru

.gitignore

@@ -1,4 +1,5 @@
 .gradle/
+.kotlin/
 build/
 local.properties
 .idea/

.kotlin/errors/errors-1775621134843.log

@@ -4,53 +4,66 @@
 [![Maven Central](https://img.shields.io/maven-central/v/zone.clanker/clkx-agents)](https://central.sonatype.com/namespace/zone.clanker)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Gradle plugins for AI coding agents -- Claude Code, GitHub Copilot, OpenAI Codex, and OpenCode.
+Gradle settings plugins for AI coding agents -- Claude Code, GitHub Copilot, OpenAI Codex, and OpenCode.
 
 ## Modules
 
-| Module | Plugin ID | Binary | Description |
-|--------|-----------|--------|-------------|
-| `:exec` | -- | -- | Core process execution utility |
-| `:claude` | `zone.clanker.claude` | `claude` | Claude Code CLI |
-| `:copilot` | `zone.clanker.copilot` | `copilot` | GitHub Copilot CLI |
-| `:codex` | `zone.clanker.codex` | `codex` | OpenAI Codex CLI |
-| `:opencode` | `zone.clanker.opencode` | `opencode` | OpenCode CLI |
+| Module | Plugin ID | Tasks | README |
+|--------|-----------|-------|--------|
+| [`:exec`](exec/) | -- | -- | [exec/README.md](exec/README.md) |
+| [`:claude`](claude/) | `zone.clanker.claude` | 13 | [claude/README.md](claude/README.md) |
+| [`:copilot`](copilot/) | `zone.clanker.copilot` | 9 | [copilot/README.md](copilot/README.md) |
+| [`:codex`](codex/) | `zone.clanker.codex` | 13 | [codex/README.md](codex/README.md) |
+| [`:opencode`](opencode/) | `zone.clanker.opencode` | 18 | [opencode/README.md](opencode/README.md) |
 
-## Usage
+## Install the CLIs
 
-Apply the plugin for the agent you want to use:
+```bash
+# Claude Code
+bun install -g @anthropic-ai/claude-code
+
+# GitHub Copilot
+brew install --cask copilot-cli      # or: bun install -g @github/copilot
+
+# OpenAI Codex
+brew install --cask codex            # or: bun install -g @openai/codex
+
+# OpenCode
+brew install opencode                # or: bun install -g opencode-ai
+```
+
+## Quick Start
+
+Apply the plugin for the agent you want to use in `settings.gradle.kts`:
 
 ```kotlin
 plugins {
     id("zone.clanker.claude") version "<version>"
 }
+
+claude {
+    model = "opus"
+    effort = "high"
+}
 ```
 
-### Claude Code
+Then run tasks from the command line:
 
 ```bash
-# Run with a prompt
 ./gradlew claude-run -Pprompt="Fix the build"
+```
 
-# Resume a session
-./gradlew claude-resume -PsessionId="abc123"
+### Claude Code
 
-# Check auth / version / health
+```bash
+./gradlew claude-run -Pprompt="Fix the build"
+./gradlew claude-resume -PsessionId="abc123"
 ./gradlew claude-auth
 ./gradlew claude-version
 ./gradlew claude-doctor
 ```
 
-Configure defaults in `build.gradle.kts`:
-
-```kotlin
-claude {
-    model = "claude-sonnet-4-20250514"
-    outputFormat = "json"
-    permissionMode = "bypassPermissions"
-    effort = "high"
-}
-```
+See [claude/README.md](claude/README.md) for all 13 tasks and configuration options.
 
 ### GitHub Copilot
 
@@ -62,15 +75,7 @@ claude {
 ./gradlew copilot-version
 ```
 
-Configure defaults:
-
-```kotlin
-copilot {
-    model = "gpt-4o"
-    autopilot = true
-    allowAll = true
-}
-```
+See [copilot/README.md](copilot/README.md) for all 9 tasks and configuration options.
 
 ### OpenAI Codex
 
@@ -81,15 +86,7 @@ copilot {
 ./gradlew codex-version
 ```
 
-Configure defaults:
-
-```kotlin
-codex {
-    model = "codex-mini-latest"
-    fullAuto = true
-    sandbox = "docker"
-}
-```
+See [codex/README.md](codex/README.md) for all 13 tasks and configuration options.
 
 ### OpenCode
 
@@ -100,15 +97,7 @@ codex {
 ./gradlew opencode-version
 ```
 
-Configure defaults:
-
-```kotlin
-opencode {
-    model = "anthropic/claude-sonnet-4-20250514"
-    thinking = true
-    format = "json"
-}
-```
+See [opencode/README.md](opencode/README.md) for all 18 tasks and configuration options.
 
 ## Building
 

README.md

@@ -2,9 +2,25 @@ plugins {
     `kotlin-dsl`
 }
 
+repositories {
+    mavenCentral()
+    gradlePluginPortal()
+}
+
 dependencies {
-    implementation("org.jetbrains.kotlin:kotlin-gradle-plugin:2.3.0")
+    implementation("org.jetbrains.kotlin:kotlin-gradle-plugin:${embeddedKotlinVersion}")
     implementation("com.vanniktech:gradle-maven-publish-plugin:0.32.0")
+    implementation("org.gradle.toolchains:foojay-resolver:1.0.0")
+    implementation("org.jetbrains.kotlinx:kover-gradle-plugin:0.9.1")
     implementation("io.gitlab.arturbosch.detekt:detekt-gradle-plugin:1.23.8")
     implementation("org.jlleitschuh.gradle:ktlint-gradle:12.2.0")
 }
+
+gradlePlugin {
+    plugins {
+        register("clkx-settings") {
+            id = "clkx-settings"
+            implementationClass = "zone.clanker.gradle.conventions.ClkxSettingsPlugin"
+        }
+    }
+}

build-logic/build.gradle.kts

@@ -0,0 +1,11 @@
+plugins {
+    id("clkx-module")
+    id("clkx-toolchain")
+    id("clkx-plugin")
+    id("clkx-publish")
+    id("clkx-testing")
+    id("clkx-cover")
+    id("clkx-konsist")
+    id("clkx-detekt")
+    id("clkx-ktlint")
+}

build-logic/src/main/kotlin/clkx-conventions.gradle.kts

@@ -0,0 +1,21 @@
+plugins {
+    id("org.jetbrains.kotlinx.kover")
+}
+
+kover {
+    reports {
+        filters {
+            excludes {
+                // @TaskAction run() methods delegate to Cli.execAndPrint — untestable without real CLIs
+                annotatedBy("org.gradle.api.tasks.TaskAction")
+                // Settings plugin apply() requires real Gradle Settings — tested via registerTasks
+                classes("*\$SettingsPlugin", "*\$SettingsPlugin\$*")
+            }
+        }
+        verify {
+            rule {
+                minBound(90)
+            }
+        }
+    }
+}

build-logic/src/main/kotlin/clkx-cover.gradle.kts

@@ -0,0 +1,9 @@
+plugins {
+    id("io.gitlab.arturbosch.detekt")
+}
+
+detekt {
+    config.setFrom(rootProject.file("config/detekt.yml"))
+    buildUponDefaultConfig = true
+    parallel = true
+}

build-logic/src/main/kotlin/clkx-detekt.gradle.kts

@@ -0,0 +1,31 @@
+plugins {
+    `java-base`
+}
+
+val sourceSets = the<SourceSetContainer>()
+
+val slopTest by sourceSets.creating {
+    compileClasspath += sourceSets["main"].output
+    runtimeClasspath += sourceSets["main"].output
+}
+
+configurations[slopTest.implementationConfigurationName].extendsFrom(configurations["testImplementation"])
+configurations[slopTest.runtimeOnlyConfigurationName].extendsFrom(configurations["testRuntimeOnly"])
+
+dependencies {
+    "slopTestImplementation"("com.lemonappdev:konsist:0.17.3")
+    "slopTestImplementation"("io.kotest:kotest-runner-junit5:5.9.1")
+    "slopTestImplementation"("io.kotest:kotest-assertions-core:5.9.1")
+}
+
+val slopTask = tasks.register<Test>("slopTest") {
+    description = "Run slop taste tests — architecture, naming, boundaries, style"
+    group = "verification"
+    testClassesDirs = slopTest.output.classesDirs
+    classpath = slopTest.runtimeClasspath
+    useJUnitPlatform()
+}
+
+tasks.named("check") {
+    dependsOn(slopTask)
+}

build-logic/src/main/kotlin/clkx-konsist.gradle.kts

@@ -0,0 +1,7 @@
+plugins {
+    id("org.jlleitschuh.gradle.ktlint")
+}
+
+ktlint {
+    version.set("1.5.0")
+}

build-logic/src/main/kotlin/clkx-ktlint.gradle.kts

@@ -0,0 +1,17 @@
+import com.vanniktech.maven.publish.JavaLibrary
+import com.vanniktech.maven.publish.JavadocJar
+
+plugins {
+    id("clkx-module")
+    id("clkx-toolchain")
+    id("clkx-testing")
+    id("clkx-cover")
+    id("clkx-konsist")
+    id("clkx-detekt")
+    id("clkx-ktlint")
+    id("com.vanniktech.maven.publish")
+}
+
+mavenPublishing {
+    configure(JavaLibrary(javadocJar = JavadocJar.Empty()))
+}