Package com.egoge.ai.atlas.plugin
package com.egoge.ai.atlas.plugin
Gradle plugin for the AI-ATLAS framework.
Apply with plugins { id("com.egoge.ai-atlas") } to
automatically configure the annotation processor, runtime module,
and IntelliJ IDEA generated source directories.
Configure via the agentic extension block:
agentic {
version.set("1.1.0")
mcpEnabled.set(true)
restEnabled.set(true)
openApiEnabled.set(true)
piiPatternsFile.set("/path/to/custom-pii.conf")
}
- See Also:
-
ClassDescriptionWrites the current contract to the baseline (FR-015): the IR the processor emitted, byte for byte, or
EmptyContract's document when the sources declare nothing.The accept step's inputs.Extension object for configuring the AI-ATLAS Gradle plugin.Gradle plugin that configures a Java project to use the AI-ATLAS framework.compileJava's compiler arguments and argument providers, read when the accept compilation runs.compileJava's JVM argument providers, read when the accept compilation runs.agenticRelease: snapshots the accepted contract of the main compilation as the immutable release<release.directory>/<releaseVersion>/, compares it with the previous release, checks the deprecation policy, and regenerates the aggregate changelog.agenticReleaseHistoryCheck, part ofcheck: verifies only the internal consistency of the committed release snapshots, with no git and no network: every released file against the digests of itsrelease.json, thepreviouschain, and that.atlas/CHANGELOG.mdequals what the release history would generate (AC13, AC14).agenticReleaseVerify: proves thatagentic { releaseVersion }'s tag resolves to exactlyHEAD, and that the build matches that release's snapshot byte for byte, IR canonically, and structurally in its effective configuration (E2, D6.2, D8.2, plan §3.5).atlasAccept(FR-015): writes the contract of the current sources to the baseline.atlasContractCheck(FR-008, FR-016): javac does not invoke the processor for a compilation that declares no@AgenticEntityor@AgenticExposed, so the gate cannot run insidecompileJavawhen a module removes its last ai-atlas annotation.The collections flag of the maincompileJavatask, when it is set.The contract options of the maincompileJavatask (FR-016): the baseline's absolute path and lock mode, and the constraints flag (FR-020) when it is set.Runs the processor'sEmptyContractcheck (FR-008) for a compilation that declares no ai-atlas contract.The check's inputs.Writes the empty contract (FR-008) into a compilation's class output, submitted fromcompileJava.doLastonly after the caller has confirmed, throughContractDeclarations, that the class output declares no@AgenticEntityor@AgenticExposedat all: that confirmation, not anything this action does, is what authorizes overwriting a stale "META-INF/ai-atlas/api.ir.json" an earlier, declaring compilation may have left behind (FR-016).The work's inputs.agentic { release { policy { … } } }: what a release may remove from the contract the previous release published.The projections flag of the maincompileJavatask, when it is set.Releases the accepted contract throughReleaseSnapshots.The release step's inputs.Verifies the internal consistency of the committed release snapshots, through the processor'sReleaseSnapshotHistory.checkConsistency(java.nio.file.Path, java.nio.file.Path): no git, no network, and it never reads the build's class output.The check's inputs.Reads the release directoriesReleaseSnapshotswrites: the verified history, and the aggregate changelog, extracted fromReleaseSnapshotsso each file stays under the 500-line cap.Releases the accepted contract as an immutable snapshot,<releases>/<version>/, and verifies a build's contract against one already released.A release made.A release that cannot be made, or a released snapshot that fails verification.What to release.agentic { release { … } }: whereagenticReleasewrites released contracts, and the release policy.agenticReleaseVerify's worker: provesagentic { releaseVersion }'s tag resolves to exactlyHEAD(E2, D8.2, plan §3.5, OQ-3), through the same fail-closedGitRepositoryandPublishedHistoryproofagenticReleaseuses, then verifies the build matches that release throughReleaseSnapshots.verifyBuild(java.nio.file.Path, java.nio.file.Path, java.lang.String, byte[], java.util.Map<java.lang.String, byte[]>, java.lang.String).The verify step's inputs.The REST flag of the maincompileJavatask, when it is set.agentic { release { tagName } }: the git tag a released version is proved by (F1).