feat:[SSCA-3948]: implement SCS client for artifact source management and filtering (#37)

* feat: implement SCS client for artifact source management and filtering

Author: deepharness

README.md

@@ -100,6 +100,25 @@ Toolset Name: `chaos`
 - `chaos_experiment_run`:  Run a specific chaos experiment.
 - `chaos_experiment_run_result`:  Get the result of a specific chaos experiment run.
 
+#### Supply Chain Security (SCS) Toolset
+
+Toolset Name: `scs`
+
+- `list_artifact_sources`: List all artifact sources available in Harness SCS for a specific organization and project.
+- `list_artifacts_per_source`: List all artifacts within a specific artifact source.
+- `get_artifact_overview`: Get metadata, security findings, SBOM, and compliance status for a specific artifact.
+- `get_artifact_chain_of_custody`: Retrieve the full chain of custody (event history) for a specific artifact.
+- `fetch_compliance_results_by_artifact`: Fetch compliance results for a specific artifact.
+- `get_code_repository_overview`: Get an overview of vulnerabilities, SBOM, compliance issues, and policy violations for a code repository.
+- `list_scs_code_repos`: List all code repositories scanned by Harness SCS.
+
+#### Security Test Orchestration (STO) Toolset
+
+Toolset Name: `sto`
+
+- `frontend_all_issues_list`: List and filter security issues in Harness STO by target, pipeline, tool, severity, exemption status, and type.
+
+
 #### Logs Toolset
 
 Toolset Name: `logs`

client/scs/builder.go

@@ -0,0 +1,141 @@
+package scs
+
+import "github.com/harness/harness-mcp/client/scs/generated"
+
+type artifactListingRequestBodyBuilder struct {
+	b generated.ArtifactListingRequestBody
+}
+
+func ArtifactListingRequestBodyBuilder() *artifactListingRequestBodyBuilder {
+	return &artifactListingRequestBodyBuilder{b: generated.ArtifactListingRequestBody{}}
+}
+
+func (bb *artifactListingRequestBodyBuilder) WithArtifactType(v []generated.ArtifactType) *artifactListingRequestBodyBuilder {
+	if len(v) > 0 {
+		bb.b.ArtifactType = &v
+	}
+	return bb
+}
+func (bb *artifactListingRequestBodyBuilder) WithComponentFilter(v []generated.ComponentFilter) *artifactListingRequestBodyBuilder {
+	if len(v) > 0 {
+		bb.b.ComponentFilter = &v
+	}
+	return bb
+}
+func (bb *artifactListingRequestBodyBuilder) WithEnvironmentType(v generated.ArtifactListingRequestBodyEnvironmentType) *artifactListingRequestBodyBuilder {
+	if v != "" {
+		bb.b.EnvironmentType = &v
+	}
+	return bb
+}
+func (bb *artifactListingRequestBodyBuilder) WithLicenseFilter(v generated.LicenseFilter) *artifactListingRequestBodyBuilder {
+	// assuming LicenseFilter is a struct with zero-value checkable
+	var zero generated.LicenseFilter
+	if v != zero {
+		bb.b.LicenseFilter = &v
+	}
+	return bb
+}
+func (bb *artifactListingRequestBodyBuilder) WithPolicyViolation(v generated.ArtifactListingRequestBodyPolicyViolation) *artifactListingRequestBodyBuilder {
+	if v != "" {
+		bb.b.PolicyViolation = &v
+	}
+	return bb
+}
+func (bb *artifactListingRequestBodyBuilder) WithSearchTerm(v string) *artifactListingRequestBodyBuilder {
+	if v != "" {
+		bb.b.SearchTerm = &v
+	}
+	return bb
+}
+func (bb *artifactListingRequestBodyBuilder) WithVerificationStatus(v generated.VerificationStatus) *artifactListingRequestBodyBuilder {
+	if v != "" {
+		bb.b.VerificationStatus = &v
+	}
+	return bb
+}
+
+func (bb *artifactListingRequestBodyBuilder) Build() generated.ArtifactListingRequestBody {
+	return bb.b
+}
+
+type codeRepositoryListingRequestBodyBuilder struct {
+	b generated.CodeRepositoryListingRequestBody
+}
+
+type complianceResultByArtifactFilterBuilder struct {
+	b generated.ComplianceResultByArtifactFilter
+}
+
+func ComplianceResultByArtifactFilterBuilder() *complianceResultByArtifactFilterBuilder {
+	return &complianceResultByArtifactFilterBuilder{b: generated.ComplianceResultByArtifactFilter{}}
+}
+
+func (bb *complianceResultByArtifactFilterBuilder) WithComplianceId(v string) *complianceResultByArtifactFilterBuilder {
+	if v != "" {
+		bb.b.ComplianceId = &v
+	}
+	return bb
+}
+
+func (bb *complianceResultByArtifactFilterBuilder) WithSearchTerm(v string) *complianceResultByArtifactFilterBuilder {
+	if v != "" {
+		bb.b.SearchTerm = &v
+	}
+	return bb
+}
+
+func (bb *complianceResultByArtifactFilterBuilder) WithSeverity(v generated.ComplianceCheckSeverity) *complianceResultByArtifactFilterBuilder {
+	if v != "" {
+		bb.b.Severity = &v
+	}
+	return bb
+}
+
+func (bb *complianceResultByArtifactFilterBuilder) WithStandards(v []generated.ComplianceStandardType) *complianceResultByArtifactFilterBuilder {
+	if len(v) > 0 {
+		bb.b.Standards = &v
+	}
+	return bb
+}
+
+func (bb *complianceResultByArtifactFilterBuilder) WithStatus(v []generated.ComplianceResultStatus) *complianceResultByArtifactFilterBuilder {
+	if len(v) > 0 {
+		bb.b.Status = &v
+	}
+	return bb
+}
+
+func (bb *complianceResultByArtifactFilterBuilder) Build() generated.ComplianceResultByArtifactFilter {
+	return bb.b
+}
+
+func CodeRepositoryListingRequestBodyBuilder() *codeRepositoryListingRequestBodyBuilder {
+	return &codeRepositoryListingRequestBodyBuilder{b: generated.CodeRepositoryListingRequestBody{}}
+}
+
+func (bb *codeRepositoryListingRequestBodyBuilder) WithDependencyFilter(v []generated.ComponentFilter) *codeRepositoryListingRequestBodyBuilder {
+	if len(v) > 0 {
+		bb.b.DependencyFilter = &v
+	}
+	return bb
+}
+
+func (bb *codeRepositoryListingRequestBodyBuilder) WithLicenseFilter(v generated.LicenseFilter) *codeRepositoryListingRequestBodyBuilder {
+	var zero generated.LicenseFilter
+	if v != zero {
+		bb.b.LicenseFilter = &v
+	}
+	return bb
+}
+
+func (bb *codeRepositoryListingRequestBodyBuilder) WithSearchTerm(v string) *codeRepositoryListingRequestBodyBuilder {
+	if v != "" {
+		bb.b.SearchTerm = &v
+	}
+	return bb
+}
+
+func (bb *codeRepositoryListingRequestBodyBuilder) Build() generated.CodeRepositoryListingRequestBody {
+	return bb.b
+}