klasik 2.0.8 → 2.2.0

package/dist/plugins/ajv-validator-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ajv-validator-plugin.js","sourceRoot":"","sources":["../../src/plugins/ajv-validator-plugin.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "klasik",
-  "version": "2.0.8",
-  "description": "TypeScript code generator from OpenAPI/CRD/JSON Schema - rebuilt from ground up with AST-based generation",
+  "version": "2.2.0",
+  "description": "TypeScript code generator from OpenAPI/CRD/JSON Schema/Go structs - rebuilt from ground up with AST-based generation",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
@@ -10,12 +10,14 @@
   "files": [
     "dist/",
     "templates/",
+    "tools/go-schema-gen/",
     "docs/",
     "demo-output/",
     "README.md"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "npm run build:go && tsc",
+    "build:go": "cd tools/go-schema-gen && ./build.sh || echo 'Warning: Go tool build failed. Go generation will not be available.'",
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",

package/tools/go-schema-gen/README.md

@@ -0,0 +1,147 @@
+# go-schema-gen
+
+Go tool that generates JSON Schema from Go structs using runtime reflection.
+
+## Overview
+
+This tool uses Go's reflection API and the `invopop/jsonschema` library to generate JSON Schema Draft 2020-12 from registered Go types. It's used by Klasik to enable TypeScript code generation from Go structs.
+
+## Automatic Installation
+
+**You don't need to build this manually!** When you run `klasik generate-go` for the first time, it will automatically:
+
+1. Check if Go is installed
+2. Run `go mod tidy` to download dependencies
+3. Build the binary to `../../dist/bin/go-schema-gen`
+
+This only happens once - subsequent runs use the cached binary.
+
+## Manual Build (Optional)
+
+If you want to build manually:
+
+```bash
+# From this directory:
+./build.sh
+
+# Or step by step:
+go mod tidy
+go build -o ../../dist/bin/go-schema-gen .
+```
+
+## Usage
+
+```bash
+# Generate JSON Schema for a registered type:
+go-schema-gen --type "helm.sh/helm/v3/pkg/chart.Metadata"
+
+# With options:
+go-schema-gen --type "helm.sh/helm/v3/pkg/chart.Chart" --allow-additional
+```
+
+## Adding New Types
+
+To add new Go packages/structs:
+
+1. **Edit `registry.go`:**
+```go
+import (
+    chart "helm.sh/helm/v3/pkg/chart"
+    mypackage "github.com/org/package"  // Add your import
+)
+
+var typeRegistry = map[string]interface{}{
+    // Existing types
+    "helm.sh/helm/v3/pkg/chart.Metadata": chart.Metadata{},
+
+    // Add your types
+    "github.com/org/package.MyStruct": mypackage.MyStruct{},
+}
+```
+
+2. **Update dependencies:**
+```bash
+go mod tidy
+```
+
+3. **Rebuild:**
+```bash
+./build.sh
+```
+
+4. **Use in Klasik:**
+```bash
+klasik generate-go \
+  --type "github.com/org/package.MyStruct" \
+  --output ./src/types
+```
+
+## Dependencies
+
+- **Go 1.21+**
+- `github.com/invopop/jsonschema` v0.12.0 - JSON Schema generation
+- `helm.sh/helm/v3` v3.14.0 - Example package (Helm chart types)
+
+## How It Works
+
+1. User specifies a type path (e.g., `"helm.sh/helm/v3/pkg/chart.Metadata"`)
+2. Tool looks up the type in `typeRegistry`
+3. Uses `invopop/jsonschema.Reflector` to generate JSON Schema
+4. Outputs JSON to stdout
+
+**Architecture:**
+```
+Go Struct → reflect.TypeOf() → jsonschema.Reflector → JSON Schema → stdout
+```
+
+## Struct Tag Support
+
+The `invopop/jsonschema` library respects these struct tags:
+
+| Tag | Effect | Example |
+|-----|--------|---------|
+| `json:"fieldName"` | Property name | `json:"metadata"` |
+| `json:",omitempty"` | Optional field | `json:"description,omitempty"` |
+| `jsonschema:"required"` | Force required | `jsonschema:"required"` |
+| `jsonschema:"minLength=5"` | Min length | `jsonschema:"minLength=5"` |
+| `jsonschema:"pattern=^[A-Z]"` | Regex pattern | `jsonschema:"pattern=^[A-Z]"` |
+| `jsonschema_description:"..."` | Field description | `jsonschema_description:"Chart name"` |
+
+**Example:**
+```go
+type Chart struct {
+    Name    string `json:"name" jsonschema:"required,minLength=1"`
+    Version string `json:"version" jsonschema:"pattern=^v[0-9]"`
+    Values  map[string]interface{} `json:"values,omitempty"`
+}
+```
+
+## Troubleshooting
+
+**"Type not registered" error:**
+- Add the type to `registry.go` (see "Adding New Types" above)
+- Make sure to import the package
+- Run `go mod tidy`
+- Rebuild with `./build.sh`
+
+**Build errors:**
+- Ensure Go 1.21+ is installed: `go version`
+- Clear module cache: `go clean -modcache`
+- Try: `rm -f go.sum && go mod tidy`
+
+**Import errors:**
+- Check that the package version matches `go.mod`
+- Run `go get <package>@<version>` to update
+
+## Limitations
+
+- **No dynamic loading**: Types must be registered at compile time
+- **Requires recompilation**: Adding new packages needs rebuild
+- **Go installation required**: Cannot run without Go toolchain
+
+## Future Enhancements
+
+- Go plugin support for dynamic type loading
+- Auto-discovery of types in packages
+- Support for `validate` struct tags
+- Pre-built binaries for multiple platforms

package/tools/go-schema-gen/build.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+set -e
+
+echo "Building go-schema-gen..."
+
+# Download dependencies
+echo "Downloading Go dependencies..."
+go mod tidy
+
+# Build binary
+echo "Compiling binary..."
+go build -o ../../dist/bin/go-schema-gen .
+
+echo "✓ Build complete: dist/bin/go-schema-gen"
+
+# Test the binary
+echo ""
+echo "Testing binary..."
+if ../../dist/bin/go-schema-gen --type "helm.sh/helm/v3/pkg/chart.Metadata" > /dev/null 2>&1; then
+    echo "✓ Binary test successful"
+else
+    echo "✗ Binary test failed"
+    exit 1
+fi

package/tools/go-schema-gen/comment_extractor.go

@@ -0,0 +1,128 @@
+package main
+
+import (
+	"go/ast"
+	"os"
+	"path/filepath"
+	"strings"
+
+	"golang.org/x/tools/go/packages"
+)
+
+// CommentMap holds field comments for structs
+type CommentMap map[string]map[string]string // packagePath.TypeName -> fieldName -> description
+
+// ExtractComments extracts struct field comments from Go source code
+func ExtractComments(packagePath string) (CommentMap, error) {
+	// Load the package with full type info and syntax
+	// Set Dir to the directory containing go.mod (tools/go-schema-gen)
+	// This ensures packages.Load can find dependencies regardless of where the binary is run from
+	cfg := &packages.Config{
+		Mode: packages.NeedName | packages.NeedFiles | packages.NeedSyntax | packages.NeedTypes | packages.NeedTypesInfo,
+		Dir:  getModuleDir(),
+	}
+
+	pkgs, err := packages.Load(cfg, packagePath)
+	if err != nil {
+		return nil, err
+	}
+
+	if len(pkgs) == 0 {
+		return nil, nil
+	}
+
+	pkg := pkgs[0]
+	commentMap := make(CommentMap)
+
+	// Process each file in the package
+	for _, file := range pkg.Syntax {
+		// Traverse AST to find struct types and their field comments
+		ast.Inspect(file, func(n ast.Node) bool {
+			typeSpec, ok := n.(*ast.TypeSpec)
+			if !ok {
+				return true
+			}
+
+			structType, ok := typeSpec.Type.(*ast.StructType)
+			if !ok {
+				return true
+			}
+
+			// This is a struct type
+			structKey := pkg.PkgPath + "." + typeSpec.Name.Name
+			fieldComments := make(map[string]string)
+
+			// Extract field comments
+			for _, field := range structType.Fields.List {
+				if field.Doc != nil && len(field.Names) > 0 {
+					fieldName := field.Names[0].Name
+					comment := strings.TrimSpace(field.Doc.Text())
+					if comment != "" {
+						fieldComments[fieldName] = comment
+					}
+				}
+			}
+
+			if len(fieldComments) > 0 {
+				commentMap[structKey] = fieldComments
+			}
+
+			return true
+		})
+	}
+
+	return commentMap, nil
+}
+
+// GetFieldDescription retrieves the description for a specific struct field
+func (cm CommentMap) GetFieldDescription(packagePath, typeName, fieldName string) string {
+	structKey := packagePath + "." + typeName
+	if fields, ok := cm[structKey]; ok {
+		return fields[fieldName]
+	}
+	return ""
+}
+
+// getModuleDir returns the directory containing go.mod
+// This function searches for go.mod starting from the executable's directory
+func getModuleDir() string {
+	// Get the executable path
+	exePath, err := os.Executable()
+	if err != nil {
+		return "."
+	}
+
+	// Resolve symlinks
+	exePath, err = filepath.EvalSymlinks(exePath)
+	if err != nil {
+		return "."
+	}
+
+	// Start from the directory containing the executable
+	dir := filepath.Dir(exePath)
+
+	// Check specific known locations first (for dist/bin/go-schema-gen)
+	// Try ../../tools/go-schema-gen (when binary is in dist/bin/)
+	toolsDir := filepath.Join(dir, "..", "..", "tools", "go-schema-gen")
+	if _, err := os.Stat(filepath.Join(toolsDir, "go.mod")); err == nil {
+		return toolsDir
+	}
+
+	// Search up the directory tree for go.mod
+	for {
+		goModPath := filepath.Join(dir, "go.mod")
+		if _, err := os.Stat(goModPath); err == nil {
+			return dir
+		}
+
+		parent := filepath.Dir(dir)
+		if parent == dir {
+			// Reached the root without finding go.mod
+			break
+		}
+		dir = parent
+	}
+
+	// Fallback to current directory
+	return "."
+}

package/tools/go-schema-gen/go.mod

@@ -0,0 +1,36 @@
+module github.com/koalaops/klasik/tools/go-schema-gen
+
+go 1.22.0
+
+require (
+	github.com/invopop/jsonschema v0.12.0
+	golang.org/x/tools v0.26.0
+	helm.sh/helm/v3 v3.14.0
+	k8s.io/api v0.29.0
+)
+
+require (
+	github.com/Masterminds/semver/v3 v3.2.1 // indirect
+	github.com/bahlo/generic-list-go v0.2.0 // indirect
+	github.com/buger/jsonparser v1.1.1 // indirect
+	github.com/go-logr/logr v1.3.0 // indirect
+	github.com/gogo/protobuf v1.3.2 // indirect
+	github.com/google/gofuzz v1.2.0 // indirect
+	github.com/json-iterator/go v1.1.12 // indirect
+	github.com/mailru/easyjson v0.7.7 // indirect
+	github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
+	github.com/modern-go/reflect2 v1.0.2 // indirect
+	github.com/wk8/go-ordered-map/v2 v2.1.8 // indirect
+	golang.org/x/mod v0.21.0 // indirect
+	golang.org/x/net v0.30.0 // indirect
+	golang.org/x/sync v0.8.0 // indirect
+	golang.org/x/text v0.19.0 // indirect
+	gopkg.in/inf.v0 v0.9.1 // indirect
+	gopkg.in/yaml.v2 v2.4.0 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
+	k8s.io/apimachinery v0.29.0 // indirect
+	k8s.io/klog/v2 v2.110.1 // indirect
+	k8s.io/utils v0.0.0-20230726121419-3b25d923346b // indirect
+	sigs.k8s.io/json v0.0.0-20221116044647-bc3834ca7abd // indirect
+	sigs.k8s.io/structured-merge-diff/v4 v4.4.1 // indirect
+)

package/tools/go-schema-gen/go.sum

@@ -0,0 +1,112 @@
+github.com/Masterminds/semver/v3 v3.2.1 h1:RN9w6+7QoMeJVGyfmbcgs28Br8cvmnucEXnY0rYXWg0=
+github.com/Masterminds/semver/v3 v3.2.1/go.mod h1:qvl/7zhW3nngYb5+80sSMF+FG2BjYrf8m9wsX0PNOMQ=
+github.com/bahlo/generic-list-go v0.2.0 h1:5sz/EEAK+ls5wF+NeqDpk5+iNdMDXrh3z3nPnH1Wvgk=
+github.com/bahlo/generic-list-go v0.2.0/go.mod h1:2KvAjgMlE5NNynlg/5iLrrCCZ2+5xWbdbCW3pNTGyYg=
+github.com/buger/jsonparser v1.1.1 h1:2PnMjfWD7wBILjqQbt530v576A/cAbQvEW9gGIpYMUs=
+github.com/buger/jsonparser v1.1.1/go.mod h1:6RYKKt7H4d4+iWqouImQ9R2FZql3VbhNgx27UK13J/0=
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/go-logr/logr v1.3.0 h1:2y3SDp0ZXuc6/cjLSZ+Q3ir+QB9T/iG5yYRXqsagWSY=
+github.com/go-logr/logr v1.3.0/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY=
+github.com/gogo/protobuf v1.3.2 h1:Ov1cvc58UF3b5XjBnZv7+opcTcQFZebYjWzi34vdm4Q=
+github.com/gogo/protobuf v1.3.2/go.mod h1:P1XiOD3dCwIKUDQYPy72D8LYyHL2YPYrpS2s69NZV8Q=
+github.com/google/go-cmp v0.5.9/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
+github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
+github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
+github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
+github.com/google/gofuzz v1.2.0 h1:xRy4A+RhZaiKjJ1bPfwQ8sedCA+YS2YcCHW6ec7JMi0=
+github.com/google/gofuzz v1.2.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
+github.com/invopop/jsonschema v0.12.0 h1:6ovsNSuvn9wEQVOyc72aycBMVQFKz7cPdMJn10CvzRI=
+github.com/invopop/jsonschema v0.12.0/go.mod h1:ffZ5Km5SWWRAIN6wbDXItl95euhFz2uON45H2qjYt+0=
+github.com/josharian/intern v1.0.0/go.mod h1:5DoeVV0s6jJacbCEi61lwdGj/aVlrQvzHFFd8Hwg//Y=
+github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM=
+github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo=
+github.com/kisielk/errcheck v1.5.0/go.mod h1:pFxgyoBC7bSaBwPgfKdkLd5X25qrDl4LWUI2bnpBCr8=
+github.com/kisielk/gotool v1.0.0/go.mod h1:XhKaO+MFFWcvkIS/tQcRk01m1F5IRFswLeQ+oQHNcck=
+github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=
+github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=
+github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
+github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
+github.com/mailru/easyjson v0.7.7 h1:UGYAvKxe3sBsEDzO8ZeWOSlIQfWFlxbzLZe7hwFURr0=
+github.com/mailru/easyjson v0.7.7/go.mod h1:xzfreul335JAWq5oZzymOObrkdz5UnU4kGfJJLY9Nlc=
+github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
+github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w8PVh93nsPXa1VrQ6jlwL5oN8l14QlcNfg=
+github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
+github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M=
+github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/rogpeppe/go-internal v1.10.0 h1:TMyTOH3F/DB16zRVcYyreMH6GnZZrwQVAoYjRBZyWFQ=
+github.com/rogpeppe/go-internal v1.10.0/go.mod h1:UQnix2H7Ngw/k4C5ijL5+65zddjncjaFoBhdsK/akog=
+github.com/spf13/pflag v1.0.5 h1:iy+VFUOCP1a+8yFto/drg2CJ5u0yRoB7fZw3DKv/JXA=
+github.com/spf13/pflag v1.0.5/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
+github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
+github.com/stretchr/testify v1.8.4 h1:CcVxjf3Q8PM0mHUKJCdn+eZZtm5yQwehR5yeSVQQcUk=
+github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
+github.com/wk8/go-ordered-map/v2 v2.1.8 h1:5h/BUHu93oj4gIdvHHHGsScSTMijfx5PeYkE/fJgbpc=
+github.com/wk8/go-ordered-map/v2 v2.1.8/go.mod h1:5nJHM5DyteebpVlHnWMV0rPz6Zp7+xBAnxjb1X5vnTw=
+github.com/yuin/goldmark v1.1.27/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
+github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
+golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
+golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI=
+golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto=
+golang.org/x/mod v0.2.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
+golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
+golang.org/x/mod v0.21.0 h1:vvrHzRwRfVKSiLrG+d4FMl/Qi4ukBCE6kZlTUkDYRT0=
+golang.org/x/mod v0.21.0/go.mod h1:6SkKJ3Xj0I0BrPOZoBy3bdMptDDU9oJrpohJ3eWZ1fY=
+golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
+golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
+golang.org/x/net v0.0.0-20200226121028-0de0cce0169b/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
+golang.org/x/net v0.0.0-20201021035429-f5854403a974/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU=
+golang.org/x/net v0.30.0 h1:AcW1SDZMkb8IpzCdQUaIq2sP4sZ4zw+55h6ynffypl4=
+golang.org/x/net v0.30.0/go.mod h1:2wGyMJ5iFasEhkwi13ChkO/t1ECNC4X4eBKkVFyYFlU=
+golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.0.0-20190911185100-cd5d95a43a6e/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.8.0 h1:3NFvSEYkUoMifnESzZl15y791HH1qU2xm6eCJU5ZPXQ=
+golang.org/x/sync v0.8.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk=
+golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
+golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20200930185726-fdedc70b468f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
+golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
+golang.org/x/text v0.19.0 h1:kTxAhCbGbxhK0IwgSKiMO5awPoDQ0RpfiVYBfK860YM=
+golang.org/x/text v0.19.0/go.mod h1:BuEKDfySbSR4drPmRPG/7iBdf8hvFMuRexcpahXilzY=
+golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
+golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
+golang.org/x/tools v0.0.0-20200619180055-7c47624df98f/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE=
+golang.org/x/tools v0.0.0-20210106214847-113979e3529a/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA=
+golang.org/x/tools v0.26.0 h1:v/60pFQmzmT9ExmjDv2gGIfi3OqfKoEP6I5+umXlbnQ=
+golang.org/x/tools v0.26.0/go.mod h1:TPVVj70c7JJ3WCazhD8OdXcZg/og+b9+tH/KxylGwH0=
+golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
+gopkg.in/inf.v0 v0.9.1 h1:73M5CoZyi3ZLMOyDlQh031Cx6N9NDJ2Vvfl76EDAgDc=
+gopkg.in/inf.v0 v0.9.1/go.mod h1:cWUDdTG/fYaXco+Dcufb5Vnc6Gp2YChqWtbxRZE0mXw=
+gopkg.in/yaml.v2 v2.2.8/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
+gopkg.in/yaml.v2 v2.4.0 h1:D8xgwECY7CYvx+Y2n4sBz93Jn9JRvxdiyyo8CTfuKaY=
+gopkg.in/yaml.v2 v2.4.0/go.mod h1:RDklbk79AGWmwhnvt/jBztapEOGDOx6ZbXqjP6csGnQ=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
+helm.sh/helm/v3 v3.14.0 h1:TaZIH6uOchn7L27ptwnnuHJiFrT/BsD4dFdp/HLT2nM=
+helm.sh/helm/v3 v3.14.0/go.mod h1:2itvvDv2WSZXTllknfQo6j7u3VVgMAvm8POCDgYH424=
+k8s.io/api v0.29.0 h1:NiCdQMY1QOp1H8lfRyeEf8eOwV6+0xA6XEE44ohDX2A=
+k8s.io/api v0.29.0/go.mod h1:sdVmXoz2Bo/cb77Pxi71IPTSErEW32xa4aXwKH7gfBA=
+k8s.io/apimachinery v0.29.0 h1:+ACVktwyicPz0oc6MTMLwa2Pw3ouLAfAon1wPLtG48o=
+k8s.io/apimachinery v0.29.0/go.mod h1:eVBxQ/cwiJxH58eK/jd/vAk4mrxmVlnpBH5J2GbMeis=
+k8s.io/klog/v2 v2.110.1 h1:U/Af64HJf7FcwMcXyKm2RPM22WZzyR7OSpYj5tg3cL0=
+k8s.io/klog/v2 v2.110.1/go.mod h1:YGtd1984u+GgbuZ7e08/yBuAfKLSO0+uR1Fhi6ExXjo=
+k8s.io/utils v0.0.0-20230726121419-3b25d923346b h1:sgn3ZU783SCgtaSJjpcVVlRqd6GSnlTLKgpAAttJvpI=
+k8s.io/utils v0.0.0-20230726121419-3b25d923346b/go.mod h1:OLgZIPagt7ERELqWJFomSt595RzquPNLL48iOWgYOg0=
+sigs.k8s.io/json v0.0.0-20221116044647-bc3834ca7abd h1:EDPBXCAspyGV4jQlpZSudPeMmr1bNJefnuqLsRAsHZo=
+sigs.k8s.io/json v0.0.0-20221116044647-bc3834ca7abd/go.mod h1:B8JuhiUyNFVKdsE8h686QcCxMaH6HrOAZj4vswFpcB0=
+sigs.k8s.io/structured-merge-diff/v4 v4.4.1 h1:150L+0vs/8DA78h1u02ooW1/fFq/Lwr+sGiqlzvrtq4=
+sigs.k8s.io/structured-merge-diff/v4 v4.4.1/go.mod h1:N8hJocpFajUSSeSJ9bOZ77VzejKZaXsTtZo4/u7Io08=
+sigs.k8s.io/yaml v1.3.0 h1:a2VclLzOGrwOHDiV8EfBGhvjHvP46CtW5j6POvhYGGo=
+sigs.k8s.io/yaml v1.3.0/go.mod h1:GeOyir5tyXNByN85N/dRIT9es5UQNerPYEKK56eTBm8=

package/tools/go-schema-gen/main.go

@@ -0,0 +1,155 @@
+package main
+
+import (
+	"encoding/json"
+	"flag"
+	"fmt"
+	"os"
+	"strings"
+
+	"github.com/invopop/jsonschema"
+)
+
+// Config holds the CLI configuration
+type Config struct {
+	TypePath        string
+	AllowAdditional bool
+	Expanded        bool
+}
+
+func main() {
+	config := parseFlags()
+
+	// Get type value from registry
+	typeValue, err := getType(config.TypePath)
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Error: %v\n", err)
+		os.Exit(1)
+	}
+
+	// Extract package path from type path
+	packagePath := extractPackagePath(config.TypePath)
+
+	// Extract comments from Go source (AST parsing)
+	comments, err := ExtractComments(packagePath)
+	if err != nil {
+		// Non-fatal: just warn and continue without comments
+		fmt.Fprintf(os.Stderr, "Warning: Could not extract comments: %v\n", err)
+		comments = make(CommentMap)
+	}
+
+	// Generate schema
+	schema, err := generateSchema(typeValue, config)
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Error generating schema: %v\n", err)
+		os.Exit(1)
+	}
+
+	// Enrich schema with comments
+	enrichSchemaWithComments(schema, comments, config.TypePath)
+
+	// Output JSON
+	output, err := json.MarshalIndent(schema, "", "  ")
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Error marshaling JSON: %v\n", err)
+		os.Exit(1)
+	}
+
+	fmt.Println(string(output))
+}
+
+// extractPackagePath extracts package path from type path
+// Example: "helm.sh/helm/v3/pkg/chart.Metadata" -> "helm.sh/helm/v3/pkg/chart"
+func extractPackagePath(typePath string) string {
+	lastDot := strings.LastIndex(typePath, ".")
+	if lastDot == -1 {
+		return typePath
+	}
+	return typePath[:lastDot]
+}
+
+// enrichSchemaWithComments adds field descriptions from Go comments to JSON Schema
+func enrichSchemaWithComments(schema *jsonschema.Schema, comments CommentMap, typePath string) {
+	if schema.Definitions == nil {
+		return
+	}
+
+	// Get package path and type name
+	packagePath := extractPackagePath(typePath)
+	lastDot := strings.LastIndex(typePath, ".")
+	if lastDot == -1 {
+		return
+	}
+	rootTypeName := typePath[lastDot+1:]
+
+	// Enrich each definition
+	for defName, defSchema := range schema.Definitions {
+		// Try to match this definition to comments
+		fullTypeName := packagePath + "." + defName
+		fieldComments, ok := comments[fullTypeName]
+		if !ok {
+			// Also try with root type name
+			fullTypeName = packagePath + "." + rootTypeName
+			fieldComments, ok = comments[fullTypeName]
+			if !ok {
+				continue
+			}
+		}
+
+		// Add descriptions to properties
+		if defSchema.Properties != nil {
+			for pair := defSchema.Properties.Oldest(); pair != nil; pair = pair.Next() {
+				fieldName := pair.Key
+				propSchema := pair.Value
+
+				// Convert JSON field name to Go field name (capitalize first letter)
+				goFieldName := strings.ToUpper(fieldName[:1]) + fieldName[1:]
+				if desc, ok := fieldComments[goFieldName]; ok && desc != "" {
+					propSchema.Description = desc
+				}
+			}
+		}
+	}
+}
+
+func parseFlags() Config {
+	var config Config
+	flag.StringVar(&config.TypePath, "type", "", "Go type path (package.Type)")
+	flag.BoolVar(&config.AllowAdditional, "allow-additional", false, "Allow additional properties")
+	flag.BoolVar(&config.Expanded, "expanded", false, "Generate expanded definitions")
+	flag.Parse()
+
+	if config.TypePath == "" {
+		fmt.Fprintf(os.Stderr, "Error: --type is required\n\n")
+		flag.Usage()
+		os.Exit(1)
+	}
+
+	return config
+}
+
+func generateSchema(typeValue interface{}, config Config) (*jsonschema.Schema, error) {
+	reflector := jsonschema.Reflector{
+		AllowAdditionalProperties: config.AllowAdditional,
+		ExpandedStruct:            config.Expanded,
+		DoNotReference:            false,
+	}
+
+	return reflector.Reflect(typeValue), nil
+}
+
+func getType(typePath string) (interface{}, error) {
+	typeValue, ok := typeRegistry[typePath]
+	if !ok {
+		return nil, fmt.Errorf("type %s not registered.\n\nAvailable types:\n%s", typePath, listAvailableTypes())
+	}
+	return typeValue, nil
+}
+
+func listAvailableTypes() string {
+	var types []string
+	for k := range typeRegistry {
+		types = append(types, "  - "+k)
+	}
+	return strings.Join(types, "\n")
+}