Class FeatureStartSiblingPublishVerifyMojo

java.lang.Object
network.ike.plugin.ws.FeatureStartSiblingPublishMojo
network.ike.plugin.ws.FeatureStartSiblingPublishVerifyMojo
All Implemented Interfaces:
org.apache.maven.api.plugin.Mojo
@Mojo(name="feature-start-sibling-publish-verify", projectRequired=false, aggregator=true) public class FeatureStartSiblingPublishVerifyMojo extends FeatureStartSiblingPublishMojo
Start a feature in a sibling workspace clone and then build the sibling's whole reactor to verify it (IKE-Network/ike-issues#777).

Identical to FeatureStartSiblingPublishMojo except the post-create reactor build is on by default — this is the -Dverify flag promoted to its own goal so it is discoverable in ws:help and writes its own report file. The build (default clean install -DskipTests -T 1C, overridable via -Dws.sibling.verifyGoals) proves the sibling compiles and installs every -<feature>-SNAPSHOT artifact into the local repository, so a later partial (-pl … -am) or IDE build can resolve them — the gap that made a freshly created, unbuilt sibling look broken. On a build failure the clone is left intact and the goal fails loud, mirroring ws:checkpoint-publish's pre-tag gate. 

mvn ws:feature-start-sibling-publish-verify -Dfeature=jira-456
#   creates ../<workspace>-jira-456/ on feature/jira-456, then builds the
#   whole reactor from its root before handing it back ready to work in.
See Also:

  • Constructor Summary

    Constructors
    Constructor
    Description
    FeatureStartSiblingPublishVerifyMojo()
    Creates this goal instance.

  • Method Summary

    Modifier and Type
    Method
    Description
    protected boolean
    allowUncommitted()
    Whether the -Dallow-uncommitted escape hatch is set — bypasses a TreePreflight.REQUIRE_UNMODIFIED preflight (#780).
    protected boolean
    confirm(String label, boolean defaultYes)
    Prompt the user with a yes/no question, accepting "y"/"yes"/"n"/"no" (case-insensitive).
    protected boolean
    deferCommit()
    Whether the -Ddefer-commit cascade hand-off is set — the goal skips its own TreePreflight.REQUIRE_UNMODIFIED preflight and AuthoredCommit.IN_ISOLATION commit so the invoking goal owns the commit (AuthoredCommit.DEFER_TO_CALLER, #780).
    final void
    execute()
    Run the goal and write its report.
    protected org.apache.maven.api.plugin.Log
    getLog()
    Access the Maven logger.
    protected network.ike.plugin.support.IkePrompter
    getPrompter()
    The IkePrompter for this goal — built lazily from the session's interactive flag, or the test-injected instance.
    protected org.apache.maven.api.Session
    getSession()
    Access the Maven session injected by Maven 4's plugin DI.
    protected String
    gitBranch(File subprojectDir)
    Get the current branch of a subproject directory.
    protected String
    gitShortSha(File subprojectDir)
    Get the short SHA of HEAD for a subproject directory.
    protected String
    gitStatus(File subprojectDir)
    Run git status --porcelain on a subproject directory and return the output (empty string = clean).
    protected String
    header(String goalName)
    Format a goal header line using the workspace name.
    protected boolean
    isWorkspaceMode()
    Check whether a workspace.yaml exists in the directory hierarchy.
    protected network.ike.workspace.WorkspaceGraph
    loadGraph()
    Load the manifest and build the workspace graph.
    protected WsGoal
    reportGoal()
    The goal identity used for this run's report file.
    protected String
    requireParam(String currentValue, String propertyName, String promptLabel)
    Prompt the user interactively for a required parameter when it was not supplied on the command line.
    protected network.ike.workspace.Cohort
    resolveCohort()
    Resolve the Cohort an artifact / release-style goal acts on, honoring -Dworkspace.manifest (IKE-Network/ike-issues#612).
    protected Path
    resolveManifest()
    Resolve the manifest path — explicit parameter, or search upward.
    protected network.ike.workspace.WorkingSet
    resolveWorkingSet()
    Resolve the WorkingSet this goal acts on, honoring the -Dworkspace.manifest override and the workspace-vs-single-repo decision in one place (IKE-Network/ike-issues#611).
    protected String
    selectFromList(String label, List<String> options)
    Prompt the user to pick from a numbered list.
    protected void
    setLog(org.apache.maven.api.plugin.Log log)
    Replace the logger.
    protected static network.ike.workspace.FeatureName
    validateFeatureName(String feature)
    Validate a feature-name string with FeatureName.of(String) and surface any rule violation as a clean MojoException (the raw IllegalArgumentException would otherwise bubble up as a Maven internal error).
    protected static network.ike.workspace.MavenVersion
    validateMavenVersion(String version)
    Validate a Maven version string with MavenVersion.of(String) and surface any rule violation as a MojoException (ike-issues#295).
    protected static network.ike.workspace.SubprojectName
    validateSubprojectName(String subproject)
    Validate a subproject-name string with SubprojectName.of(String) and surface any rule violation as a MojoException (ike-issues#295).
    protected boolean
    verifyByDefault()
    Default for the post-create reactor build when -Dverify is not given.
    protected String
    workspaceName()
    Read the workspace name from the root POM's artifactId.
    protected File
    workspaceRoot()
    Resolve the workspace root directory (parent of workspace.yaml).

    Methods inherited from class FeatureStartSiblingPublishMojo

    runGoal, shouldVerify, verifySibling

    Methods inherited from class Object

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

  • Constructor Details

    • FeatureStartSiblingPublishVerifyMojo

      public FeatureStartSiblingPublishVerifyMojo()
      Creates this goal instance.

  • Method Details

    • verifyByDefault

      protected boolean verifyByDefault()
      Default for the post-create reactor build when -Dverify is not given. false here; FeatureStartSiblingPublishVerifyMojo overrides it to true.
      Overrides:
      verifyByDefault in class FeatureStartSiblingPublishMojo
      Returns:
      true — this goal always builds the sibling reactor

    • reportGoal

      protected WsGoal reportGoal()
      The goal identity used for this run's report file. The base goal reports as WsGoal.FEATURE_START_SIBLING_PUBLISH; the -verify subclass overrides this so its report lands in its own file.
      Overrides:
      reportGoal in class FeatureStartSiblingPublishMojo
      Returns:
      WsGoal.FEATURE_START_SIBLING_PUBLISH_VERIFY so this goal reports to its own file

    • getLog

      protected org.apache.maven.api.plugin.Log getLog()
      Access the Maven logger.
      Returns:
      the logger instance

    • allowUncommitted

      protected boolean allowUncommitted()
      Whether the -Dallow-uncommitted escape hatch is set — bypasses a TreePreflight.REQUIRE_UNMODIFIED preflight (#780).
      Returns:
      true to proceed despite an uncommitted working tree

    • deferCommit

      protected boolean deferCommit()
      Whether the -Ddefer-commit cascade hand-off is set — the goal skips its own TreePreflight.REQUIRE_UNMODIFIED preflight and AuthoredCommit.IN_ISOLATION commit so the invoking goal owns the commit (AuthoredCommit.DEFER_TO_CALLER, #780).
      Returns:
      true to defer the preflight + commit to the caller

    • getSession

      protected org.apache.maven.api.Session getSession()
      Access the Maven session injected by Maven 4's plugin DI.
      Returns:
      the injected session (may be null in unit tests)

    • setLog

      protected void setLog(org.apache.maven.api.plugin.Log log)
      Replace the logger. Used when a mojo is constructed directly (not via Maven's DI container) and so never had a logger injected — WsSyncMojo drives PullWorkspaceMojo and PushMojo instances it created itself.
      Parameters:
      log - the replacement logger

    • getPrompter

      protected network.ike.plugin.support.IkePrompter getPrompter()
      The IkePrompter for this goal — built lazily from the session's interactive flag, or the test-injected instance. Callers that pass it to a static helper (e.g. FeatureFinishSupport.promptStaleBranchCleanup(File, List, String, String, IkePrompter, Log)) use this.
      Returns:
      the prompter (never null)

    • loadGraph

      protected network.ike.workspace.WorkspaceGraph loadGraph()
      Load the manifest and build the workspace graph.
      Returns:
      the workspace dependency graph
      Throws:
      org.apache.maven.api.plugin.MojoException - if the manifest cannot be read

    • resolveManifest

      protected Path resolveManifest()
      Resolve the manifest path — explicit parameter, or search upward.
      Returns:
      path to the workspace manifest file
      Throws:
      org.apache.maven.api.plugin.MojoException - if the manifest cannot be found

    • workspaceRoot

      protected File workspaceRoot()
      Resolve the workspace root directory (parent of workspace.yaml).
      Returns:
      the workspace root directory
      Throws:
      org.apache.maven.api.plugin.MojoException - if the manifest cannot be found

    • gitStatus

      protected String gitStatus(File subprojectDir)
      Run git status --porcelain on a subproject directory and return the output (empty string = clean).
      Parameters:
      subprojectDir - the subproject directory to check
      Returns:
      git status output, empty if clean

    • gitBranch

      protected String gitBranch(File subprojectDir)
      Get the current branch of a subproject directory.
      Parameters:
      subprojectDir - the subproject directory to check
      Returns:
      the current branch name

    • gitShortSha

      protected String gitShortSha(File subprojectDir)
      Get the short SHA of HEAD for a subproject directory.
      Parameters:
      subprojectDir - the subproject directory to check
      Returns:
      the short SHA of HEAD

    • isWorkspaceMode

      protected boolean isWorkspaceMode()
      Check whether a workspace.yaml exists in the directory hierarchy. Does not throw — returns false if no manifest is found.
      Returns:
      true if running inside a workspace, false for a bare repo

    • resolveWorkingSet

      protected network.ike.workspace.WorkingSet resolveWorkingSet()
      Resolve the WorkingSet this goal acts on, honoring the -Dworkspace.manifest override and the workspace-vs-single-repo decision in one place (IKE-Network/ike-issues#611). When a workspace.yaml is configured or found by searching upward, the working set is that workspace's subprojects plus the root; otherwise it is the current repository — a working set of one. This is the single home for the isWorkspaceMode() + bare-mode branch the working-tree goals otherwise each carry, delegating to the shared WorkingSetResolver.
      Returns:
      the resolved working set (never null)

    • resolveCohort

      protected network.ike.workspace.Cohort resolveCohort()
      Resolve the Cohort an artifact / release-style goal acts on, honoring -Dworkspace.manifest (IKE-Network/ike-issues#612). When a workspace.yaml is configured or found by searching upward, the cohort is its subprojects in topological order (the aggregator root excluded); otherwise it is the current repository — a cohort of one. The dependency-ordered counterpart to resolveWorkingSet(), delegating to the shared CohortResolver.
      Returns:
      the resolved cohort (never null)

    • requireParam

      protected String requireParam(String currentValue, String propertyName, String promptLabel)
      Prompt the user interactively for a required parameter when it was not supplied on the command line.

      Delegates to the IkePrompter (IKE-Network/ike-issues#385): an inline prompt on a real terminal, an own-line prompt in a piped IDE runner. In batch mode it throws a clear error directing the user to pass the property explicitly.

      Parameters:
      currentValue - the value from the @Parameter field (may be null)
      propertyName - the -D property name (for the error message)
      promptLabel - human-readable label shown in the prompt; callers pass it without trailing punctuation (a ": " separator is appended here)
      Returns:
      the resolved value — either the original or user-supplied
      Throws:
      org.apache.maven.api.plugin.MojoException - if no value can be obtained

    • validateFeatureName

      protected static network.ike.workspace.FeatureName validateFeatureName(String feature)
      Validate a feature-name string with FeatureName.of(String) and surface any rule violation as a clean MojoException (the raw IllegalArgumentException would otherwise bubble up as a Maven internal error). Use this anywhere a feature name leaves the -Dfeature= command-line boundary (ike-issues#205).
      Parameters:
      feature - the candidate feature name (must already be resolved — i.e. non-null after requireParam(String, String, String) or auto-detection)
      Returns:
      the validated FeatureName value
      Throws:
      org.apache.maven.api.plugin.MojoException - if feature fails the FeatureName syntax rules

    • validateSubprojectName

      protected static network.ike.workspace.SubprojectName validateSubprojectName(String subproject)
      Validate a subproject-name string with SubprojectName.of(String) and surface any rule violation as a MojoException (ike-issues#295).
      Parameters:
      subproject - the candidate subproject name (already resolved — non-null after requireParam(String, String, String) or POM derivation)
      Returns:
      the validated SubprojectName value
      Throws:
      org.apache.maven.api.plugin.MojoException - if subproject fails the SubprojectName syntax rules

    • validateMavenVersion

      protected static network.ike.workspace.MavenVersion validateMavenVersion(String version)
      Validate a Maven version string with MavenVersion.of(String) and surface any rule violation as a MojoException (ike-issues#295). Per feedback_no_semver_assumption the validator accepts single-segment monotonic, semver-like, calendar-based, and branch-qualified versions; it does not enforce semver.
      Parameters:
      version - the candidate version string
      Returns:
      the validated MavenVersion value
      Throws:
      org.apache.maven.api.plugin.MojoException - if version fails the MavenVersion syntax rules

    • confirm

      protected boolean confirm(String label, boolean defaultYes)
      Prompt the user with a yes/no question, accepting "y"/"yes"/"n"/"no" (case-insensitive). When invoked in a non-interactive context, the default is used.
      Parameters:
      label - the question to display (without trailing punctuation)
      defaultYes - whether true (yes) is the default
      Returns:
      true for yes, false for no
      Throws:
      org.apache.maven.api.plugin.MojoException - if no answer can be obtained

    • selectFromList

      protected String selectFromList(String label, List<String> options)
      Prompt the user to pick from a numbered list. Returns the chosen option, or null when the list is empty.
      Parameters:
      label - prompt header (printed via the Prompter as a message)
      options - ordered list of choices
      Returns:
      the chosen option, or null if options is empty
      Throws:
      org.apache.maven.api.plugin.MojoException - if no valid choice can be obtained

    • workspaceName

      protected String workspaceName()
      Read the workspace name from the root POM's artifactId. Falls back to "Workspace" if the POM cannot be read.
      Returns:
      the workspace name derived from the root POM artifactId

    • header

      protected String header(String goalName)
      Format a goal header line using the workspace name. Example: "komet-ws — Status"
      Parameters:
      goalName - the goal name to display in the header
      Returns:
      the formatted header string

    • execute

      public final void execute() throws org.apache.maven.api.plugin.MojoException
      Run the goal and write its report.

      This method is final: every ws:* goal follows the same template — do the work, then write exactly one report. Subclasses supply the work and the report content by implementing runGoal(); they cannot override execute() to skip the report. That is what makes report-writing structural — a goal that compiles necessarily writes a report, so the #407 bug class (a goal runs fine but silently writes none) becomes compiler-impossible (IKE-Network/ike-issues#413).

      The report lands in its per-goal file at the workspace root (ws꞉goal-name.md); WorkspaceReport self-heals the nearest .gitignore so reports never land in git. A -publish run does not delete the matching -draft report — both are timestamped history (ike-issues#413).

      Specified by:
      execute in interface org.apache.maven.api.plugin.Mojo
      Throws:
      org.apache.maven.api.plugin.MojoException - if the goal fails