@voxgig/sdkgen 1.3.10 → 1.3.12

package/bin/voxgig-sdkgen

@@ -8,7 +8,7 @@ const { Shape, One } = require('shape')
 
 const { SdkGen } = require('../dist/sdkgen.js')
 
-const VERSION = '1.3.10'
+const VERSION = '1.3.12'
 const KONSOLE = console
 
 

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/sdkgen.ts","../src/types.ts","../src/utility.ts","../src/action/action.ts","../src/action/feature.ts","../src/action/target.ts","../src/cmp/agentguide.ts","../src/cmp/agentguidecontent.ts","../src/cmp/agentguidefeature.ts","../src/cmp/agentguidetop.ts","../src/cmp/changelog.ts","../src/cmp/deploy.ts","../src/cmp/entity.ts","../src/cmp/feature.ts","../src/cmp/featurehook.ts","../src/cmp/license.ts","../src/cmp/main.ts","../src/cmp/readme.ts","../src/cmp/readmeentity.ts","../src/cmp/readmeerrors.ts","../src/cmp/readmeexplanation.ts","../src/cmp/readmehowto.ts","../src/cmp/readmeinstall.ts","../src/cmp/readmeintro.ts","../src/cmp/readmemodel.ts","../src/cmp/readmeoptions.ts","../src/cmp/readmequick.ts","../src/cmp/readmeref.ts","../src/cmp/readmetop.ts","../src/cmp/security.ts","../src/cmp/test.ts","../src/helpers/buildidnames.ts","../src/helpers/canontype.ts","../src/helpers/collectdeps.ts","../src/helpers/getmatchentries.ts","../src/helpers/naming.ts","../src/helpers/opexample.ts","../src/helpers/opshape.ts","../src/helpers/packagemeta.ts"],"version":"6.0.3"}
+{"root":["../src/sdkgen.ts","../src/types.ts","../src/utility.ts","../src/action/action.ts","../src/action/feature.ts","../src/action/target.ts","../src/cmp/AgentGuide.ts","../src/cmp/AgentGuideContent.ts","../src/cmp/AgentGuideFeature.ts","../src/cmp/AgentGuideTop.ts","../src/cmp/Changelog.ts","../src/cmp/Deploy.ts","../src/cmp/Entity.ts","../src/cmp/Feature.ts","../src/cmp/FeatureHook.ts","../src/cmp/License.ts","../src/cmp/Main.ts","../src/cmp/Readme.ts","../src/cmp/ReadmeEntity.ts","../src/cmp/ReadmeErrors.ts","../src/cmp/ReadmeExplanation.ts","../src/cmp/ReadmeHowto.ts","../src/cmp/ReadmeInstall.ts","../src/cmp/ReadmeIntro.ts","../src/cmp/ReadmeModel.ts","../src/cmp/ReadmeOptions.ts","../src/cmp/ReadmeQuick.ts","../src/cmp/ReadmeRef.ts","../src/cmp/ReadmeTop.ts","../src/cmp/Security.ts","../src/cmp/Test.ts","../src/helpers/buildIdNames.ts","../src/helpers/canonType.ts","../src/helpers/collectDeps.ts","../src/helpers/getMatchEntries.ts","../src/helpers/naming.ts","../src/helpers/opExample.ts","../src/helpers/opShape.ts","../src/helpers/packageMeta.ts"],"version":"6.0.3"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voxgig/sdkgen",
-  "version": "1.3.10",
+  "version": "1.3.12",
   "main": "dist/sdkgen.js",
   "type": "commonjs",
   "types": "dist/sdkgen.d.ts",

package/project/.sdk/src/cmp/dart/EntityTypes_dart.ts

@@ -19,7 +19,7 @@
 // <Name>RemoveMatch.
 
 import {
-  cmp, each,
+  cmp, each, names,
   File, Content,
 } from '@voxgig/sdkgen'
 
@@ -139,6 +139,10 @@ const EntityTypes = cmp(function EntityTypes(props: any) {
 
   const entity = getModelPath(model, `main.${KIT}.entity`)
   const entityList = each(entity).filter((e: any) => e.active !== false)
+  // Derive the PascalCase Name up-front — it is set LAZILY by names(), so an
+  // entity not yet named (e.g. a fieldless placeholder) would otherwise read
+  // `Name = undefined` below. Parity with the go emitter's fix.
+  entityList.forEach((e: any) => { if (null == e.Name) names(e, e.name) })
 
   File({ name: model.const.Name + 'Types.' + target.ext }, () => {
 

package/project/.sdk/src/cmp/go/EntityTypes_go.ts

@@ -27,7 +27,7 @@
 //     with every field optional (Go's analog of TS `Partial<Name>`).
 
 import {
-  cmp, each,
+  cmp, each, names,
   File, Content, Folder,
 } from '@voxgig/sdkgen'
 
@@ -77,10 +77,17 @@ const EntityTypes = cmp(function EntityTypes(props: any) {
   const { model } = props.ctx$
 
   const entity = getModelPath(model, `main.${KIT}.entity`)
-  // Emit for every entity that gets an entity file. Main_go.ts iterates
-  // entities WITHOUT an `active` filter, so a struct is required for each so
-  // the typed accessors in every *_entity.go resolve at compile time.
-  const entityList = each(entity).filter((e: any) => e && null != e.Name)
+  // Emit for every entity that gets an entity file. Main_go.ts / Entity_go.ts
+  // iterate entities WITHOUT an `active` filter and reference the typed data
+  // type `<Name>` in every *_entity.go, so a struct is required for each or the
+  // package won't compile. Filter on `name` (always present), NOT `Name`:
+  // `Name` is the PascalCase variant derived LAZILY by `names()`, so filtering
+  // on it silently drops any entity whose `Name` hasn't been derived yet by an
+  // earlier component (order-dependent — e.g. fieldless placeholder entities),
+  // producing `undefined: <Name>` in the generated Go. Derive `Name` here so
+  // the struct set is deterministic and matches the *_entity.go set.
+  const entityList = each(entity).filter((e: any) => e && null != e.name)
+  entityList.forEach((e: any) => { if (null == e.Name) names(e, e.name) })
 
   Folder({ name: 'entity' }, () => {
 

package/project/.sdk/src/cmp/go-cli/Main_go-cli.ts

@@ -44,8 +44,10 @@ const Main = cmp(function Main(props: any) {
 
   const FRAGMENT = Path.normalize(__dirname + '/../../../src/cmp/go-cli/fragment')
 
-  // .gitignore — the compiled binary lands at /<modulename>-cli; ignore it.
-  File({ name: '.gitignore' }, () => Content(`/${model.name}-cli
+  // .gitignore — build output (dist/) and any stray top-level binaries.
+  File({ name: '.gitignore' }, () => Content(`/dist/
+/${model.name}-cli
+/go-cli
 `))
 
   // README.md — usage guide for the AQL-driven CLI.
@@ -163,6 +165,37 @@ replace ${sdkModule} => ../go
   // AQL_ENG_VERSION above.
   File({ name: 'go.sum' }, () => Content(AQL_ENG_GOSUM))
 
+  // Makefile — `make build` for the current machine, `make build-all` to
+  // cross-compile for the three desktop OSes (linux, darwin, windows) on
+  // amd64 + arm64. Every binary is named ${model.name}-cli (+ .exe on windows)
+  // inside its own dist/<os>-<arch>/ folder — no loose top-level binary.
+  File({ name: 'Makefile' }, () => Content(`# ${model.name}-cli build. GENERATED by @voxgig/sdkgen go-cli target.
+BINARY := ${model.name}-cli
+DIST := dist
+GOOS := $(shell go env GOOS)
+GOARCH := $(shell go env GOARCH)
+EXT := $(if $(filter windows,$(GOOS)),.exe,)
+
+.PHONY: build build-all clean
+
+# Native build for the current machine -> dist/<os>-<arch>/${model.name}-cli.
+build:
+\tgo build -o $(DIST)/$(GOOS)-$(GOARCH)/$(BINARY)$(EXT) .
+
+# Cross-compiled release binaries: three desktop OSes x amd64/arm64, each named
+# ${model.name}-cli (+ .exe on windows) inside its own dist/<os>-<arch>/ folder.
+build-all: clean
+\tGOOS=linux   GOARCH=amd64 go build -o $(DIST)/linux-amd64/$(BINARY) .
+\tGOOS=linux   GOARCH=arm64 go build -o $(DIST)/linux-arm64/$(BINARY) .
+\tGOOS=darwin  GOARCH=amd64 go build -o $(DIST)/darwin-amd64/$(BINARY) .
+\tGOOS=darwin  GOARCH=arm64 go build -o $(DIST)/darwin-arm64/$(BINARY) .
+\tGOOS=windows GOARCH=amd64 go build -o $(DIST)/windows-amd64/$(BINARY).exe .
+\tGOOS=windows GOARCH=arm64 go build -o $(DIST)/windows-arm64/$(BINARY).exe .
+
+clean:
+\trm -rf $(DIST) $(BINARY) go-cli
+`))
+
   // main.go — produced from fragment/main.fragment.go with two Slots
   // for the prompt label and the entity help line.
   File({ name: 'main.go' }, () => {
@@ -172,6 +205,10 @@ replace ${sdkModule} => ../go
         replace: {
           ...props.ctx$.stdrep,
           GOMODULE: sdkModule,
+          // Env vars the CLI reads: <PROJ>_APIKEY for the key and <PROJ>_BASE
+          // to override the API base URL (both injectable by a secrets vault).
+          APIKEYENVVAR: String(model.name).toUpperCase().replace(/[^A-Z0-9]/g, '_') + '_APIKEY',
+          BASEENVVAR: String(model.name).toUpperCase().replace(/[^A-Z0-9]/g, '_') + '_BASE',
         },
       },
       () => {

package/project/.sdk/src/cmp/go-cli/fragment/main.fragment.go

@@ -27,7 +27,20 @@ func main() {
 }
 
 func run(args []string, in io.Reader, out, errOut io.Writer) int {
-	client := sdk.NewProjectNameSDK(nil)
+	// Configure from the environment: APIKEYENVVAR carries the API key and
+	// BASEENVVAR optionally overrides the API base URL (e.g. production).
+	// Both injectable by a secrets vault. Unset -> nil config defaults.
+	var opts map[string]any
+	if apikey := os.Getenv("APIKEYENVVAR"); apikey != "" {
+		opts = map[string]any{"apikey": apikey}
+	}
+	if base := os.Getenv("BASEENVVAR"); base != "" {
+		if opts == nil {
+			opts = map[string]any{}
+		}
+		opts["base"] = base
+	}
+	client := sdk.NewProjectNameSDK(opts)
 
 	r, err := eng.NewRegistry()
 	if err != nil {

package/project/.sdk/src/cmp/go-mcp/Main_go-mcp.ts

@@ -64,8 +64,10 @@ const Main = cmp(function Main(props: any) {
 
   const FRAGMENT = Path.normalize(__dirname + '/../../../src/cmp/go-mcp/fragment')
 
-  // .gitignore — the compiled binary lands at /<modulename>-mcp; ignore it.
-  File({ name: '.gitignore' }, () => Content(`/${model.name}-mcp
+  // .gitignore — build output (dist/) and any stray top-level binaries.
+  File({ name: '.gitignore' }, () => Content(`/dist/
+/${model.name}-mcp
+/go-mcp
 `))
 
   // README.md — usage guide for the MCP server.
@@ -170,6 +172,37 @@ replace ${sdkModule} => ../go
   // MCP_GO_SDK_VERSION above.
   File({ name: 'go.sum' }, () => Content(MCP_GO_SDK_GOSUM))
 
+  // Makefile — `make build` for the current machine, `make build-all` to
+  // cross-compile for the three desktop OSes (linux, darwin, windows) on
+  // amd64 + arm64. Every binary is named ${model.name}-mcp (+ .exe on windows)
+  // inside its own dist/<os>-<arch>/ folder — no loose top-level binary.
+  File({ name: 'Makefile' }, () => Content(`# ${model.name}-mcp build. GENERATED by @voxgig/sdkgen go-mcp target.
+BINARY := ${model.name}-mcp
+DIST := dist
+GOOS := $(shell go env GOOS)
+GOARCH := $(shell go env GOARCH)
+EXT := $(if $(filter windows,$(GOOS)),.exe,)
+
+.PHONY: build build-all clean
+
+# Native build for the current machine -> dist/<os>-<arch>/${model.name}-mcp.
+build:
+\tgo build -o $(DIST)/$(GOOS)-$(GOARCH)/$(BINARY)$(EXT) .
+
+# Cross-compiled release binaries: three desktop OSes x amd64/arm64, each named
+# ${model.name}-mcp (+ .exe on windows) inside its own dist/<os>-<arch>/ folder.
+build-all: clean
+\tGOOS=linux   GOARCH=amd64 go build -o $(DIST)/linux-amd64/$(BINARY) .
+\tGOOS=linux   GOARCH=arm64 go build -o $(DIST)/linux-arm64/$(BINARY) .
+\tGOOS=darwin  GOARCH=amd64 go build -o $(DIST)/darwin-amd64/$(BINARY) .
+\tGOOS=darwin  GOARCH=arm64 go build -o $(DIST)/darwin-arm64/$(BINARY) .
+\tGOOS=windows GOARCH=amd64 go build -o $(DIST)/windows-amd64/$(BINARY).exe .
+\tGOOS=windows GOARCH=arm64 go build -o $(DIST)/windows-arm64/$(BINARY).exe .
+
+clean:
+\trm -rf $(DIST) $(BINARY) go-mcp
+`))
+
   // main.go — produced from fragment/main.fragment.go with one Slot
   // for the MCP server's announced name.
   File({ name: 'main.go' }, () => {
@@ -179,6 +212,10 @@ replace ${sdkModule} => ../go
         replace: {
           ...props.ctx$.stdrep,
           GOMODULE: sdkModule,
+          // Env vars the server reads: <PROJ>_APIKEY for the key and <PROJ>_BASE
+          // to override the API base URL (both injectable by a secrets vault).
+          APIKEYENVVAR: String(model.name).toUpperCase().replace(/[^A-Z0-9]/g, '_') + '_APIKEY',
+          BASEENVVAR: String(model.name).toUpperCase().replace(/[^A-Z0-9]/g, '_') + '_BASE',
         },
       },
       () => {

package/project/.sdk/src/cmp/go-mcp/fragment/main.fragment.go

@@ -37,7 +37,20 @@ func main() {
 	addr := flag.String("addr", ":8080", "listen address for http transport")
 	flag.Parse()
 
-	client := sdk.NewProjectNameSDK(nil)
+	// Configure from the environment: APIKEYENVVAR carries the API key and
+	// BASEENVVAR optionally overrides the API base URL (e.g. production).
+	// Both injectable by a secrets vault. Unset -> nil config defaults.
+	var opts map[string]any
+	if apikey := os.Getenv("APIKEYENVVAR"); apikey != "" {
+		opts = map[string]any{"apikey": apikey}
+	}
+	if base := os.Getenv("BASEENVVAR"); base != "" {
+		if opts == nil {
+			opts = map[string]any{}
+		}
+		opts["base"] = base
+	}
+	client := sdk.NewProjectNameSDK(opts)
 	server := mcp.NewServer(
 		&mcp.Implementation{
 			Name:    "// <[SLOT:serverName]>",

package/project/.sdk/src/cmp/js/EntityTypes_js.ts

@@ -19,7 +19,7 @@
 // <Name>ListMatch, <Name>CreateData, <Name>UpdateData, <Name>RemoveMatch).
 
 import {
-  cmp, each,
+  cmp, each, names,
   File, Content,
 } from '@voxgig/sdkgen'
 
@@ -46,6 +46,10 @@ const EntityTypes = cmp(function EntityTypes(props: any) {
 
   const entity = getModelPath(model, `main.${KIT}.entity`)
   const entityList = each(entity).filter((e: any) => e.active !== false)
+  // Derive the PascalCase Name up-front — it is set LAZILY by names(), so an
+  // entity not yet named (e.g. a fieldless placeholder) would otherwise read
+  // `Name = undefined` below. Parity with the go emitter's fix.
+  entityList.forEach((e: any) => { if (null == e.Name) names(e, e.name) })
 
   File({ name: model.const.Name + 'Types.' + LANG }, () => {
 

package/project/.sdk/src/cmp/lua/EntityTypes_lua.ts

@@ -17,7 +17,7 @@
 // ---@param / ---@return.
 
 import {
-  cmp, each,
+  cmp, each, names,
   File, Content,
 } from '@voxgig/sdkgen'
 
@@ -45,6 +45,10 @@ const EntityTypes = cmp(function EntityTypes(props: any) {
 
   const entity = getModelPath(model, `main.${KIT}.entity`)
   const entityList = each(entity).filter((e: any) => e.active !== false)
+  // Derive the PascalCase Name up-front — it is set LAZILY by names(), so an
+  // entity not yet named (e.g. a fieldless placeholder) would otherwise read
+  // `Name = undefined` below. Parity with the go emitter's fix.
+  entityList.forEach((e: any) => { if (null == e.Name) names(e, e.name) })
 
   File({ name: model.name + '_types.' + (target.ext || LANG) }, () => {
 

package/project/.sdk/src/cmp/php/EntityTypes_php.ts

@@ -25,7 +25,7 @@
 // Package_php.ts) so `new <Name>()` / type references resolve globally.
 
 import {
-  cmp, each,
+  cmp, each, names,
   File, Content, Folder,
 } from '@voxgig/sdkgen'
 
@@ -68,6 +68,10 @@ const EntityTypes = cmp(function EntityTypes(props: any) {
 
   const entity = getModelPath(model, `main.${KIT}.entity`)
   const entityList = each(entity).filter((e: any) => e.active !== false)
+  // Derive the PascalCase Name up-front — it is set LAZILY by names(), so an
+  // entity not yet named (e.g. a fieldless placeholder) would otherwise read
+  // `Name = undefined` below. Parity with the go emitter's fix.
+  entityList.forEach((e: any) => { if (null == e.Name) names(e, e.name) })
 
   Folder({ name: 'types' }, () => {
 

package/project/.sdk/src/cmp/py/EntityTypes_py.ts

@@ -32,7 +32,7 @@
 // <Name>RemoveMatch.
 
 import {
-  cmp, each,
+  cmp, each, names,
   File, Content,
 } from '@voxgig/sdkgen'
 
@@ -123,6 +123,10 @@ const EntityTypes = cmp(function EntityTypes(props: any) {
 
   const entity = getModelPath(model, `main.${KIT}.entity`)
   const entityList = each(entity).filter((e: any) => e.active !== false)
+  // Derive the PascalCase Name up-front — it is set LAZILY by names(), so an
+  // entity not yet named (e.g. a fieldless placeholder) would otherwise read
+  // `Name = undefined` below. Parity with the go emitter's fix.
+  entityList.forEach((e: any) => { if (null == e.Name) names(e, e.name) })
 
   File({ name: model.const.Name.toLowerCase() + '_types.' + ext }, () => {
 

package/project/.sdk/src/cmp/rb/EntityTypes_rb.ts

@@ -23,7 +23,7 @@
 // The file is required by the main SDK module so these constants are always loaded.
 
 import {
-  cmp, each,
+  cmp, each, names,
   File, Content,
 } from '@voxgig/sdkgen'
 
@@ -81,6 +81,10 @@ const EntityTypes = cmp(function EntityTypes(props: any) {
 
   const entity = getModelPath(model, `main.${KIT}.entity`)
   const entityList = each(entity).filter((e: any) => e.active !== false)
+  // Derive the PascalCase Name up-front — it is set LAZILY by names(), so an
+  // entity not yet named (e.g. a fieldless placeholder) would otherwise read
+  // `Name = undefined` below. Parity with the go emitter's fix.
+  entityList.forEach((e: any) => { if (null == e.Name) names(e, e.name) })
 
   File({ name: model.const.Name + '_types.' + LANG }, () => {
 

package/project/.sdk/src/cmp/ts/EntityTypes_ts.ts

@@ -17,7 +17,7 @@
 // <X> op fragments + entity accessor.
 
 import {
-  cmp, each,
+  cmp, each, names,
   File, Content,
 } from '@voxgig/sdkgen'
 
@@ -43,6 +43,10 @@ const EntityTypes = cmp(function EntityTypes(props: any) {
 
   const entity = getModelPath(model, `main.${KIT}.entity`)
   const entityList = each(entity).filter((e: any) => e.active !== false)
+  // Derive the PascalCase Name up-front — it is set LAZILY by names(), so an
+  // entity not yet named (e.g. a fieldless placeholder) would otherwise read
+  // `Name = undefined` below. Parity with the go emitter's fix.
+  entityList.forEach((e: any) => { if (null == e.Name) names(e, e.name) })
 
   File({ name: model.const.Name + 'Types.' + LANG }, () => {