Skip to content

[Automated] Update minikube CLI Options - #4676

Open
thomhurst wants to merge 1 commit into
mainfrom
automated/update-cli-options-minikube
Open

[Automated] Update minikube CLI Options#4676
thomhurst wants to merge 1 commit into
mainfrom
automated/update-cli-options-minikube

Conversation

@thomhurst

@thomhurst thomhurst commented Sep 6, 2026

Copy link
Copy Markdown
Owner

Summary

This PR contains automatically generated updates to minikube CLI options classes.

The generator scraped the latest CLI help output from the installed tool.

Changes

  • Updated options classes to reflect latest CLI documentation
  • Added new commands if any were detected
  • Updated option types and descriptions

Assembly-wide public API impact

Affected API families: Minikube.

  • Added APIs: 14
  • Removed or changed APIs: 14
  • Members with matching names but changed signatures: 0

Breaking changes are present. Consumers may need to update method arguments, option property types or nullability, enum members, and references to removed APIs.

Representative removed or changed members:

  • ModularPipelines.Minikube.Enums.MinikubeDockerEnvOutput.Json = 2 -> ModularPipelines.Minikube.Enums.MinikubeDockerEnvOutput
  • ModularPipelines.Minikube.Enums.MinikubeDockerEnvOutput.Text = 0 -> ModularPipelines.Minikube.Enums.MinikubeDockerEnvOutput
  • ModularPipelines.Minikube.Enums.MinikubeDockerEnvOutput.Yaml = 1 -> ModularPipelines.Minikube.Enums.MinikubeDockerEnvOutput
  • ModularPipelines.Minikube.Enums.MinikubeImageLsFormat.Json = 2 -> ModularPipelines.Minikube.Enums.MinikubeImageLsFormat
  • ModularPipelines.Minikube.Enums.MinikubeImageLsFormat.Short = 0 -> ModularPipelines.Minikube.Enums.MinikubeImageLsFormat

Representative added members:

  • ModularPipelines.Minikube.Enums.MinikubeDockerEnvOutput.Json = 0 -> ModularPipelines.Minikube.Enums.MinikubeDockerEnvOutput
  • ModularPipelines.Minikube.Enums.MinikubeDockerEnvOutput.Text = 1 -> ModularPipelines.Minikube.Enums.MinikubeDockerEnvOutput
  • ModularPipelines.Minikube.Enums.MinikubeDockerEnvOutput.Yaml = 2 -> ModularPipelines.Minikube.Enums.MinikubeDockerEnvOutput
  • ModularPipelines.Minikube.Enums.MinikubeImageLsFormat.Json = 0 -> ModularPipelines.Minikube.Enums.MinikubeImageLsFormat
  • ModularPipelines.Minikube.Enums.MinikubeImageLsFormat.Short = 1 -> ModularPipelines.Minikube.Enums.MinikubeImageLsFormat

Command coverage

Command coverage report:

  • minikube (v1.39.0): 48 commands, tree bf42616787394cb9655a39166d359fda44cf62395db38aa427f98dc1b9f67bd6
    • Baseline comparison: 48 commands at v1.39.0 -> 48 commands at v1.39.0

Verification

  • Solution builds successfully

🤖 Generated with ModularPipelines.OptionsGenerator

@thomhurst thomhurst added automated dependencies Pull requests that update a dependency file labels Sep 6, 2026
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 6, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-09-08T09:56:18.850542Z ecaeed1 New commits
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@coderabbitai

coderabbitai Bot commented Sep 6, 2026

Copy link
Copy Markdown

Review Change Stack

Important

Review skipped

Review was skipped due to path filters

⛔ Files ignored due to path filters (1)
  • src/ModularPipelines.Minikube/Generated/Minikube.Generation.json is excluded by !**/generated/**

CodeRabbit blocks several paths by default. You can override this behavior by explicitly including those paths in the path filters. For example, including **/dist/** will override the default block on the dist directory, by removing the pattern from both the lists.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: e9d88bf4-5ab9-44ec-975a-2de4fec110d9

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: 3c5c55fb-c8de-4cb6-98bd-38d9aeefaa55

📥 Commits

Reviewing files that changed from the base of the PR and between 479e0f2 and 3393b4e.

⛔ Files ignored due to path filters (5)
  • src/ModularPipelines.Minikube/Enums/MinikubeDockerEnvOutput.Generated.cs is excluded by !**/*.generated.*
  • src/ModularPipelines.Minikube/Enums/MinikubeImageLsFormat.Generated.cs is excluded by !**/*.generated.*
  • src/ModularPipelines.Minikube/Enums/MinikubeStartDriver.Generated.cs is excluded by !**/*.generated.*
  • src/ModularPipelines.Minikube/Generated/Minikube.Generation.json is excluded by !**/generated/**
  • src/ModularPipelines.Minikube/Options/MinikubeStartOptions.Generated.cs is excluded by !**/*.generated.*
📒 Files selected for processing (2)
  • src/ModularPipelines.Minikube/PublicAPI.Shipped.txt
  • src/ModularPipelines.Minikube/PublicAPI.Unshipped.txt
💤 Files with no reviewable changes (1)
  • src/ModularPipelines.Minikube/PublicAPI.Shipped.txt

Included review availability: Your plan provides up to 4 included reviews per hour; 2 remain after this review.


📝 Walkthrough

Walkthrough

The change updates Minikube public API tracking. It removes enum members from the shipped API file, removes their removal markers from the unshipped API file, and records new numeric values for the active members.

Changes

Minikube enum API updates

Layer / File(s) Summary
Update enum API tracking
src/ModularPipelines.Minikube/PublicAPI.Shipped.txt, src/ModularPipelines.Minikube/PublicAPI.Unshipped.txt
The shipped API file removes the affected enum members. The unshipped API file re-adds the members with updated numeric values for MinikubeDockerEnvOutput, MinikubeImageLsFormat, and MinikubeStartDriver.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Merge Risk: 🟡 Moderate · up to 3393b

This update exposes generated Minikube option models, but some option descriptions remain truncated or polluted by default-value text. Consumers of generated documentation or metadata may receive misleading option guidance, so regeneration with the parsing fix is needed before merge.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main change: an automated update to Minikube CLI options. It is concise and directly related to the API and enum updates.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch automated/update-cli-options-minikube

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

A rabbit checks each enum line
Values hop into order fine
Shipped marks fade from view
Unshipped entries join the queue
Minikube’s API path is clear

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actions Bot commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

Review

This PR is an automated regen of the minikube CLI options after a generator change (updated generatorSourceSha256), touching only MinikubeStartOptions.Generated.cs and the generation manifest — no tool-version bump, no other files.

Blocking: doc-comment fix is incomplete, leaves garbled XML docs

The diff appends the correct trailing sentence to three flag descriptions, but leaves a pre-existing garbled fragment in front of it rather than replacing it:

  • MinikubeStartOptions.Generated.cs:67 (BaseImage):
    /// v0.0.51@sha256:4a1c825b61479e6c898851ea66f13c620aaeab6002746e95067fc2c4b38a0b24': The base image to use for docker/podman drivers. Intended for local development.
    
  • MinikubeStartOptions.Generated.cs:325 (IsoUrl):
    /// //storage.googleapis.com/minikube/iso/minikube-v1.39.0-amd64.iso,https://github.com/...iso]: Locations to fetch the minikube ISO from.
    
  • MinikubeStartOptions.Generated.cs:367 (KvmQemuUri):
    /// ///system': The KVM QEMU connection URI. (kvm2 driver only)
    

In each case the leading fragment is the tail of minikube's wrapped (default "...") annotation, which the scraper's wrapped-description accumulation (CliScraperBase.AccumulateWrappedDescription) is mis-parsing as part of the description instead of recognizing/stripping it as a default-value annotation. Since the tool version didn't change (still v1.39.0) and only generatorSourceSha256 moved, this regression/gap is coming from the generator-side wrapped-description logic itself, not from upstream minikube help text changing.

Why this matters: these are public, shipped XML doc comments — anyone hovering BaseImage, IsoUrl, or KvmQemuUri in their IDE sees IntelliSense text that opens with a dangling hash/URL/path fragment before the real sentence, which reads as broken/untrustworthy documentation rather than a helpful description.

Suggested fix: per CLAUDE.md, fix this in the scraper/generator (not by hand-editing the generated file). Since minikube's cobra help wraps the (default "...") parenthetical across lines before continuing the real description on a later line, AccumulateWrappedDescription/IsContinuationLine need to recognize a wrapped (default ...) annotation (opening paren with no matching close on the same line) and exclude those continuation lines from the accumulated description text, the same way inline (default ...) suffixes are presumably already stripped elsewhere. Ideally add a regression test in MinikubeCliScraperTests (or a shared ContinuationLineTests case) using a fixture with a long multi-line-wrapped default value, so this class of bug is caught before the next automated regen PR ships it.

No other issues found — the JSON manifest hash bump and the rest of the option-class diff look like a clean, expected mechanical regen.

@thomhurst
thomhurst force-pushed the automated/update-cli-options-minikube branch from abae0fa to 3e65df1 Compare September 6, 2026 06:49
@github-actions

github-actions Bot commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

Review

Still the same automated minikube CLI options regen (only `MinikubeStartOptions.Generated.cs` and the generation manifest touched), and the previously-flagged issue on this PR is still present and unaddressed at the new head.

Blocking: doc-comment fix is incomplete, leaves garbled XML docs (unresolved from prior review)

The diff appends the correct trailing sentence to three flag descriptions, but still leaves the pre-existing garbled fragment in front of it instead of replacing it:

  • MinikubeStartOptions.Generated.cs (BaseImage):
    /// v0.0.51@sha256:4a1c825b61479e6c898851ea66f13c620aaeab6002746e95067fc2c4b38a0b24': The base image to use for docker/podman drivers. Intended for local development.
    
  • MinikubeStartOptions.Generated.cs (IsoUrl):
    /// //storage.googleapis.com/minikube/iso/minikube-v1.39.0-amd64.iso,https://github.com/...iso]: Locations to fetch the minikube ISO from.
    
  • MinikubeStartOptions.Generated.cs (KvmQemuUri):
    /// ///system': The KVM QEMU connection URI. (kvm2 driver only)
    

The leading fragment in each case is the tail of minikube's line-wrapped (default "...") annotation. The scraper's wrapped-description accumulation (CliScraperBase — see AccumulateWrappedDescription/IsContinuationLine, shared across all *CliScraper implementations in tools/ModularPipelines.OptionsGenerator) is treating that wrapped default-value continuation as part of the real description instead of stripping it, the same way an inline (default ...) suffix is presumably already stripped elsewhere.

Why this matters: these are public, shipped XML doc comments. Anyone hovering BaseImage, IsoUrl, or KvmQemuUri in their IDE sees IntelliSense text that opens with a dangling hash/URL/path fragment before the real sentence — this reads as broken/untrustworthy documentation, and since the bug lives in the shared base scraper, it will keep corrupting descriptions for any tool whose CLI wraps a (default "...") annotation across multiple lines, not just minikube.

Suggested fix: per CLAUDE.md, fix this in the scraper/generator, not by hand-editing generated output. AccumulateWrappedDescription/IsContinuationLine in CliScraperBase.cs need to recognize a wrapped (default ...) annotation (an opening paren with no matching close on the same line, continuing onto subsequent lines) and exclude those continuation lines from the accumulated description text. Add a regression case to ContinuationLineTests (tools/ModularPipelines.OptionsGenerator/src/ModularPipelines.OptionsGenerator.Tests/Scrapers/Cli/ContinuationLineTests.cs) using a fixture with a long, multi-line-wrapped default value, so this class of bug is caught before the next automated regen PR ships it — this is exactly the kind of case that's easy to miss by eye across dozens of regenerated options files.

Since the underlying generator/scraper code isn't part of this PR's diff, this can't be fixed by editing the generated file here — the generator needs to be fixed first and this PR regenerated from that fix.

No other issues — the JSON manifest hash bump and the rest of the option-class diff are otherwise a clean, expected mechanical regen.

@thomhurst

Copy link
Copy Markdown
Owner Author

The blocking finding is real but the mechanism is different from wrapping: these rows are single lines, and KubectlOptionPattern captured the default with [^:\s]*, so a quoted default containing a colon (kicbase:v0.0.51@sha256:…, [https://…], qemu:///system) was cut at that colon and the rest leaked into the description. Fixed in the generator with a regression test in #4702 (tracked as #4696). Per policy this PR's generated files stay as generated; the push-triggered regeneration after that fix merges will refresh this branch with clean descriptions.

@thomhurst
thomhurst force-pushed the automated/update-cli-options-minikube branch from 3e65df1 to 1313504 Compare September 6, 2026 09:05
@github-actions

github-actions Bot commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

Review

Same automated minikube CLI options regeneration as before (enum reordering, Minikube.Generation.json SHA bump, MinikubeStartOptions.Generated.cs doc-comment tweaks, mechanical PublicAPI.*.txt updates). No new files or logic changed since the last review.

Previously-flagged garbled XML docs: acknowledged, tracked out-of-band, not actionable here

Prior reviews on this PR correctly flagged that BaseImage, IsoUrl, and KvmQemuUri in MinikubeStartOptions.Generated.cs still carry a leftover fragment of minikube's quoted default value in front of the real description (e.g. v0.0.51@sha256:...': The base image to use for docker/podman drivers...). I confirmed this is still present at the current head.

However, @thomhurst's follow-up comment explains the root cause and fix path: the scraper's KubectlOptionPattern was cutting a quoted default at the first internal colon (kicbase:v0.0.51@sha256:..., [https://...], qemu:///system all contain colons after the opening quote), leaking the remainder into the description. That's now fixed with a regression test in PR 4702 (tracked by issue 4696), which is still open/unmerged as of this review.

Per this repo's own policy in CLAUDE.md ("Never hand-tweak auto-generated options in a PR... Fix generated-options problems in the scraper or generator, not in generated output"), this PR correctly does not hand-patch the generated file, since that would just be overwritten by the next regen anyway. Once PR 4702 merges, the push-triggered regeneration bot will refresh this branch with clean descriptions automatically. There's nothing actionable to change in this PR's diff; re-flagging the same finding here would just be noise against a fix that's already in flight elsewhere.

Enum reordering, the generation-manifest hash bump, and the PublicAPI.*.txt changes remain a clean, expected mechanical regen (confirmed no ordinal-dependent usage of the reordered enums elsewhere in the repo).

No actionable findings for this PR.

REVIEW_VERDICT_PLACEHOLDER

@github-actions

github-actions Bot commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

Review (correction: verdict marker was missing from previous comment)

Same automated minikube CLI options regeneration as before (enum reordering, Minikube.Generation.json SHA bump, MinikubeStartOptions.Generated.cs doc-comment tweaks, mechanical PublicAPI.*.txt updates). No new files or logic changed since the last review.

Previously-flagged garbled XML docs: acknowledged, tracked out-of-band, not actionable here

Prior reviews on this PR correctly flagged that BaseImage, IsoUrl, and KvmQemuUri in MinikubeStartOptions.Generated.cs still carry a leftover fragment of minikube's quoted default value in front of the real description (e.g. v0.0.51@sha256:...': The base image to use for docker/podman drivers...). I confirmed this is still present at the current head.

However, @thomhurst's follow-up comment explains the root cause and fix path: the scraper's KubectlOptionPattern was cutting a quoted default at the first internal colon (kicbase:v0.0.51@sha256:..., [https://...], qemu:///system all contain colons after the opening quote), leaking the remainder into the description. That's now fixed with a regression test in PR 4702 (tracked by issue 4696), which is still open/unmerged as of this review.

Per this repo's own policy in CLAUDE.md ("Never hand-tweak auto-generated options in a PR... Fix generated-options problems in the scraper or generator, not in generated output"), this PR correctly does not hand-patch the generated file, since that would just be overwritten by the next regen anyway. Once PR 4702 merges, the push-triggered regeneration bot will refresh this branch with clean descriptions automatically. There's nothing actionable to change in this PR's diff; re-flagging the same finding here would just be noise against a fix that's already in flight elsewhere.

Enum reordering, the generation-manifest hash bump, and the PublicAPI.*.txt changes remain a clean, expected mechanical regen (confirmed no ordinal-dependent usage of the reordered enums elsewhere in the repo).

No actionable findings for this PR.

@thomhurst
thomhurst enabled auto-merge (squash) September 6, 2026 09:51
@thomhurst
thomhurst disabled auto-merge September 6, 2026 14:28
@thomhurst
thomhurst force-pushed the automated/update-cli-options-minikube branch from 1313504 to c112c41 Compare September 6, 2026 14:30
@github-actions

github-actions Bot commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

Review

Same automated minikube CLI options regeneration verified previously (enum reordering in MinikubeDockerEnvOutput, MinikubeImageLsFormat, MinikubeStartDriver, Minikube.Generation.json SHA bump, mechanical PublicAPI.*.txt updates). No hand-written code is touched — everything changed is *.Generated.cs, the generation manifest, or PublicAPI.*.txt.

Enum reordering is safe: all three enums are consumed via [EnumValue("...")] string mapping rather than ordinal, and a repo-wide check shows no ordinal-dependent usage of these enums, so reordering the declaration order (and thus the underlying ordinals) doesn't change runtime behavior anywhere in the codebase.

Previously-flagged garbled XML docs: BaseImage, IsoUrl, and KvmQemuUri in MinikubeStartOptions.Generated.cs still carry a leftover fragment of minikube's quoted default value ahead of the real description (e.g. v0.0.51@sha256:...': The base image to use for docker/podman drivers...). This was already root-caused in this PR's thread: the scraper's KubectlOptionPattern cuts a quoted default at the first internal colon, so defaults containing colons (kicbase:v0.0.51@sha256:..., [https://...], qemu:///system) leak their remainder into the description. Per CLAUDE.md policy, generated-options problems must be fixed in the scraper/generator, not hand-patched in this output, and that fix is already tracked in PR #4702 (issue #4696), still unmerged. Once it merges, the push-triggered regeneration bot will refresh this branch automatically. Nothing new or actionable has changed on this front since the last review confirmed the same.

No other issues found. This PR is a clean, expected mechanical regen.

@thomhurst
thomhurst force-pushed the automated/update-cli-options-minikube branch from c112c41 to 3393b4e Compare September 7, 2026 15:49
@github-actions

github-actions Bot commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

Review

This is a routine auto-generated regeneration of the Minikube options classes (v1.39.0 CLI scrape). The mechanical parts are correct and consistent with the described breaking-API changes:

  • Enum members for MinikubeDockerEnvOutput, MinikubeImageLsFormat, and MinikubeStartDriver were re-sorted/re-numbered to match the current CLI output (new docker driver value included). This is an inherent, expected breaking change of the generator and is properly reflected in PublicAPI.Shipped.txt / PublicAPI.Unshipped.txt.
  • No generated files were hand-edited (consistent with the repo rule to only fix the scraper/generator, never the generated output).

Actionable finding: corrupted XML doc summaries from the scraper's default-value parsing

Three properties in MinikubeStartOptions.Generated.cs now ship doc comments with garbled, out-of-order text — a leftover fragment of the CLI's (default ...) annotation is prepended before the real description instead of being stripped:

/// <summary>
/// v0.0.51@sha256:4a1c825b61479e6c898851ea66f13c620aaeab6002746e95067fc2c4b38a0b24': The base image to use for docker/podman drivers. Intended for local development.
/// </summary>
public string? BaseImage { get; set; }
/// <summary>
/// //storage.googleapis.com/minikube/iso/minikube-v1.39.0-amd64.iso,https://github.com/kubernetes/minikube/releases/download/v1.39.0/minikube-v1.39.0-amd64.iso,https://kubernetes.oss-cn-hangzhou.aliyuncs.com/minikube/iso/minikube-v1.39.0-amd64.iso]: Locations to fetch the minikube ISO from.
/// </summary>
public string? IsoUrl { get; set; }
/// <summary>
/// ///system': The KVM QEMU connection URI. (kvm2 driver only)
/// </summary>
public string? KvmQemuUri { get; set; }

These are not usable IntelliSense docs — a truncated sha256 digest, a protocol-stripped URL list, and a bare ///system': fragment all appear before the actual sentence. This points to a real bug in CobraCliScraper's option-row/description parsing (MatchOptionRow + AccumulateWrappedDescription in tools/ModularPipelines.OptionsGenerator/src/ModularPipelines.OptionsGenerator/Scrapers/Cli/CobraCliScraper.cs): when a flag's (default ...) annotation contains a colon (a sha256 digest, a qemu:///system URI, or a comma-separated URL list) and/or wraps across multiple help-text lines, the trailing default-value text isn't stripped before the description is captured/joined, so fragments of it leak into the emitted summary in the wrong order relative to the real sentence.

Since AccumulateWrappedDescription is shared by ~17 scrapers (not just Cobra-based ones), this is likely not Minikube-specific — other tools' generated options may carry the same kind of corrupted doc text whenever a default value contains a colon or wraps across lines.

Why this matters: consumers rely on these XML doc comments for IntelliSense/tooltips when configuring pipeline modules; shipping doc text like v0.0.51@sha256:...': ahead of the real description actively misleads rather than helps.

Suggested fix (in the generator, not the generated output): before the description is captured, strip the (default ...) clause — including any continuation lines it wraps onto — generically in the shared parsing path (e.g. in AccumulateWrappedDescription or a normalization step applied right after it), rather than per-tool. Add a regression test with a synthetic multi-line flag row whose default value contains a colon (sha256 digest / URL list / scheme:///path URI) to CliScraperTraversalTests/ContinuationLineTests to lock in the fix, then let the bot regenerate.

Note: this corruption pre-dates this PR — the "before" state for these three properties was already truncated at the colon with no description at all (this PR actually restores the real sentence, just doesn't remove the leftover fragment). chatgpt-codex-connector and coderabbitai's automated reviews on this PR did not flag it as a diff-level issue (CodeRabbit's description-level risk note did mention "descriptions remain truncated or polluted by default-value text" but wasn't posted as an actionable comment). Since this is a generic generator bug rather than something to hand-fix in this generated file, I'd recommend tracking/fixing it in CobraCliScraper in a follow-up change and letting the next scheduled regeneration pick up the corrected text — this specific PR doesn't need to be blocked on that follow-up if the team's convention is to keep merging current generator output as-is.

@thomhurst
thomhurst force-pushed the automated/update-cli-options-minikube branch from 3393b4e to ecaeed1 Compare September 8, 2026 09:52
@github-actions

github-actions Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Review

This is an automated ModularPipelines.OptionsGenerator regeneration for the minikube module: enum member reordering (alphabetical, per CliEnumDefinition.OrderValues -- intentional, documented generator behavior) plus consistent PublicAPI.Shipped/Unshipped.txt bookkeeping, plus three XML doc-comment updates. No hand-written logic is touched, and no other file references the reordered enums by name or ordinal, so the mechanical parts of this PR look correct and safe.

Finding: regenerated doc comments still ship corrupted default-value prefixes

src/ModularPipelines.Minikube/Options/MinikubeStartOptions.Generated.cs -- this PR touches the doc comments for BaseImage (line 67), IsoUrl (line 325), and KvmQemuUri (line 367), appending the real description text that was previously missing. However, each summary still leads with a garbled fragment of the CLI's (default ...) value:

  • BaseImage: v0.0.51@sha256:4a1c825b...38a0b24': The base image to use for docker/podman drivers...
  • IsoUrl: //storage.googleapis.com/minikube/iso/...aliyuncs.com/.../minikube-v1.39.0-amd64.iso]: Locations to fetch the minikube ISO from.
  • KvmQemuUri: ///system': The KVM QEMU connection URI...

In all three cases the default value contains a colon (inside a sha256 hash, a URL list, or a qemu:///system URI), which appears to confuse the scraper's description-extraction regex -- likely in CobraCliScraper under tools/ModularPipelines.OptionsGenerator -- into splitting at the wrong colon and leaving the leading fragment attached. The base branch already had this corruption (previously the comment was only the garbage fragment, with the description dropped entirely); this diff regenerates these exact three doc comments but still ships the garbled prefix, so IntelliSense/generated docs for these three options show a nonsensical partial hash/URL/URI ahead of the actual help text.

Per repo guidance, generated option files must not be hand-edited -- the real fix belongs in the scraper's description-splitting logic (treat colons inside default-value hashes/URLs/URIs as non-separators, e.g. only split on the first colon following the closing backtick or ] that delimits the default value) followed by regeneration. Not blocking the mechanical regeneration itself, but worth a follow-up before relying on these three doc comments.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automated dependencies Pull requests that update a dependency file

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant