@voxgig/sdkgen 4.27.0 → 4.29.0

package/project/.sdk/model/feature/clienttrack.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: clienttrack: {
 
   name: key()
-  title: "Client identity and per-request correlation headers"
+  title: "Client tracking"
+  description: "Client identity and per-request correlation headers"
   version: '0.0.1'
   active: true
   base: 'BASE'

package/project/.sdk/model/feature/cost.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: cost: {
 
   name: key()
-  title: "Cost tracking and spend budget for API calls"
+  title: "Cost tracking"
+  description: "Cost tracking and spend budget for API calls"
   version: '0.0.1'
   active: true
   base: 'BASE'

package/project/.sdk/model/feature/debug.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: debug: {
 
   name: key()
-  title: "Request/response capture ring buffer for debugging"
+  title: "Debug capture"
+  description: "Request/response capture ring buffer for debugging"
   version: '0.0.1'
   active: true
   base: 'BASE'

package/project/.sdk/model/feature/idempotency.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: idempotency: {
 
   name: key()
-  title: "Idempotency keys for safe retries of mutating operations"
+  title: "Idempotency"
+  description: "Idempotency keys for safe retries of mutating operations"
   version: '0.0.1'
   active: true
   base: 'BASE'

package/project/.sdk/model/feature/log.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: log: {
 
   name: key()
-  title: "Structured request and response logging"
+  title: "Logging"
+  description: "Structured request and response logging"
   version: '0.0.1'
   active: true
   base: 'BASE'

package/project/.sdk/model/feature/metrics.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: metrics: {
 
   name: key()
-  title: "Statistics capture: per-operation counters and latency"
+  title: "Metrics"
+  description: "Statistics capture: per-operation counters and latency"
   version: '0.0.1'
   active: true
   base: 'BASE'

package/project/.sdk/model/feature/netsim.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: netsim: {
 
   name: key()
-  title: "Network behaviour simulation for offline testing (latency, failures, outages)"
+  title: "Network simulation"
+  description: "Network behaviour simulation for offline testing (latency, failures, outages)"
   version: '0.0.1'
   active: true
   base: 'BASE'

package/project/.sdk/model/feature/paging.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: paging: {
 
   name: key()
-  title: "Pagination signals for list operations"
+  title: "Paging"
+  description: "Pagination signals for list operations"
   version: '0.0.1'
   active: true
   base: 'BASE'

package/project/.sdk/model/feature/proxy.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: proxy: {
 
   name: key()
-  title: "Outbound HTTP(S) proxy routing"
+  title: "Proxy"
+  description: "Outbound HTTP(S) proxy routing"
   version: '0.0.1'
   active: true
   base: 'BASE'

package/project/.sdk/model/feature/ratelimit.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: ratelimit: {
 
   name: key()
-  title: "Client-side rate limiting via a token bucket"
+  title: "Rate limiting"
+  description: "Client-side rate limiting via a token bucket"
   version: '0.0.1'
   active: true
   base: 'BASE'

package/project/.sdk/model/feature/rbac.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: rbac: {
 
   name: key()
-  title: "Client-side role/permission enforcement"
+  title: "Access control"
+  description: "Client-side role/permission enforcement"
   version: '0.0.1'
   active: true
   base: 'BASE'

package/project/.sdk/model/feature/retry.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: retry: {
 
   name: key()
-  title: "Automatic retry of transient failures with exponential backoff"
+  title: "Retry"
+  description: "Automatic retry of transient failures with exponential backoff"
   version: '0.0.1'
   active: true
   base: 'BASE'

package/project/.sdk/model/feature/secrets.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: secrets: {
 
   name: key()
-  title: "Secret access: resolve the API credential through a provider chain, and exchange a refresh token for short-lived access tokens"
+  title: "Secrets"
+  description: "Secret access: resolve the API credential through a provider chain, and exchange a refresh token for short-lived access tokens"
   version: '0.1.0'
   base: 'BASE'
 

package/project/.sdk/model/feature/streaming.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: streaming: {
 
   name: key()
-  title: "Incremental streaming of list results via async iteration"
+  title: "Streaming"
+  description: "Incremental streaming of list results via async iteration"
   version: '0.0.1'
   active: true
   base: 'BASE'

package/project/.sdk/model/feature/telemetry.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: telemetry: {
 
   name: key()
-  title: "Distributed tracing spans with W3C trace-context propagation"
+  title: "Telemetry"
+  description: "Distributed tracing spans with W3C trace-context propagation"
   version: '0.0.1'
   active: true
   base: 'BASE'

package/project/.sdk/model/feature/test.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: test: {
 
   name: key()
-  title: "In-memory mock transport for testing without a live server"
+  title: "Test transport"
+  description: "In-memory mock transport for testing without a live server"
   version: '0.0.1'
   active: true
   base: 'BASE'

package/project/.sdk/model/feature/timeout.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: timeout: {
 
   name: key()
-  title: "Per-request timeout with transport abort"
+  title: "Timeout"
+  description: "Per-request timeout with transport abort"
   version: '0.0.1'
   active: true
   base: 'BASE'

package/project/.sdk/model/feature/validate.aontu

@@ -2,7 +2,8 @@
 main: kit: feature: validate: {
 
   name: key()
-  title: "Payload validation against the model's own field types"
+  title: "Validation"
+  description: "Payload validation against the model's own field types"
   version: '0.0.1'
   active: true
   base: 'BASE'

package/project/.sdk/src/cmp/c/utility_c.ts

@@ -4,6 +4,8 @@ import {
   walk,
 } from '@voxgig/struct'
 
+import { sdkName } from '@voxgig/sdkgen'
+
 
 // C reserved keywords illegal as identifiers.
 const C_RESERVED = new Set<string>([
@@ -31,7 +33,7 @@ function cIdent(model: any): string {
 // Package-ish name (used in comments only), e.g. voxgig-solar-sdk.
 function cName(model: any): string {
   const org = (model.origin || 'voxgig-sdk').replace(/-sdk$/, '')
-  return `${org}-${model.name}-sdk`.toLowerCase().replace(/[^a-z0-9-]/g, '-')
+  return `${org}-${sdkName(model.name)}`.toLowerCase().replace(/[^a-z0-9-]/g, '-')
 }
 
 

package/project/.sdk/src/cmp/cpp/ReadmeInstall_cpp.ts

@@ -1,5 +1,5 @@
 
-import { cmp, Content, repoInfo } from '@voxgig/sdkgen'
+import { cmp, Content, repoInfo, sdkName } from '@voxgig/sdkgen'
 
 
 const ReadmeInstall = cmp(function ReadmeInstall(props: any) {
@@ -20,7 +20,7 @@ Releases are cut as the git tag \`${target.name}/vX.Y.Z\` (see
 
 \`\`\`bash
 # Add the SDK as a submodule (or copy the cpp/ directory into your tree).
-git submodule add <repo-url> third_party/${model.const.Name.toLowerCase()}-sdk
+git submodule add <repo-url> third_party/${sdkName(model.const.Name.toLowerCase())}
 \`\`\`
 
 Then include the umbrella header and compile with C++17:
@@ -30,7 +30,7 @@ Then include the umbrella header and compile with C++17:
 \`\`\`
 
 \`\`\`bash
-g++ -std=c++17 -Ithird_party/${model.const.Name.toLowerCase()}-sdk/cpp your_app.cpp -o your_app
+g++ -std=c++17 -Ithird_party/${sdkName(model.const.Name.toLowerCase())}/cpp your_app.cpp -o your_app
 \`\`\`
 
 `)

package/project/.sdk/src/cmp/elixir/ReadmeInstall_elixir.ts

@@ -1,5 +1,5 @@
 
-import { cmp, Content, isPublished, repoInfo, packageVersion } from '@voxgig/sdkgen'
+import { cmp, Content, isPublished, repoInfo, packageVersion, sdkName } from '@voxgig/sdkgen'
 
 
 const ReadmeInstall = cmp(function ReadmeInstall(props: any) {
@@ -51,7 +51,7 @@ Or from a local source checkout:
 \`\`\`elixir
 def deps do
   [
-    {:${app}, path: "../${model.const.name.toLowerCase()}-sdk/${target.name}"}
+    {:${app}, path: "../${sdkName(model.const.name.toLowerCase())}/${target.name}"}
   ]
 end
 \`\`\`

package/project/.sdk/src/cmp/java/Package_java.ts

@@ -5,6 +5,7 @@ import {
   cmp,
   collectDeps,
   packageVersion,
+  sdkName,
 } from '@voxgig/sdkgen'
 
 
@@ -28,7 +29,7 @@ const Package = cmp(async function Package(props: any) {
   const model: Model = ctx$.model
 
   const groupId = mavenGroupId(model)
-  const artifactId = `${model.name}-sdk`
+  const artifactId = sdkName(model.name)
 
   // Dep name convention: "groupId:artifactId" with an explicit version.
   const deps: { groupId: string, artifactId: string, version: string, kind: string }[] = []

package/project/.sdk/src/cmp/java/ReadmeInstall_java.ts

@@ -1,5 +1,5 @@
 
-import { cmp, Content, isPublished, repoInfo, packageVersion } from '@voxgig/sdkgen'
+import { cmp, Content, isPublished, repoInfo, packageVersion, sdkName } from '@voxgig/sdkgen'
 
 import { mavenGroupId } from './utility_java'
 
@@ -9,7 +9,7 @@ const ReadmeInstall = cmp(function ReadmeInstall(props: any) {
   const { model } = ctx$
 
   const groupId = mavenGroupId(model)
-  const artifactId = `${model.name}-sdk`
+  const artifactId = sdkName(model.name)
 
   if (isPublished(model, target.name)) {
     Content(`Add the dependency to your \`pom.xml\`:

package/project/.sdk/src/cmp/kotlin/Package_kotlin.ts

@@ -5,6 +5,7 @@ import {
   cmp,
   collectDeps,
   packageVersion,
+  sdkName,
 } from '@voxgig/sdkgen'
 
 
@@ -27,7 +28,7 @@ const Package = cmp(async function Package(props: any) {
   const model: Model = ctx$.model
 
   const group = gradleGroup(model)
-  const artifactId = `${model.name}-sdk`
+  const artifactId = sdkName(model.name)
 
   // Dep name convention: "group:artifact" with an explicit version.
   const deps: { group: string, artifact: string, version: string, kind: string }[] = []

package/project/.sdk/src/cmp/kotlin/ReadmeInstall_kotlin.ts

@@ -1,5 +1,5 @@
 
-import { cmp, Content, isPublished, repoInfo, packageVersion } from '@voxgig/sdkgen'
+import { cmp, Content, isPublished, repoInfo, packageVersion, sdkName } from '@voxgig/sdkgen'
 
 import { gradleGroup } from './utility_kotlin'
 
@@ -9,7 +9,7 @@ const ReadmeInstall = cmp(function ReadmeInstall(props: any) {
   const { model } = ctx$
 
   const group = gradleGroup(model)
-  const artifactId = `${model.name}-sdk`
+  const artifactId = sdkName(model.name)
 
   if (isPublished(model, target.name)) {
     Content(`Add the dependency to your \`build.gradle.kts\`:

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

@@ -66,10 +66,8 @@ const Package = cmp(async function Package(props: any) {
   // Rock name is namespaced to model.origin (e.g. "voxgig-sdk"). LuaRocks has
   // no real namespaces, so the parts are hyphen-joined. The Lua module name
   // (`${model.name}_sdk`) used by `require` is unchanged.
-  const ns = model.origin || 'voxgig-sdk'
-  const pkgBase = ns.endsWith('-sdk') ? model.name : `${model.name}-sdk`
   const rockName = packageName(model, target.name)
-  const { repoUrl, issuesUrl } = repoInfo(model)
+  const { repo, repoUrl, issuesUrl } = repoInfo(model)
   const labels = keywords(model).map((k) => `"${k}"`).join(', ')
 
   // Single source for the version so the rockspec version and the source.tag
@@ -82,9 +80,9 @@ version = "${rockVersion}-1"
 source = {
   -- git+https (GitHub dropped git:// in 2022); pin the install to the release
   -- tag pushed by \`make publish\`, and point at the lua/ subdir of the monorepo.
-  url = "git+https://github.com/${ns}/${model.name}-sdk.git",
+  url = "git+${repoUrl}.git",
   tag = "lua/v${rockVersion}",
-  dir = "${model.name}-sdk/lua"
+  dir = "${repo}/lua"
 }
 description = {
   summary = "${pkgDescription(model, target.name)}",

package/project/.sdk/src/cmp/ocaml/utility_ocaml.ts

@@ -4,6 +4,8 @@ import {
   walk,
 } from '@voxgig/struct'
 
+import { sdkName } from '@voxgig/sdkgen'
+
 
 // OCaml keywords that are illegal as a lowercase identifier. sdkgen's shared
 // safeVarName has no ocaml entry, so the guard lives here.
@@ -36,7 +38,7 @@ function entityModule(name: string): string {
 // module naming: org prefix from model.origin).
 function packageName(model: any): string {
   const org = (model.origin || 'voxgig-sdk').replace(/-sdk$/, '')
-  return `${org}-${model.name}-sdk`.toLowerCase().replace(/[^a-z0-9-]/g, '-')
+  return `${org}-${sdkName(model.name)}`.toLowerCase().replace(/[^a-z0-9-]/g, '-')
 }
 
 

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

@@ -31,8 +31,6 @@ const Package = cmp(async function Package(props: any) {
   // Package namespace mirrors the npm scope (model.origin, e.g. "voxgig-sdk").
   // If origin already ends in "-sdk" the slug stands alone; otherwise append
   // "-sdk" (matches the TS Package generator).
-  const ns = model.origin || 'voxgig-sdk'
-  const pkgBase = ns.endsWith('-sdk') ? model.name : `${model.name}-sdk`
   const { repoUrl, issuesUrl } = repoInfo(model)
   const kw = keywords(model).map((k) => `"${k}"`).join(', ')
 

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

@@ -22,8 +22,6 @@ const Package = cmp(async function Package(props: any) {
 
   const model: Model = ctx$.model
 
-  const ns = model.origin || 'voxgig-sdk'
-  const pkgBase = ns.endsWith('-sdk') ? model.name : `${model.name}-sdk`
   const distName = packageName(model, target.name)
   const { repoUrl, issuesUrl } = repoInfo(model)
   const kw = keywords(model).map((k) => `"${k}"`).join(', ')

package/project/.sdk/src/cmp/py-data/Main_py-data.ts

@@ -99,9 +99,7 @@ const Package = cmp(function Package(props: any) {
   const { target, model, lower, dataModule } = props
   const ctx$ = props.ctx$
 
-  const ns = model.origin || 'voxgig-sdk'
-  const pkgBase = ns.endsWith('-sdk') ? model.name : `${model.name}-sdk`
-  const distName = `${ns}-${pkgBase}-data`
+  const distName = packageName(model, target.name)
   // The `py` SDK this package WRAPS — a different target, so it keeps its
   // own name and does not follow this target's alias.
   const sdkDist = packageName(model, 'py')

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

@@ -28,8 +28,6 @@ const Package = cmp(async function Package(props: any) {
   // constant here did.
   const author = authorInfo(model, target.name)
 
-  const ns = model.origin || 'voxgig-sdk'
-  const pkgBase = ns.endsWith('-sdk') ? model.name : `${model.name}-sdk`
   const gemName = packageName(model, target.name)
   const { repoUrl, issuesUrl, changelogUrl } = repoInfo(model)
 

package/project/.sdk/src/cmp/rust/utility_rust.ts

@@ -4,6 +4,8 @@ import {
   walk,
 } from '@voxgig/struct'
 
+import { sdkName } from '@voxgig/sdkgen'
+
 
 // Rust keywords (strict + reserved) that are illegal as an identifier.
 // sdkgen's shared safeVarName has no rust entry, so the guard lives here.
@@ -44,7 +46,7 @@ function rustVarName(name: string): string {
 
 function crateName(model: any): string {
   const org = (model.origin || 'voxgig-sdk').replace(/-sdk$/, '')
-  return `${org}-${model.name}-sdk`.toLowerCase().replace(/[^a-z0-9-]/g, '-')
+  return `${org}-${sdkName(model.name)}`.toLowerCase().replace(/[^a-z0-9-]/g, '-')
 }
 
 

package/project/.sdk/src/cmp/scala/ReadmeInstall_scala.ts

@@ -1,5 +1,5 @@
 
-import { cmp, Content, isPublished, repoInfo, packageVersion } from '@voxgig/sdkgen'
+import { cmp, Content, isPublished, repoInfo, packageVersion, sdkName } from '@voxgig/sdkgen'
 
 import { mavenGroupId } from './utility_scala'
 
@@ -9,7 +9,7 @@ const ReadmeInstall = cmp(function ReadmeInstall(props: any) {
   const { model } = ctx$
 
   const groupId = mavenGroupId(model)
-  const artifactId = `${model.name}-sdk`
+  const artifactId = sdkName(model.name)
 
   if (isPublished(model, target.name)) {
     Content(`Add the dependency with scala-cli:

package/project/sdkgen-package.json

@@ -3,7 +3,7 @@
     "package": 1
   },
   "name": "@voxgig/sdkgen",
-  "version": "4.27.0",
+  "version": "4.29.0",
   "provides": {
     "target": [
       "c",

package/src/helpers/packageMeta.ts

@@ -33,6 +33,11 @@ function originName(model: any, target: string): string {
   return (null != orig && '' !== orig) ? String(orig) : target
 }
 
+function sdkName(slug: string): string {
+  return slug.endsWith('-sdk') ? slug : `${slug}-sdk`
+}
+
+
 function repoInfo(model: any) {
   const slug = model.name
   const origin = model.origin || 'voxgig-sdk'
@@ -40,7 +45,7 @@ function repoInfo(model: any) {
   const declared = (model && model.main && model.main[KIT] && model.main[KIT].repo) || {}
 
   const host = '' === (declared.host || '') ? 'github.com' : (declared.host || 'github.com')
-  const path = '' === (declared.path || '') ? `${origin}/${slug}-sdk` : String(declared.path)
+  const path = '' === (declared.path || '') ? `${origin}/${sdkName(slug)}` : String(declared.path)
 
   const seg = path.split('/')
   const repo = seg[seg.length - 1]
@@ -190,8 +195,8 @@ function apiName(model: any): string {
 function packageName(model: any, eco: string): string {
   const slug = model.name
   const origin = model.origin || 'voxgig-sdk'
-  const base = origin.endsWith('-sdk') ? slug : `${slug}-sdk`
-  const npmScoped = `@${origin}/${slug}${origin.endsWith('-sdk') ? '' : '-sdk'}`
+  const base = sdkName(slug)
+  const npmScoped = `@${origin}/${base}`
 
   const ECO_TARGET: Record<string, string> = {
     npm: 'ts', pypi: 'py', gem: 'rb', luarocks: 'lua', composer: 'php',
@@ -324,6 +329,7 @@ function envName(model: any): string {
 }
 
 export {
+  sdkName,
   PUBLISHER,
   PUBLISHER_URL,
   SECURITY_EMAIL,

package/src/sdkgen.ts

@@ -103,6 +103,7 @@ import {
 import type { Manifest, ManifestRead } from './helpers/manifest'
 import {
   packageName,
+  sdkName,
   installCommand,
   registryState,
   isPublished,
@@ -656,6 +657,8 @@ function externalItems(
 
         if (null != ov.path && '' !== ov.path) {
           output.path = ov.path
+          // The override relocates this run's output, root placement included.
+          delete output.root
         }
         if (null != ov.sdkrel && '' !== ov.sdkrel) {
           output.sdkrel = ov.sdkrel
@@ -718,6 +721,14 @@ function checkExternalFolders(external: ExternalPlan[], root: string, fs: any) {
       ext.target.output.path + '", which resolves to: ' + ext.folder +
       '\n  (SDK project: ' + root + ')'
 
+    if (true === ext.target.output.root) {
+      throw new SdkGenError(
+        label + ' "' + ext.name + '" declares both `output: path` and ' +
+        '`output: root: true`.\n  ' + where +
+        '\n  `path` generates it into another repository and `root` at the ' +
+        'root of this one. Keep one.')
+    }
+
     if (ext.folder === root || folderContains(root, ext.folder)) {
       throw new SdkGenError(
         'External output path is inside the SDK project.\n  ' + where +
@@ -1094,6 +1105,7 @@ export {
   prefixLeadingDigit,
 
   packageName,
+  sdkName,
   installCommand,
   registryState,
   isPublished,

package/src/testkit.ts

@@ -563,7 +563,9 @@ function layeredFs(mem: any): any {
 
 function defaultRoot(): any {
   const { cmp, each, names, Project, Folder } = require('jostraca')
-  const { Main, Entity, Feature, Test, Readme, AgentGuide } = require('./sdkgen')
+  const {
+    Main, Entity, Feature, Test, Readme, AgentGuide, SdkGenError,
+  } = require('./sdkgen')
 
   return cmp(function Root(props: any) {
     const { model, ctx$ } = props
@@ -581,41 +583,54 @@ function defaultRoot(): any {
     const feature = model.main[KIT].feature || {}
     const entity = model.main[KIT].entity || {}
 
+    const active = each(target).filter((t: any) => t && false !== t.active)
+
+    const atRoot = active.filter((t: any) => true === t.output?.root)
+    if (1 < atRoot.length) {
+      throw new SdkGenError('Only one target can be generated at the ' +
+        'project root: ' + atRoot.map((t: any) => t.name).join(', '))
+    }
+
     Project({}, () => {
-      each(target)
-        .filter((t: any) => t && false !== t.active)
-        .map((t: any) => {
-          names(t, t.name)
-
-          const phase = t.phase || {}
-          const on = (n: string) => false !== (phase[n] && phase[n].active)
-
-          Folder({ name: t.name }, () => {
-            if (on('entity')) {
-              each(entity)
-                .filter((e: any) => e && false !== e.active)
-                .map((e: any) => {
-                  names(e, e.name)
-                  Entity({ target: t, entity: e })
-                })
-            }
-
-            if (on('feature')) {
-              each(feature)
-                .filter((f: any) => f && f.active)
-                .map((f: any) => {
-                  names(f, f.name)
-                  Feature({ target: t, feature: f })
-                })
-            }
-
-            Main({ target: t })
-
-            if (on('readme')) Readme({ target: t })
-            if (on('agentguide')) AgentGuide({ target: t })
-            if (on('test')) Test({ target: t })
-          })
-        })
+      active.map((t: any) => {
+        names(t, t.name)
+
+        const phase = t.phase || {}
+        const on = (n: string) => false !== (phase[n] && phase[n].active)
+
+        const phases = () => {
+          if (on('entity')) {
+            each(entity)
+              .filter((e: any) => e && false !== e.active)
+              .map((e: any) => {
+                names(e, e.name)
+                Entity({ target: t, entity: e })
+              })
+          }
+
+          if (on('feature')) {
+            each(feature)
+              .filter((f: any) => f && f.active)
+              .map((f: any) => {
+                names(f, f.name)
+                Feature({ target: t, feature: f })
+              })
+          }
+
+          Main({ target: t })
+
+          if (on('readme')) Readme({ target: t })
+          if (on('agentguide')) AgentGuide({ target: t })
+          if (on('test')) Test({ target: t })
+        }
+
+        if (true === t.output?.root) {
+          phases()
+        }
+        else {
+          Folder({ name: t.name }, phases)
+        }
+      })
     })
   })
 }

package/src/types.ts

@@ -62,6 +62,7 @@ type ModelTarget = NameCases & {
     create?: boolean
     adopt?: boolean
     sdkrel?: string
+    root?: boolean
   }
 
   // Per-generation-phase activation. A consumer target (go-cli, go-mcp,