@voxgig/sdkgen 4.16.0 → 4.17.0

package/src/action/package.ts

@@ -1,3 +1,4 @@
+import { kindCollection } from '../helpers/kindCollection'
 // `package add` / `package list` — the whole-package verbs.
 //
 // See docs/design/sdkgen-packages.md §9.
@@ -78,7 +79,7 @@ const CMD_MAP: any = Object.assign(Object.create(null), {
 // reads them at generate time rather than at add time, installing it last
 // keeps the add log in the order a reader would expect and leaves the model
 // complete before anything reads it.
-const ADD_ORDER = ['target', 'feature', 'docs']
+const ADD_ORDER = ['target', 'feature', 'edition']
 
 
 async function action_package(
@@ -663,7 +664,7 @@ function installedFrom(pkgname: string, actx: ActionContext): Installed[] {
   const found: Installed[] = []
 
   for (const kind of Object.keys(KINDS).sort()) {
-    const items = kit[kind] ?? {}
+    const items = kindCollection({ main: { [KIT]: kit } }, kind)
 
     for (const name of Object.keys(items).sort()) {
       const item = items[name]
@@ -1078,7 +1079,7 @@ async function cmd_package_list(
   const groups: Record<string, any[]> = Object.create(null)
 
   for (const kind of Object.keys(KINDS).sort()) {
-    const items = kit[kind] ?? {}
+    const items = kindCollection({ main: { [KIT]: kit } }, kind)
 
     for (const name of Object.keys(items).sort()) {
       const item = items[name]

package/src/action/resolve.ts

@@ -1,3 +1,4 @@
+import { kindCollection } from '../helpers/kindCollection'
 // Where a `<kind> add <ref>` gets its definition from.
 //
 // One resolver for every KIND of thing an add can install — targets today,
@@ -59,6 +60,9 @@ function lastSegment(ref: string): string {
 
 
 function resolveSource(ref: string, kind: string, ctx$: any): Source {
+  // Registration and copying must resolve a bare resync name identically.
+  const declared = kindCollection(ctx$.model, kind)?.[ref]
+  ref = (isBare(ref) && recordedRef(declared, ref)) || ref
   const root = ctx$.folder
   const fs = ctx$.fs()
 
@@ -275,7 +279,7 @@ function registerInstalled(kind: string, refs: string[], ctx$: any) {
     return
   }
 
-  const items = kit[kind] = kit[kind] ?? {}
+  const items = kindCollection(ctx$.model, kind, true)
 
   for (const ref of refs) {
     let source: Source
@@ -317,7 +321,7 @@ function registerInstalled(kind: string, refs: string[], ctx$: any) {
 function nameConflict(
   kind: string, source: Source, ctx$: any,
 ): { package?: string, base?: string } | undefined {
-  const declared: any = ctx$.model?.main?.[KIT]?.[kind]?.[source.name]
+  const declared: any = kindCollection(ctx$.model, kind)?.[source.name]
 
   if (null == declared || 'object' !== typeof declared) {
     return undefined
@@ -423,6 +427,24 @@ function providesStill(
 }
 
 
+function recordedRef(declared: any, name: string): string | undefined {
+  if (null == declared?.base || '' === declared.base) {
+    return undefined
+  }
+
+  const origname = declared.origname || name
+
+  return Path.join(declared.base, '..', origname) +
+    (origname === name ? '' : '~' + name)
+}
+
+
+// A bare NAME, as opposed to a ref that locates a source.
+function isBare(ref: string): boolean {
+  return !ref.includes('/') && !ref.includes(Path.sep)
+}
+
+
 function normaliseBase(base: string): string {
   return Path.normalize(String(base ?? '')).split(Path.sep).join('/')
 }
@@ -439,6 +461,8 @@ export type {
 
 export {
   resolveSource,
+  recordedRef,
+  isBare,
   registerInstalled,
   nameConflict,
   lastSegment,

package/src/admin/status.ts

@@ -0,0 +1,124 @@
+import Fs from 'node:fs'
+import Path from 'node:path'
+import { spawnSync } from 'node:child_process'
+
+function command(cwd: string, bin: string, args: string[]) {
+  return spawnSync(bin, args, { cwd, encoding: 'utf8', timeout: 15000, windowsHide: true, env: { ...process.env, GIT_OPTIONAL_LOCKS: '0' } })
+}
+function git(cwd: string, args: string[]): string | null {
+  const result = command(cwd, 'git', args)
+  return result.status === 0 ? result.stdout.trim() : null
+}
+function directory(path: string): boolean {
+  return Fs.existsSync(path) && Fs.statSync(path).isDirectory()
+}
+function entries(value: any): [string, any][] {
+  return Object.entries(value || {}).filter(([name]) => !name.includes('$')).sort(([a], [b]) => a.localeCompare(b))
+}
+function workingTree(folder: string) {
+  if (!directory(folder)) return 'missing'
+  const state = git(folder, ['status', '--porcelain=v1', '--untracked-files=normal', '--', '.'])
+  return state === null ? 'not a git repository' : state ? 'modified' : 'clean'
+}
+
+// Read the compiled model and working trees. Never fetch, build, test, or publish.
+export function repositoryStatus(root: string) {
+  root = Path.resolve(root)
+  const sdk = Path.join(root, '.sdk')
+  if (!directory(sdk)) throw new Error('Expected an SDK repository containing .sdk: ' + root)
+  const file = Path.join(sdk, 'model/sdk.json')
+  let model: any, modelError: string | undefined
+  if (Fs.existsSync(file)) {
+    try {
+      model = JSON.parse(Fs.readFileSync(file, 'utf8'))
+      if (!model?.main?.kit) throw new Error('missing main.kit')
+    } catch (err: any) { modelError = 'Invalid compiled model: ' + err.message }
+  }
+  const kit = model?.main?.kit || {}
+  const upstream = git(root, ['rev-parse', '--abbrev-ref', '--symbolic-full-name', '@{upstream}'])
+  const counts = upstream && git(root, ['rev-list', '--left-right', '--count', 'HEAD...@{upstream}'])
+  const [ahead, behind] = counts ? counts.split(/\s+/).map(Number) : [null, null]
+  const packages = ['sdkgen', 'apidef', 'model', 'docgen'].map(name => {
+    const file = Path.join(sdk, 'node_modules/@voxgig', name, 'package.json')
+    try { return { name: '@voxgig/' + name, version: JSON.parse(Fs.readFileSync(file, 'utf8')).version } }
+    catch { return { name: '@voxgig/' + name, version: 'not installed' } }
+  })
+  return {
+    root, name: model?.name || Path.basename(root),
+    repository: {
+      branch: git(root, ['branch', '--show-current']) || 'detached or not initialised',
+      commit: git(root, ['rev-parse', '--short', 'HEAD']), state: workingTree(root), upstream, ahead, behind,
+    },
+    model: { path: file, compiled: !!model && !modelError, error: modelError,
+      generatedAt: Fs.existsSync(file) ? Fs.statSync(file).mtime.toISOString() : null },
+    toolchain: { node: process.version, packages },
+    targets: entries(kit.target).map(([name, target]) => {
+      const folder = Path.resolve(root, target.output?.path || name)
+      const present = directory(folder)
+      return { name, active: target.active !== false, path: folder, present,
+        state: workingTree(folder), readme: Fs.existsSync(Path.join(folder, 'README.md')),
+        version: target.publish?.version || null,
+        publication: target.publish?.registry?.state || 'not recorded',
+      }
+    }),
+    editions: entries(kit.doc?.edition).map(([name, edition]) => ({ name,
+      active: kit.doc?.active !== false && edition.active !== false, kind: edition.kind,
+      path: edition.output?.path || null,
+      present: !!edition.output?.path && Fs.existsSync(Path.resolve(root, edition.output.path)),
+    })),
+  }
+}
+
+function githubStatus(root: string) {
+  const run = (args: string[]) => {
+    const result = command(root, 'gh', args)
+    if (result.status !== 0) throw new Error(result.error?.message || result.stderr.trim() || 'GitHub query failed')
+    return JSON.parse(result.stdout)
+  }
+  const repository = run(['repo', 'view', '--json', 'nameWithOwner,url'])
+  const host = new URL(repository.url).hostname
+  const pages = command(root, 'gh', ['api', '--hostname', host, 'repos/' + repository.nameWithOwner + '/pages'])
+  let site: any
+  try { site = JSON.parse(pages.stdout || '{}') } catch { site = {} }
+  if (pages.status !== 0 && String(site.status) !== '404') throw new Error(pages.error?.message || pages.stderr.trim() || 'Pages query failed')
+  return { repository: repository.nameWithOwner,
+    pages: pages.status === 0 ? { url: site.html_url, status: site.status, buildType: site.build_type } : { status: 'not configured' },
+    runs: run(['run', 'list', '--limit', '5', '--json', 'workflowName,status,conclusion,headBranch,url']),
+  }
+}
+
+export function main(args = process.argv.slice(2)): number {
+  const root = args.shift()
+  if (args.includes('--help') || root === '--help') {
+    console.log('Usage: .sdk/admin/status.sh [--json] [--github]\nRead local repository, SDK, and documentation status. --github also reads Pages and recent CI runs.\nBuild and test results are not inferred from generated files. No commands that change the repository are run.')
+    return 0
+  }
+  if (!root || args.some(arg => !['--json', '--github'].includes(arg))) throw new Error('Usage: status.sh [--json] [--github]')
+  const report: any = repositoryStatus(root)
+  let failed = !!report.model.error
+  if (args.includes('--github')) {
+    try { report.github = githubStatus(report.root) }
+    catch (err: any) { report.github = { error: err.message }; failed = true }
+  }
+  if (args.includes('--json')) console.log(JSON.stringify(report, null, 2))
+  else {
+    console.log('Repository: ' + report.root)
+    console.log('Git: ' + report.repository.branch + ' | ' + report.repository.state + ' | ' + (report.repository.commit || 'no commits'))
+    console.log('Upstream: ' + (report.repository.upstream ? report.repository.upstream + ' | ahead ' + report.repository.ahead + ', behind ' + report.repository.behind + ' (local tracking refs)' : 'not configured'))
+    console.log('Model: ' + (report.model.error || (report.model.compiled ? 'compiled ' + report.model.generatedAt : 'not generated; run npm run generate from .sdk')))
+    console.log('Toolchain: Node ' + report.toolchain.node + '; ' + report.toolchain.packages.map((p: any) => p.name + ' ' + p.version).join('; '))
+    console.log('\nSDKs and tools (publication state comes from the model):')
+    for (const t of report.targets) console.log('  ' + t.name + ' | ' + (t.active ? 'active' : 'inactive') + ' | ' + t.state + ' | version ' + (t.version || 'not recorded') + ' | ' + t.publication + ' | ' + t.path)
+    if (!report.targets.length) console.log('  No targets in the compiled model.')
+    console.log('\nDocumentation:')
+    for (const e of report.editions) console.log('  ' + e.name + ' | ' + (e.active ? 'active' : 'inactive') + ' | ' + (e.present ? 'present' : 'missing') + ' | ' + (e.path || 'no output path'))
+    if (!report.editions.length) console.log('  No editions in the compiled model.')
+    console.log('\nLocal status does not run builds/tests or check registries. Use --github for remote CI and Pages status.')
+    if (report.github) console.log('\nGitHub:\n' + JSON.stringify(report.github, null, 2))
+  }
+  return failed ? 1 : 0
+}
+
+if (require.main === module) {
+  try { process.exitCode = main() } catch (err: any) { console.error(err.message); process.exitCode = 1 }
+}

package/src/cmp/Test.ts

@@ -1,6 +1,6 @@
 
 import {
-  cmp,
+  cmp, File, Content,
 } from 'jostraca'
 
 import { requirePath } from '../utility'
@@ -19,6 +19,18 @@ const Test = cmp(function Test(props: any) {
   const { model, log } = ctx$
   const stdrep = ensureStdrep(ctx$)
 
+  const points = Object.values(model.main.kit.entity || {}).flatMap((entity: any) =>
+    Object.values(entity.op || {}).flatMap((op: any) => op.points || [])) as any[]
+  if (points.some(point => point.contract && JSON.parse(point.contract.json).live)) {
+    const supported = ['ts', 'js'].includes(target.name)
+    File({ name: 'live-coverage.json' }, () => Content(JSON.stringify({
+      version: 1, target: target.name, scenarios: supported ? 'supported' : 'unsupported',
+      points: points.map(point => point.contract?.id || point.method + ' ' + point.orig),
+      ...(!supported ? { reason: 'This target does not yet execute declarative live recipes. Its existing tests do not establish full operation coverage.' } : {}),
+    }, null, 2)))
+    if (!supported) log.warn({ point: 'live-scenarios-unsupported', note: 'Declarative live recipes are not executed by target ' + target.name })
+  }
+
   const Test_sdk = requirePath(ctx$, `./cmp/${target.name}/Test_${target.name}`)
   Test_sdk['Test']({ model, target, stdrep })
 

package/src/helpers/kindCollection.ts

@@ -0,0 +1,11 @@
+import { KIT } from '../types'
+
+// Physical kind names and model namespaces are independent.
+export function kindCollection(model: any, kind: string, create = false): any {
+  const kit = create ? (model.main ??= {})[KIT] ??= {} : model?.main?.[KIT]
+  if (kind === 'edition') {
+    const doc = create ? kit.doc ??= {} : kit?.doc
+    return create ? doc.edition ??= {} : doc?.edition ?? {}
+  }
+  return create ? kit[kind] ??= {} : kit?.[kind] ?? {}
+}

package/src/helpers/modelcheck.ts

@@ -33,6 +33,8 @@
 //      project's own file, not the package's.
 
 import { Aontu } from 'aontu'
+import { createRequire } from 'node:module'
+import Path from 'node:path'
 
 import { schemaFile } from './shipped'
 
@@ -112,8 +114,8 @@ function slashComments(text: string): { line: number, text: string }[] {
 // A FRESH INSTANCE each time: the option call mutates the instance's jsonic,
 // so a cached one would leak its configuration into the bare compile that is
 // deliberately paired with it.
-function strictAontu(): any {
-  const aontu: any = new Aontu()
+function strictAontu(options?: any): any {
+  const aontu: any = new Aontu(options)
   aontu.lang.jsonic.options({ comment: { def: { slash: null, multi: null } } })
   return aontu
 }
@@ -186,7 +188,12 @@ function compileModel(
     includeLine(schemaFile()) + '\n' + src : src
 
   try {
-    const aontu = false === opts?.strict ? new Aontu() : strictAontu()
+    // Resolve package includes from the model being checked, including native
+    // package self-references. The SDK toolchain's dependencies are unrelated.
+    const localRequire = Object.assign(createRequire(Path.resolve(path)), { main: require.main })
+    // Aontu forwards this runtime resolver option to Lang; its public type omits it.
+    const options: any = { require: localRequire }
+    const aontu = false === opts?.strict ? new Aontu(options) : strictAontu(options)
     const model = aontu.generate(text, { path, errs })
 
     return {

package/src/helpers/shipped.ts

@@ -9,9 +9,8 @@
 // installation doing the checking, which is this one.
 //
 // `__dirname` is `dist/helpers` in the shipped package, so the package root is
-// two levels up. npm can only ship files under that root, which is why the
-// canonical `model/` is mirrored into `ts/model/` (the model-mirror guard
-// fails on drift).
+// two levels up. The authoritative schema lives directly in its model/
+// directory, in both a checkout and an installed package.
 
 import Path from 'node:path'
 

package/src/helpers/testPolicy.ts

@@ -1,52 +1,14 @@
-// How strict the generated LIVE tests are.
-//
-// WHY THIS IS A MODEL DECISION
-//
-// The generated direct tests are deliberately lenient in live mode:
-//
-//   if (setup.live) {
-//     // Live mode is lenient: synthetic IDs frequently 4xx.
-//     if (!result.ok || result.status < 200 || result.status >= 300) {
-//       return                       // <-- passes
-//     }
-//   } else {
-//     assert(result.ok === true)
-//     ...
-//   }
-//
-// That is CORRECT for sdkgen's default case — a fleet SDK generated against
-// an arbitrary third-party public API, where synthetic IDs 4xx constantly and
-// list response shapes vary wildly. Asserting there would mean permanent red.
-//
-// It is WRONG for a project that owns the server it tests against, and those
-// projects had no way to say so. Measured on voxgig-solardemo-sdk: the live
-// TypeScript suite reports 186 pass / 0 fail against the local test app —
-// and 184 pass / 2 fail with the server STOPPED. Only the two entity `basic`
-// flows noticed. A green live run said almost nothing.
-//
-// Gaps that announce themselves as a passing test suite are worse than the
-// ones that break a build.
-
 import { KIT } from '../types'
 
-
-// True when live assertions should match the offline ones. Per-target
-// override first, then the SDK-wide default, then false.
-//
-//   main: kit: test: live: strict: true
-//   main: kit: target: go: test: live: strict: true
+// Live requests assert success by default. This never enables fail-fast:
+// independent tests continue and their framework aggregates the failures.
+// An explicit false preserves the legacy exploratory policy for callers
+// migrating a fleet; it must not be confused with full live verification.
 function liveStrict(model: any, target?: string): boolean {
   const perTarget = null == target ? undefined :
     model?.main?.[KIT]?.target?.[target]?.test?.live?.strict
-
-  if (null != perTarget) {
-    return true === perTarget
-  }
-
-  return true === model?.main?.[KIT]?.test?.live?.strict
+  const configured = perTarget ?? model?.main?.[KIT]?.test?.live?.strict
+  return false !== configured
 }
 
-
-export {
-  liveStrict,
-}
+export { liveStrict }

package/src/sdkgen.ts

@@ -24,8 +24,6 @@ import { SdkGenError, requirePath, isAuthActive, resolveAuthPrefix, isHttpBasicA
 import { Main } from './cmp/Main'
 import { featureApplies, targetFeatures, featureTags, unknownTags, TAGS } from './helpers/applicability'
 import { ExternalTarget } from './cmp/ExternalTarget'
-import { Docs, DocsItem } from './cmp/Docs'
-import { ExternalDocs } from './cmp/ExternalDocs'
 
 import { KIT } from '@voxgig/apidef'
 import { Deploy } from './cmp/Deploy'
@@ -150,7 +148,7 @@ import {
 
 import { cmd_package_check } from './action/check'
 
-import { docs_add } from './action/docs'
+import { edition_add } from './action/edition'
 
 // The verbs, built from the kind registry — see action/dispatch.
 import { ACTION_MAP, actionNames, needsModel } from './action/dispatch'
@@ -350,7 +348,7 @@ function SdkGen(opts: SdkGenOptions) {
     // if it appeared between those checks, the pass could write into content
     // that was never ownership-validated.
     const external: ExternalPlan[] =
-      externalItems(model, root, ['target', 'docs'], externalOverride)
+      externalItems(model, root, ['target'], externalOverride)
         .map((ext) => ({ ...ext, skip: externalSkipReason(ext, fs) }))
 
     // Before ANY file is written, in-tree included: a destination that turns
@@ -363,74 +361,13 @@ function SdkGen(opts: SdkGenOptions) {
 
     showChanges(jopts.log, 'generate-result', jres, Path.dirname(process.cwd()))
 
-    // IN-TREE DOCS, in their own pass over the same root.
-    //
-    // The alternative is one `Kinds()` call in the consumer's `Root.ts` —
-    // which create-sdkgen writes once and never revisits, so every project
-    // scaffolded before the docs kind existed would have to be hand-edited
-    // before `docs add` did anything. A second pass costs one more changes
-    // report and makes the kind work in projects that predate it, which is
-    // the whole point of putting the destinations in packages.
-    //
-    // Items with `output: path` are excluded here and generated by the loop
-    // below, exactly as out-of-tree targets are.
-    const intreedocs = Object.keys(model?.main?.[KIT]?.docs ?? {})
-      .filter((name: string) => {
-        const item = model.main[KIT].docs[name]
-        const path = item?.output?.path
-        return false !== item?.active && (null == path || '' === path)
+    // Docgen owns editions, destinations, templates, text QA and deployment.
+    if (model?.main?.[KIT]?.doc?.active !== false && Object.values(model?.main?.[KIT]?.doc?.edition ?? {})
+      .some((item: any) => item.active !== false)) {
+      const docgenPath = require.resolve('@voxgig/docgen', {
+        paths: [Path.join(root, '.sdk')],
       })
-
-    // AN IN-TREE DOCS ITEM AND A TARGET CANNOT SHARE A NAME.
-    //
-    // `docs` and `target` are separate namespaces — deliberately, so an item
-    // of each may be called `api` — and their `.sdk` trees are nested apart
-    // (`src/cmp/docs/<n>` vs `src/cmp/<n>`), so installing both is fine.
-    //
-    // Their GENERATED destinations are not separate. Both render into
-    // `<sdk-repo>/<name>/`, the docs pass runs second, and jostraca is
-    // last-write-wins — so a docs item named `go` would quietly overwrite the
-    // Go SDK's README, and whatever else the two have in common, leaving a
-    // corrupt SDK and a green run.
-    //
-    // Refused rather than reordered, and refused BEFORE the docs pass writes
-    // anything: this is the in-tree half of the rule `checkExternalFolders`
-    // enforces for out-of-tree destinations, and the fix is the same either
-    // way — give one of them `output: path`, or rename it.
-    const targets: any = model?.main?.[KIT]?.target ?? {}
-
-    for (const name of intreedocs) {
-      const target = targets[name]
-
-      if (null == target || false === target.active) {
-        continue
-      }
-
-      const tpath = target.output?.path
-
-      if (null != tpath && '' !== tpath) {
-        continue
-      }
-
-      throw new SdkGenError(
-        'Docs item "' + name + '" and target "' + name + '" would both ' +
-        'generate into <sdk-project>/' + name + '/.\n' +
-        '  They are separate kinds, so sharing a name is legal — but they ' +
-        'share one output folder, and the docs pass runs second, so it ' +
-        'would overwrite the SDK.\n' +
-        '  Give one of them `output: path`, or rename it.')
-    }
-
-    if (0 < intreedocs.length) {
-      log.info({
-        point: 'generate-docs-start', docs: intreedocs,
-        note: intreedocs.join(', ')
-      })
-
-      const dres = await jostraca.generate(jopts, () => Docs({ model }))
-
-      showChanges(jopts.log, 'generate-docs-result', dres,
-        Path.dirname(process.cwd()))
+      await require(docgenPath).generate({ ...jopts, folder: root, model })
     }
 
     for (const ext of external) {
@@ -462,12 +399,7 @@ function SdkGen(opts: SdkGenOptions) {
 
       const sdkrelpath = externalSdkRel(ext, root, log)
 
-      const eres = 'docs' === ext.kind ?
-        await jostraca.generate(
-          { ...jopts, folder: ext.folder },
-          () => ExternalDocs({
-            model, item: ext.target, cmpfolder: folder, sdkrelpath,
-          })) :
+      const eres =
         await jostraca.generate(
         { ...jopts, folder: ext.folder },
         () => ExternalTarget({
@@ -628,10 +560,10 @@ function SdkGen(opts: SdkGenOptions) {
 
   // The third kind. sdkgen ships no docs items, so every ref here is a path
   // into a package — see action/docs.
-  const docs = {
+  const edition = {
     add: async (items: string[]): Promise<ActionResult> => {
       const ctx = resolveActionContext()
-      return docs_add(items, ctx)
+      return edition_add(items, ctx)
     }
   }
 
@@ -680,7 +612,7 @@ function SdkGen(opts: SdkGenOptions) {
     generate,
     action,
     check,
-    docs,
+    edition,
     target,
     feature,
 
@@ -822,16 +754,8 @@ function resolveExternalOverride(
 }
 
 
-// Every item, of every kind, that generates OUTSIDE the SDK repo.
-//
-// Keyed by kind because `docs` needs exactly this and a second copy of it
-// would drift: the out-of-tree rules — a destination must be outside the
-// project, unclaimed, and either empty or previously generated into — are
-// properties of WRITING SOMEWHERE ELSE, not of being a target.
-//
-// The claim map spanning kinds is the load-bearing part: a docs item and a
-// target pointed at the same folder would otherwise silently overwrite each
-// other, in whatever order the passes happen to run.
+// SDK targets can generate into separately owned repositories. Documentation
+// editions are confined to this SDK repository and are handled by docgen.
 function externalItems(
   model: any, folder: string, kinds: string[],
   override: Record<string, ExternalOverride>,
@@ -841,10 +765,7 @@ function externalItems(
 
     return Object.keys(items).sort()
       .map((name: string) => {
-        // Keyed by NAME, across kinds: a docs item and a target that share a
-        // name share an override. They already share an output folder if both
-        // are pointed at one (the claim map refuses that), so a name that
-        // means two things is a problem before it reaches here.
+        // Overrides are keyed by installed target name.
         const ov = override[name] || {}
 
         // A SHALLOW CLONE, so the override never writes back into the model.

package/src/utility.ts

@@ -381,8 +381,14 @@ function withPointParts(op: any): any {
   each(op, (o: any, opname: string) => {
     out[opname] = null == o || null == o.points ? o : {
       ...o,
-      points: each(o.points).map((pt: any) =>
-        null == pt ? pt : { ...pt, parts: pointParts(pt) }),
+      points: each(o.points).map((pt: any) => {
+        if (null == pt) return pt
+        // Contracts feed test generation directly from the model. Keeping
+        // them in every runtime entity also retains entire request/response
+        // schemas in clones and debug output, exhausting large SDKs' memory.
+        const { contract, ...runtimePoint } = pt
+        return { ...runtimePoint, parts: pointParts(pt) }
+      }),
     }
   })
 

package/dist/action/docs.d.ts

@@ -1,4 +0,0 @@
-import type { ActionContext, ActionResult } from '../types';
-declare function action_docs(args: string[], actx: ActionContext): Promise<ActionResult>;
-declare function docs_add(docs: string[], actx: ActionContext): Promise<ActionResult>;
-export { action_docs, docs_add, };

package/dist/action/docs.js.map

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

package/dist/cmp/Docs.d.ts

@@ -1,4 +0,0 @@
-declare function prepareModel(model: any, ctx$: any): void;
-declare const DocsItem: import("jostraca").Component;
-declare const Docs: import("jostraca").Component;
-export { Docs, DocsItem, prepareModel, };