feat(set-labels): migrate to SDK v1.0.4 with WithDocs support (#1258)

- Add //go:embed for README.md and metadata.yaml
- Pass fn.WithDocs(readme, metadata) to fn.AsMain for --help and --doc
- Update fn.WithContext to use context.Context directly (API change)
- Bump SDK dependency from v1.0.3 to v1.0.4

The function now supports:
- --help: renders human-readable docs from README.md
- --doc: renders machine-readable JSON for kpt fn doc
- Standalone file mode (positional args)

This is Phase 2 of the SDK migration plan for the 8 already-migrated
functions. The orphaned generated/docs.go is left in place for now to
avoid disrupting the shared mdtogo Makefile target.

Signed-off-by: Fiachra Corcoran <fiachra.corcoran@est.tech>

Author: efiacor

functions/go/set-labels/go.mod

@@ -2,7 +2,7 @@ module github.com/kptdev/krm-functions-catalog/functions/go/set-labels
 
 go 1.26.3
 
-require github.com/kptdev/krm-functions-sdk/go/fn v1.0.3
+require github.com/kptdev/krm-functions-sdk/go/fn v1.0.4
 
 require (
 	github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc // indirect

functions/go/set-labels/go.sum

@@ -43,8 +43,8 @@ github.com/google/gnostic-models v0.7.1 h1:SisTfuFKJSKM5CPZkffwi6coztzzeYUhc3v4y
 github.com/google/gnostic-models v0.7.1/go.mod h1:whL5G0m6dmc5cPxKc5bdKdEN3UjI7OUGxBlw57miDrQ=
 github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
 github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
-github.com/kptdev/krm-functions-sdk/go/fn v1.0.3 h1:Gmkqbc2cbwJxamVoRSs409TZinuNGZaMYmNmlQcF6Bs=
-github.com/kptdev/krm-functions-sdk/go/fn v1.0.3/go.mod h1:+MgNIVQMGs6WcNhQZYIbgFINnmskX8VMYcUvJBtE01M=
+github.com/kptdev/krm-functions-sdk/go/fn v1.0.4 h1:2Cl68JgaNva8eZ/YzqiZNOXkjIhavqLsoGOnxYN13Oc=
+github.com/kptdev/krm-functions-sdk/go/fn v1.0.4/go.mod h1:NqMHvghKasESpZImCDIOp5r10g3vmOeCcHzvjyL+4vk=
 github.com/monochromegane/go-gitignore v0.0.0-20200626010858-205db1a8cc00 h1:n6/2gBQ3RWajuToeY6ZtZTIKv2v7ThUy5KKusIT0yc0=
 github.com/monochromegane/go-gitignore v0.0.0-20200626010858-205db1a8cc00/go.mod h1:Pm3mSP3c5uWn86xMLZ5Sa7JB9GsEZySvHYXCTK4E9q4=
 github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4=
@@ -79,6 +79,8 @@ k8s.io/klog/v2 v2.140.0 h1:Tf+J3AH7xnUzZyVVXhTgGhEKnFqye14aadWv7bzXdzc=
 k8s.io/klog/v2 v2.140.0/go.mod h1:o+/RWfJ6PwpnFn7OyAG3QnO47BFsymfEfrz6XyYSSp0=
 k8s.io/kube-openapi v0.0.0-20260520065146-aa012df4f4af h1:zLXA2Irn14q2/06WMkxViyr7YCPUO2lJ0QYE9Juy5vA=
 k8s.io/kube-openapi v0.0.0-20260520065146-aa012df4f4af/go.mod h1:V/QaCUYDa+0QpcHhVVc5l99Uz56wEMEXBSj9oCDkNDY=
+pgregory.net/rapid v1.3.0 h1:vBvO0VSqti75J1jjYqpgPNBLKMd1+gxa9fYo7vk/Exc=
+pgregory.net/rapid v1.3.0/go.mod h1:dPlE4OBBxgXPqkP79flB6sJL1dx5azpI7HQ9MY9Z7uk=
 sigs.k8s.io/json v0.0.0-20250730193827-2d320260d730 h1:IpInykpT6ceI+QxKBbEflcR5EXP7sU1kvOlxwZh5txg=
 sigs.k8s.io/json v0.0.0-20250730193827-2d320260d730/go.mod h1:mdzfpAEoE6DHQEN0uh9ZbOCuHbLK5wOm7dK4ctXE9Tg=
 sigs.k8s.io/kustomize/kyaml v0.21.1 h1:IVlbmhC076nf6foyL6Taw4BkrLuEsXUXNpsE+ScX7fI=

functions/go/set-labels/run.go

@@ -1,4 +1,4 @@
-// Copyright 2022 The kpt Authors
+// Copyright 2022-2026 The kpt Authors
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,15 +18,22 @@ package main
 
 import (
 	"context"
+	_ "embed"
 
 	"github.com/kptdev/krm-functions-catalog/functions/go/set-labels/setlabels"
 	"github.com/kptdev/krm-functions-sdk/go/fn"
 )
 
+//go:embed README.md
+var readme []byte
+
+//go:embed metadata.yaml
+var metadata []byte
+
 func NewTransformer() fn.ResourceListProcessor {
-	return fn.WithContext(fn.Context{Context: context.Background()}, &setlabels.SetLabels{})
+	return fn.WithContext(context.Background(), &setlabels.SetLabels{})
 }
 
 func run() error {
-	return fn.AsMain(NewTransformer())
+	return fn.AsMain(NewTransformer(), fn.WithDocs(readme, metadata))
 }

functions/go/set-labels/run_js.go

@@ -1,4 +1,4 @@
-// Copyright 2022 The kpt Authors
+// Copyright 2022-2026 The kpt Authors
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,6 +17,7 @@
 package main
 
 import (
+	"context"
 	"syscall/js"
 
 	"github.com/kptdev/krm-functions-catalog/functions/go/set-labels/setlabels"
@@ -37,7 +38,7 @@ func run() error {
 }
 
 func transformLabels(input []byte) ([]byte, error) {
-	runner := fn.WithContext(fn.Context{Context: nil}, &setlabels.SetLabels{})
+	runner := fn.WithContext(context.Background(), &setlabels.SetLabels{})
 	return fn.Run(runner, []byte(input))
 }