Class ResolveAgentDocsTask

java.lang.Object
org.gradle.api.internal.AbstractTask
org.gradle.api.DefaultTask
io.github.duckasteroid.agentdocs.resolve.task.ResolveAgentDocsTask
All Implemented Interfaces:
Comparable<org.gradle.api.Task>, org.gradle.api.internal.DynamicObjectAware, org.gradle.api.internal.TaskInternal, org.gradle.api.Named, org.gradle.api.plugins.ExtensionAware, org.gradle.api.Task, org.gradle.util.Configurable<org.gradle.api.Task>

@DisableCachingByDefault(because="Resolver task performs filesystem orchestration not yet modeled for cache reuse") public abstract class ResolveAgentDocsTask extends org.gradle.api.DefaultTask
Resolves dependency-scoped agent-docs sidecar archives for the configured classpath, extracts docs into dependency-scoped directories in the local project skills tree, marks managed folders with .agent-docs, and removes stale marker-owned dependency folders.

When getIncludeSources() is true, the task also resolves the sources classifier jar for each dependency and unpacks it into a src/ subdirectory of the skill folder. The extracted SKILL.md frontmatter records metadata.sources: src/ when sources are available, or metadata.sources: none when the artifact has no sources jar.

  • Nested Class Summary

    Nested classes/interfaces inherited from interface org.gradle.api.Named

    org.gradle.api.Named.Namer
  • Field Summary

    Fields inherited from interface org.gradle.api.Task

    TASK_ACTION, TASK_CONSTRUCTOR_ARGS, TASK_DEPENDS_ON, TASK_DESCRIPTION, TASK_GROUP, TASK_NAME, TASK_OVERWRITE, TASK_TYPE
  • Constructor Summary

    Constructors
    Constructor
    Description
     
  • Method Summary

    Modifier and Type
    Method
    Description
    abstract org.gradle.api.provider.Property<String>
    Gradle configuration name to inspect for direct dependencies.
    abstract org.gradle.api.provider.ListProperty<String>
    Direct dependency coordinates from the configured classpath in group:name:version form, precomputed during task configuration.
    abstract org.gradle.api.provider.Property<Boolean>
    When true, the task also resolves and extracts the sources classifier jar for each dependency that has an agent-docs sidecar.
    abstract org.gradle.api.provider.MapProperty<String,String>
    Sidecar archive paths resolved during task configuration and keyed by group:name:version coordinates.
    abstract org.gradle.api.provider.MapProperty<String,String>
    Sources jar paths resolved during task configuration and keyed by group:name:version coordinates.
    abstract org.gradle.api.file.DirectoryProperty
    Root output directory for extracted docs and generated skills.

    Methods inherited from class org.gradle.api.DefaultTask

    compareTo, configure, dependsOn, doFirst, doFirst, doFirst, doLast, doLast, doLast, finalizedBy, getActions, getAnt, getDependsOn, getDescription, getDestroyables, getDidWork, getEnabled, getExtensions, getFinalizedBy, getGroup, getInputs, getLocalState, getLogger, getLogging, getMustRunAfter, getName, getOutputs, getPath, getProject, getShouldRunAfter, getState, getTaskDependencies, getTemporaryDir, getTimeout, hasProperty, mustRunAfter, onlyIf, onlyIf, onlyIf, property, setActions, setDependsOn, setDescription, setDidWork, setEnabled, setFinalizedBy, setGroup, setMustRunAfter, setOnlyIf, setOnlyIf, setOnlyIf, setProperty, setShouldRunAfter, shouldRunAfter, usesService

    Methods inherited from class org.gradle.api.internal.AbstractTask

    acceptServiceReferences, appendParallelSafeAction, doNotTrackState, doNotTrackStateIf, getAsDynamicObject, getIdentityPath, getImpliesSubProjects, getLifecycleDependencies, getOnlyIf, getReasonNotToTrackState, getReasonsNotToTrackState, getReasonTaskIsIncompatibleWithConfigurationCache, getRequiredServices, getServices, getSharedResources, getStandardOutputCapture, getTaskActions, getTaskIdentity, getTemporaryDirFactory, hasTaskActions, injectIntoNewInstance, isCompatibleWithConfigurationCache, isEnabled, isHasCustomActions, notCompatibleWithConfigurationCache, prependParallelSafeAction, restoreOnlyIf, restoreTaskActions, setImpliesSubProjects

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    Methods inherited from interface org.gradle.api.Task

    doNotTrackState, notCompatibleWithConfigurationCache
  • Constructor Details

    • ResolveAgentDocsTask

      public ResolveAgentDocsTask()
  • Method Details

    • getConfigurationName

      @Input public abstract org.gradle.api.provider.Property<String> getConfigurationName()
      Gradle configuration name to inspect for direct dependencies.
      Returns:
      configuration name property
    • getDependencyCoordinates

      @Input public abstract org.gradle.api.provider.ListProperty<String> getDependencyCoordinates()
      Direct dependency coordinates from the configured classpath in group:name:version form, precomputed during task configuration.
      Returns:
      direct dependency coordinates
    • getResolvedSidecarPaths

      @Input public abstract org.gradle.api.provider.MapProperty<String,String> getResolvedSidecarPaths()
      Sidecar archive paths resolved during task configuration and keyed by group:name:version coordinates.
      Returns:
      coordinate-to-sidecar-path mapping
    • getIncludeSources

      @Input public abstract org.gradle.api.provider.Property<Boolean> getIncludeSources()
      When true, the task also resolves and extracts the sources classifier jar for each dependency that has an agent-docs sidecar.
      Returns:
      include-sources flag property
    • getResolvedSourcePaths

      @Input public abstract org.gradle.api.provider.MapProperty<String,String> getResolvedSourcePaths()
      Sources jar paths resolved during task configuration and keyed by group:name:version coordinates. Only populated when getIncludeSources() is true; empty otherwise.
      Returns:
      coordinate-to-sources-path mapping
    • getSkillsDirectory

      @OutputDirectory public abstract org.gradle.api.file.DirectoryProperty getSkillsDirectory()
      Root output directory for extracted docs and generated skills.
      Returns:
      skills root directory property