Skip to content

docs(manifest): name .NET in help text, messages and comments - #1682

Merged
Jeppe Fredsgaard Blaabjerg (jfblaa) merged 3 commits into
v1.xfrom
jfblaa/dotnet-socket-facts-text
Nov 3, 2026
Merged

Jeppe Fredsgaard Blaabjerg (jfblaa) merged 3 commits into
v1.xfrom
jfblaa/dotnet-socket-facts-text

Conversation

@jfblaa

@jfblaa Jeppe Fredsgaard Blaabjerg (jfblaa) commented Oct 31, 2026 •

Copy link
Copy Markdown
Contributor

LLM Description written by Claude Code:claude-opus-5-5

What

User-facing wording and comment edits that go with .NET support (#1678), split out so the code and test PRs below stay focused.

  • --help text and messages for dynamic SBOM inference, socket manifest setup, socket manifest and scan create/scan reach list .NET next to Gradle, sbt and Maven, with the matching help snapshots and message assertions.
  • Comments on the shared facts pipeline (build-tool helpers, record protocol, sidecar, reachability) describe it in build-tool-neutral terms instead of JVM-only ones.

No behaviour change.

🤖 Generated with Claude Code


Note

Low Risk
Documentation and help-text only; no logic or API behavior changes.

Overview
Updates user-facing strings and internal comments so .NET appears alongside Gradle, sbt, and Maven everywhere the CLI already treats those ecosystems together—without changing runtime behavior.

CLI help and errors: --help output and shared flag text (--exclude-paths, --dynamic-sbom-inference, --auto-manifest) now mention .NET projects and dynamic SBOM inference for .NET. The top-level socket manifest help lists dotnet [beta]. “No build root found” messages for dynamic SBOM inference, recursive setup, and scan flows now read “Gradle, sbt, Maven or .NET” instead of JVM-only wording. Matching inline snapshots and unit test assertions were updated.

Developer comments: Docs on the facts pipeline (rollup copy step, build-tool.mts, record protocol in records.mts, run.mts entryFile, reachability sidecar comment) were broadened from JVM-only to build-tool-neutral or explicitly include dotnet where relevant.

Reviewed by Cursor Bugbot for commit 37628d6. Configure here.

commandName: 'dynamic-sbom-inference',
description:
'Recursively discover gradle/sbt/maven build roots and generate a Socket facts SBOM for each',
'Recursively discover gradle/sbt/maven/dotnet build roots and generate a Socket facts SBOM for each',

@jdalton John-David Dalton (jdalton) Nov 1, 2026 •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: spelling out the build tools makes this label easier to scan.

Suggested change
'Recursively discover gradle/sbt/maven/dotnet build roots and generate a Socket facts SBOM for each',
'Recursively discover .NET, Gradle, Maven, and sbt build roots and generate a Socket facts SBOM for each',

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[agent] Fixed in 9cbc291.

type: 'boolean',
description:
'Generates dynamic SBOMs via the Gradle/sbt/Maven package manager tools for more accurate results than static resolution. Scans every build root under CWD first, so the configurator only asks about ecosystems actually found; --exclude-paths matches are bulk-disabled, others configured individually.',
'Generates dynamic SBOMs via the Gradle/sbt/Maven/.NET package manager tools for more accurate results than static resolution. Scans every build root under CWD first, so the configurator only asks about ecosystems actually found; --exclude-paths matches are bulk-disabled, others configured individually.',

@jdalton John-David Dalton (jdalton) Nov 1, 2026 •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: the slash-separated list and semicolon make this help text hard to scan.

Suggested change
'Generates dynamic SBOMs via the Gradle/sbt/Maven/.NET package manager tools for more accurate results than static resolution. Scans every build root under CWD first, so the configurator only asks about ecosystems actually found; --exclude-paths matches are bulk-disabled, others configured individually.',
'Uses .NET, Gradle, Maven, and sbt tools to generate dynamic SBOMs with more accurate results than static resolution. It scans build roots under CWD, asks only about detected ecosystems, then disables roots matched by --exclude-paths and configures the rest individually.',

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[agent] Fixed in 9cbc291.

Comment thread src/commands/manifest/cmd-manifest.mts Outdated
Comment on lines +44 to +45
Currently supported language: bazel [beta], dotnet [beta], gradle [beta],
kotlin (through gradle) [beta], maven [beta], scala [beta].

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: this list contains build tools and ecosystems, not only languages.

Suggested change
Currently supported language: bazel [beta], dotnet [beta], gradle [beta],
kotlin (through gradle) [beta], maven [beta], scala [beta].
Currently supported ecosystems: bazel [beta], dotnet [beta], gradle [beta],
kotlin (through gradle) [beta], maven [beta], scala [beta].

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[agent] Fixed in 9cbc291.

Comment on lines +91 to +92
// failed in the same projects (or, outside any project, also outside one): the
// lenient resolver reports both forms for one failure.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: the parenthetical is hard to parse.

Suggested change
// failed in the same projects (or, outside any project, also outside one): the
// lenient resolver reports both forms for one failure.
// failed for the same projects, or when both failures have no project. The
// lenient resolver reports both forms for a single failure.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[agent] Fixed in 9cbc291 - also, #1678 now records failures with no project under '', so this wording matches the code.

@jfblaa
Jeppe Fredsgaard Blaabjerg (jfblaa) force-pushed the jfblaa/dotnet-socket-facts-text branch 2 times, most recently from 3a50bf3 to 4b720a4 Compare November 2, 2026 15:11
@jfblaa
Jeppe Fredsgaard Blaabjerg (jfblaa) force-pushed the jfblaa/dotnet-socket-facts-text branch 2 times, most recently from f0a5e78 to ce3cb76 Compare November 3, 2026 11:29
Base automatically changed from jfblaa/dotnet-socket-facts-tests to v1.x November 3, 2026 11:29
Help text and messages for dynamic SBOM inference, the setup wizards,
`socket manifest` and `scan create`/`scan reach` now list .NET next to
Gradle, sbt and Maven, and comments on the shared facts pipeline describe
it in build-tool-neutral terms.
List the build tools in full in the dynamic-SBOM-inference and setup help,
call the supported list ecosystems, and clarify the no-project dedup rule.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@jfblaa
Jeppe Fredsgaard Blaabjerg (jfblaa) merged commit d484802 into v1.x Nov 3, 2026
10 checks passed
@jfblaa
Jeppe Fredsgaard Blaabjerg (jfblaa) deleted the jfblaa/dotnet-socket-facts-text branch November 3, 2026 11:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

3 participants