@voxgig/create-sdkgen 0.16.3 → 0.16.5

package/bin/create-sdkgen

@@ -14,6 +14,32 @@ const { CreateSdkGen } = require('../dist/create-sdkgen.js')
 
 let KONSOLE = global['con'+'sole']
 
+// Print stack traces only when the user actually selected a verbose level.
+// Read from argv directly: handleError can fire before options are parsed.
+//
+// Both spellings must agree. `--debug=warn` carries its value in one token,
+// but the space-separated `--debug warn` leaves a BARE `--debug` in argv — so
+// matching a bare token turned stacks on for every level, including warn/error,
+// while the `=` form correctly did not.
+function debugLevel() {
+  const argv = process.argv
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i]
+    if (a.startsWith('--debug=')) {
+      return a.slice('--debug='.length)
+    }
+    if ('--debug' === a) {
+      // Bare flag: the level is the NEXT token, unless another option follows
+      // (or nothing does), in which case no level was selected.
+      const next = argv[i + 1]
+      return (null != next && !next.startsWith('-')) ? next : ''
+    }
+  }
+  return ''
+}
+
+const DEBUG_STACK = ['debug', 'trace'].includes(debugLevel())
+
 run()
 
 
@@ -35,7 +61,11 @@ async function run() {
 
     options = validateOptions(options)
 
-    generate(options)
+    // AWAIT: generate() is async. Dropping the promise meant every async
+    // failure (a failing `npm install` / `add-target`, a write error) escaped
+    // this catch and surfaced as a raw unhandled-rejection crash dump instead
+    // of a Voxgig error message with a non-zero exit.
+    await generate(options)
   }
   catch(err) {
     handleError(err)
@@ -52,7 +82,7 @@ function exit(err) {
 }
 
 
-function generate(options) {
+async function generate(options) {
   const createSdkGen = CreateSdkGen({
     debug: options.debug
   })
@@ -72,8 +102,8 @@ function generate(options) {
   }
 
   // console.log('OPTIONS', options)
-  
-  createSdkGen.generate(spec)
+
+  return createSdkGen.generate(spec)
 }
 
 
@@ -215,10 +245,18 @@ function validateOptions(rawOptions) {
 
 
 function handleError(err) {
-  console.log(err)
-  console.trace()
-  
-  KONSOLE.log('Voxgig Create SDK Error: '+err)
+  // The message is the useful part; the stack is noise for a CLI user and
+  // used to be printed BEFORE the message (twice, with a bare console.trace()
+  // pointing at handleError itself rather than at the failure). Keep the
+  // stack behind --debug for the cases where it is actually wanted.
+  const msg = (err && err.message) ? err.message : String(err)
+
+  KONSOLE.log('Voxgig Create SDK Error: ' + msg)
+
+  if (DEBUG_STACK && err && err.stack) {
+    KONSOLE.log(err.stack)
+  }
+
   exit(err)
 }
 

package/dist/create-sdkgen.js

@@ -76,7 +76,12 @@ function CreateSdkGen(opts) {
             node_path_1.default.join(cwd, name + (name.endsWith('-sdk') ? '' : '-sdk')) :
             node_path_1.default.isAbsolute(spec.folder) ? spec.folder :
                 node_path_1.default.join(cwd, spec.folder);
-        logCreate(folder);
+        // A dry run must not touch the filesystem — logCreate() mkdir's
+        // <folder>/.sdk/log and appends to create.log, which created a real
+        // directory tree for a run that is supposed to write nothing.
+        if (!dryrun) {
+            logCreate(folder);
+        }
         const jopts = {
             fs: () => fs,
             debug,
@@ -209,6 +214,27 @@ async function installNpm(spec, opts, model) {
         log.info({ point: 'generate-install', note: 'running npm install in ' + cwd });
         await runNpm(['install'], spawn_opts);
     }
+    // `-t` / `-f` are INDEPENDENT of `--no-install`: the documented contract is
+    // that --no-install skips `npm install`, not that it drops the requested
+    // targets and features. Adding them is still valid without an install when
+    // the project already has its toolchain (re-scaffolding an existing folder
+    // is a supported flow — "if run against an existing folder generated files
+    // will be overwritten").
+    //
+    // They ARE npm run scripts that resolve @voxgig/sdkgen from node_modules, so
+    // without one they cannot work. Fail with an actionable message rather than
+    // the raw module-resolution error — and rather than silently skipping, which
+    // reports success while leaving config.aontu without the requested entries.
+    const wanted = [
+        (spec.target ?? []).length ? '--target' : '',
+        (spec.feature ?? []).length ? '--feature' : '',
+    ].filter(Boolean);
+    if (0 < wanted.length && !Fs.existsSync(node_path_1.default.join(cwd, 'node_modules'))) {
+        throw new Error(`${wanted.join(' / ')} needs the project toolchain, but ` +
+            `${node_path_1.default.join(cwd, 'node_modules')} does not exist ` +
+            `(--no-install was given). Re-run without --no-install, or run ` +
+            `\`npm install\` then \`npm run add-target\` / \`add-feature\` in ${cwd}.`);
+    }
     await installTargets(spec, opts, model, spawn_opts);
     await installFeatures(spec, opts, model, spawn_opts);
 }

package/dist/create-sdkgen.js.map

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

package/dist/project/standard/CreateRoot.js

@@ -12,8 +12,9 @@ const GITIGNORE_TOP = `# Local config / secrets
 *.local.*
 *.local
 
-# Dependencies
-node_modules/
+# Dependencies (no trailing slash: also ignores node_modules SYMLINKS, e.g.
+# ts/node_modules -> shared tree, which a dir-only rule leaves tracked)
+node_modules
 
 # Logs
 *.log
@@ -30,8 +31,9 @@ const GITIGNORE_SDK = `# Local config / secrets
 *.local.*
 *.local
 
-# Dependencies
-node_modules/
+# Dependencies (no trailing slash: also ignores node_modules SYMLINKS, e.g.
+# .sdk/node_modules -> shared tree, which a dir-only rule leaves tracked)
+node_modules
 
 # Build output
 dist/
@@ -45,6 +47,47 @@ log/
 # OS
 .DS_Store
 `;
+// The guide overlay is the ONE model file the user owns.
+//
+// Everything else the scaffold writes is toolchain-derived and is deliberately
+// OVERWRITTEN (see the `existing.txt.write` rationale in create-sdkgen.ts) so a
+// toolchain fix propagates. `model/guide/guide.aontu` is the exception: apidef
+// unifies it OVER the heuristic classification, and it is where every
+// documented customization lives — entity rename, hide, move, activate,
+// per-path deactivation, method override, param rename, response transform.
+// Copying the stub over it destroyed that work on every re-scaffold, and
+// cedar-regen.sh re-scaffolds on every regen, so the loss was silent and
+// repeated.
+//
+// It is excluded from the bulk Copy and merged instead (see mergeGuide).
+const GUIDE_FILE = 'guide.aontu';
+const GUIDE_REL = ['model', 'guide', GUIDE_FILE];
+// Merge the guide template into an existing guide overlay.
+//
+// A guide is the template's `@`-includes plus whatever the user added. The
+// includes are the only part the template OWNS, so the merge is: keep the
+// user's file verbatim, and restore any include it is missing. When nothing
+// is missing — the normal case — the file is returned byte-identical, so a
+// re-scaffold is a no-op on it.
+//
+// Missing includes are restored at the TOP, not appended: `base-guide.aontu`
+// carries the heuristic classification that the user's overrides unify over,
+// and the overlay reads correctly only when the includes precede it.
+function mergeGuide(existing, template) {
+    if (null == existing) {
+        return template;
+    }
+    const isInclude = (line) => line.trim().startsWith('@');
+    const have = new Set(existing.split('\n').map((line) => line.trim()));
+    const missing = template.split('\n')
+        .filter(isInclude)
+        .map((line) => line.trim())
+        .filter((line) => !have.has(line));
+    if (0 === missing.length) {
+        return existing;
+    }
+    return missing.join('\n') + '\n\n' + existing;
+}
 // TODO: rename to RootSdk
 const CreateRoot = (0, jostraca_1.cmp)(function CreateRoot(props) {
     const { ctx$, ctx$: { folder }, spec, model } = props;
@@ -60,9 +103,13 @@ const CreateRoot = (0, jostraca_1.cmp)(function CreateRoot(props) {
     (0, jostraca_1.Project)({ folder }, () => {
         const from = node_path_1.default.resolve(node_path_1.default.join(__dirname, '..', '..', '..', 'project', 'standard'));
         // console.log('FROM', from)
+        // Copy `exclude` matches the SOURCE-RELATIVE path exactly, so this names
+        // the one guide under the scaffold and nothing else. It is re-emitted,
+        // merged, in the model folder below.
+        const guideExclude = [spec.sdk_folder, ...GUIDE_REL].join('/');
         (0, jostraca_1.Copy)({
             from,
-            exclude: [/\.fragment\./]
+            exclude: [/\.fragment\./, guideExclude]
         });
         (0, jostraca_1.File)({ name: '.gitignore' }, () => {
             (0, jostraca_1.Content)(GITIGNORE_TOP);
@@ -87,6 +134,17 @@ const CreateRoot = (0, jostraca_1.cmp)(function CreateRoot(props) {
             });
             (0, jostraca_1.Folder)({ name: 'model' }, () => {
                 (0, ModelSdk_1.ModelSdk)({ spec });
+                // Re-emit the guide the Copy skipped, merged over whatever is already
+                // there. On a fresh scaffold there is no existing file and this writes
+                // the template unchanged; on a re-scaffold the user's overlay survives.
+                (0, jostraca_1.Folder)({ name: 'guide' }, () => {
+                    const guideTemplate = fs.readFileSync(node_path_1.default.join(from, spec.sdk_folder, ...GUIDE_REL), 'utf8');
+                    const guidePath = node_path_1.default.join(folder, spec.sdk_folder, ...GUIDE_REL);
+                    const existingGuide = fs.existsSync(guidePath) ? fs.readFileSync(guidePath, 'utf8') : null;
+                    (0, jostraca_1.File)({ name: GUIDE_FILE }, () => {
+                        (0, jostraca_1.Content)(mergeGuide(existingGuide, guideTemplate));
+                    });
+                });
             });
         });
     });

package/dist/project/standard/CreateRoot.js.map

@@ -1 +1 @@
-{"version":3,"file":"CreateRoot.js","sourceRoot":"","sources":["../../../src/project/standard/CreateRoot.ts"],"names":[],"mappings":";;;;;;AAEA,0DAA4B;AAC5B,gCAAgC;AAEhC,uCAUiB;AAGjB,yCAAqC;AAGrC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;CAiBrB,CAAA;AAGD,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;CAkBrB,CAAA;AAGD,0BAA0B;AAC1B,MAAM,UAAU,GAAG,IAAA,cAAG,EAAC,SAAS,UAAU,CAAC,KAAU;IACnD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,CAAA;IACrD,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;IAEpB,2CAA2C;IAC3C,KAAK,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAA;IAClC,IAAA,gBAAK,EAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;IAC9B,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC3C,yEAAyE;IACzE,4EAA4E;IAC5E,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAA;IAE3B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IAElB,IAAA,kBAAO,EAAC,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE;QACvB,MAAM,IAAI,GACR,mBAAI,CAAC,OAAO,CAAC,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAA;QAE7E,4BAA4B;QAE5B,IAAA,eAAI,EAAC;YACH,IAAI;YACJ,OAAO,EAAE,CAAC,cAAc,CAAC;SAC1B,CAAC,CAAA;QAEF,IAAA,eAAI,EAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE;YAChC,IAAA,kBAAO,EAAC,aAAa,CAAC,CAAA;QACxB,CAAC,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAA;QACxB,MAAM,OAAO,GAAG,mBAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QACtC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAA;QAElB,IAAA,iBAAM,EAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE;YACrC,IAAA,eAAI,EAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE;gBAChC,IAAA,kBAAO,EAAC,aAAa,CAAC,CAAA;YACxB,CAAC,CAAC,CAAA;YAEF,IAAA,iBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE;gBAC3B,qDAAqD;gBACrD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC3B,IAAA,eAAI,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;gBACtC,CAAC;qBACI,CAAC;oBACJ,IAAA,eAAI,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE;wBAC3B,IAAA,kBAAO,EAAC,sBAAsB,CAAC,CAAA;oBACjC,CAAC,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC,CAAC,CAAA;YAEF,IAAA,iBAAM,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE;gBAC7B,IAAA,mBAAQ,EAAC,EAAE,IAAI,EAAE,CAAC,CAAA;YACpB,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IAEJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAIA,gCAAU"}
+{"version":3,"file":"CreateRoot.js","sourceRoot":"","sources":["../../../src/project/standard/CreateRoot.ts"],"names":[],"mappings":"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"}

package/dist/project/standard/ModelSdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"ModelSdk.js","sourceRoot":"","sources":["../../../src/project/standard/ModelSdk.ts"],"names":[],"mappings":";;;;;;AACA,0DAA4B;AAG5B,uCAKiB;AAIjB,MAAM,QAAQ,GAAG,IAAA,cAAG,EAAC,SAAS,QAAQ,CAAC,KAAU;IAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;IAEtB,MAAM,IAAI,GACR,mBAAI,CAAC,OAAO,CAAC,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAA;IAE7E,IAAA,eAAI,EAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE;QAC/B,IAAA,mBAAQ,EAAC;YACP,IAAI,EAAE,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,oBAAoB,CAAC;YACrE,OAAO,EAAE;gBACP,WAAW,EAAE,IAAI,CAAC,IAAI;gBACtB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,EAAE,IAAI,CAAC,GAAG;aACd;SACF,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AAEJ,CAAC,CAAC,CAAA;AAIA,4BAAQ"}
+{"version":3,"file":"ModelSdk.js","sourceRoot":"","sources":["../../../src/project/standard/ModelSdk.ts"],"names":[],"mappings":";;;;;;AACA,0DAA4B;AAG5B,uCAKiB;AAIjB,MAAM,QAAQ,GAAG,IAAA,cAAG,EAAC,SAAS,QAAQ,CAAC,KAAU;IAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;IAEtB,MAAM,IAAI,GACR,mBAAI,CAAC,OAAO,CAAC,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAA;IAE7E,IAAA,eAAI,EAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE;QAC/B,IAAA,mBAAQ,EAAC;YACP,IAAI,EAAE,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,oBAAoB,CAAC;YACrE,OAAO,EAAE;gBACP,WAAW,EAAE,IAAI,CAAC,IAAI;gBACtB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,EAAE,IAAI,CAAC,GAAG;aACd;SACF,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AAEJ,CAAC,CAAC,CAAA;QAIA,QAAQ"}

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/create-sdkgen.ts","../src/project/standard/CreateRoot.ts","../src/project/standard/ModelSdk.ts"],"version":"6.0.3"}
+{"version":"7.0.2","root":["../src/create-sdkgen.ts","../src/project/standard/CreateRoot.ts","../src/project/standard/ModelSdk.ts"],"packageJsons":["../node_modules/@types/node/package.json","../node_modules/@voxgig/util/package.json","../node_modules/jostraca/package.json","../node_modules/memfs/package.json","../node_modules/pino-pretty/package.json","../node_modules/pino-std-serializers/package.json","../node_modules/pino/package.json","../node_modules/shape/package.json","../node_modules/sonic-boom/package.json","../node_modules/thread-stream/package.json","../node_modules/undici-types/package.json","../package.json"],"missingPackageJsons":["../node_modules/@types/assert/package.json","../node_modules/@types/assert/strict/package.json","../node_modules/@types/async_hooks/package.json","../node_modules/@types/buffer/package.json","../node_modules/@types/child_process/package.json","../node_modules/@types/cluster/package.json","../node_modules/@types/console/package.json","../node_modules/@types/constants/package.json","../node_modules/@types/crypto/package.json","../node_modules/@types/dgram/package.json","../node_modules/@types/diagnostics_channel/package.json","../node_modules/@types/dns/package.json","../node_modules/@types/dns/promises/package.json","../node_modules/@types/domain/package.json","../node_modules/@types/events/package.json","../node_modules/@types/fs/package.json","../node_modules/@types/fs/promises/package.json","../node_modules/@types/http/package.json","../node_modules/@types/http2/package.json","../node_modules/@types/https/package.json","../node_modules/@types/inspector/package.json","../node_modules/@types/inspector/promises/package.json","../node_modules/@types/module/package.json","../node_modules/@types/net/package.json","../node_modules/@types/node/assert/package.json","../node_modules/@types/node/dns/package.json","../node_modules/@types/node/fs/package.json","../node_modules/@types/node/inspector/package.json","../node_modules/@types/node/path/package.json","../node_modules/@types/node/readline/package.json","../node_modules/@types/node/stream/package.json","../node_modules/@types/node/test/package.json","../node_modules/@types/node/timers/package.json","../node_modules/@types/node/util/package.json","../node_modules/@types/node/web-globals/package.json","../node_modules/@types/node/zlib/package.json","../node_modules/@types/os/package.json","../node_modules/@types/path/package.json","../node_modules/@types/path/posix/package.json","../node_modules/@types/path/win32/package.json","../node_modules/@types/perf_hooks/package.json","../node_modules/@types/process/package.json","../node_modules/@types/punycode/package.json","../node_modules/@types/querystring/package.json","../node_modules/@types/readline/package.json","../node_modules/@types/readline/promises/package.json","../node_modules/@types/repl/package.json","../node_modules/@types/stream/consumers/package.json","../node_modules/@types/stream/iter/package.json","../node_modules/@types/stream/package.json","../node_modules/@types/stream/promises/package.json","../node_modules/@types/stream/web/package.json","../node_modules/@types/string_decoder/package.json","../node_modules/@types/timers/package.json","../node_modules/@types/timers/promises/package.json","../node_modules/@types/tls/package.json","../node_modules/@types/trace_events/package.json","../node_modules/@types/tty/package.json","../node_modules/@types/url/package.json","../node_modules/@types/util/package.json","../node_modules/@types/util/types/package.json","../node_modules/@types/v8/package.json","../node_modules/@types/vm/package.json","../node_modules/@types/wasi/package.json","../node_modules/@types/worker_threads/package.json","../node_modules/@types/zlib/package.json","../node_modules/@voxgig/util/dist/package.json","../node_modules/assert/package.json","../node_modules/assert/strict/package.json","../node_modules/async_hooks/package.json","../node_modules/buffer/package.json","../node_modules/child_process/package.json","../node_modules/cluster/package.json","../node_modules/console/package.json","../node_modules/constants/package.json","../node_modules/crypto/package.json","../node_modules/dgram/package.json","../node_modules/diagnostics_channel/package.json","../node_modules/dns/package.json","../node_modules/dns/promises/package.json","../node_modules/domain/package.json","../node_modules/events/package.json","../node_modules/fs/package.json","../node_modules/fs/promises/package.json","../node_modules/http/package.json","../node_modules/http2/package.json","../node_modules/https/package.json","../node_modules/inspector/package.json","../node_modules/inspector/promises/package.json","../node_modules/jostraca/dist/build/package.json","../node_modules/jostraca/dist/cmp/package.json","../node_modules/jostraca/dist/package.json","../node_modules/jostraca/dist/util/package.json","../node_modules/module/package.json","../node_modules/net/package.json","../node_modules/os/package.json","../node_modules/path/package.json","../node_modules/path/posix/package.json","../node_modules/path/win32/package.json","../node_modules/perf_hooks/package.json","../node_modules/process/package.json","../node_modules/punycode/package.json","../node_modules/querystring/package.json","../node_modules/readline/package.json","../node_modules/readline/promises/package.json","../node_modules/repl/package.json","../node_modules/shape/dist/package.json","../node_modules/sonic-boom/types/package.json","../node_modules/stream/consumers/package.json","../node_modules/stream/iter/package.json","../node_modules/stream/package.json","../node_modules/stream/promises/package.json","../node_modules/stream/web/package.json","../node_modules/string_decoder/package.json","../node_modules/thread-stream/node_modules/events/package.json","../node_modules/thread-stream/node_modules/worker_threads/package.json","../node_modules/timers/package.json","../node_modules/timers/promises/package.json","../node_modules/tls/package.json","../node_modules/trace_events/package.json","../node_modules/tty/package.json","../node_modules/url/package.json","../node_modules/util/package.json","../node_modules/util/types/package.json","../node_modules/v8/package.json","../node_modules/vm/package.json","../node_modules/wasi/package.json","../node_modules/worker_threads/package.json","../node_modules/zlib/package.json"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voxgig/create-sdkgen",
-  "version": "0.16.3",
+  "version": "0.16.5",
   "main": "dist/create-sdkgen.js",
   "type": "commonjs",
   "types": "dist/create-sdkgen.d.ts",
@@ -33,8 +33,8 @@
     "repo-tag-dry": "REPO_VERSION=`node -e \"console.log(require('./package').version)\"` && echo \"[dry-run] TAG: v$REPO_VERSION\" && if git rev-parse -q --verify refs/tags/v$REPO_VERSION >/dev/null; then echo \"[dry-run] WARNING: tag v$REPO_VERSION already exists - bump the version first\"; else echo \"[dry-run] would commit -a, push, tag v$REPO_VERSION and push --tags; nothing done\"; fi && git status --short",
     "repo-publish": "npm run clean && npm i && npm run repo-publish-quick",
     "repo-publish-dry": "npm run clean && npm i && npm run repo-publish-quick-dry",
-    "repo-publish-quick": "npm run build && npm run test && npm publish --registry https://registry.npmjs.org --access=public",
-    "repo-publish-quick-dry": "npm run build && npm run test && ( npm publish --dry-run --registry https://registry.npmjs.org --access=public || echo \"[dry-run] npm publish refused (see npm error above) - usually the version is already published; bump package.json before a real release\" )",
+    "repo-publish-quick": "npm run build && npm run test && npm stage publish --registry https://registry.npmjs.org --access=public",
+    "repo-publish-quick-dry": "npm run build && npm run test && ( npm stage publish --dry-run --registry https://registry.npmjs.org --access=public || echo \"[dry-run] npm stage publish refused (see npm error above) - usually the version is already published; bump package.json before a real release\" )",
     "repo-release": "npm run repo-publish && npm run repo-tag",
     "repo-release-dry": "npm run repo-publish-quick-dry && npm run repo-tag-dry"
   },
@@ -47,15 +47,15 @@
     "LICENSE"
   ],
   "devDependencies": {
-    "@types/node": "26.1.0",
-    "memfs": "4.62.0",
-    "typescript": "6.0.3"
+    "@types/node": "26.1.2",
+    "memfs": "4.64.0",
+    "typescript": "7.0.2"
   },
   "dependencies": {
-    "@voxgig/util": "0.5.1",
-    "aontu": "0.48.1",
+    "@voxgig/util": "0.5.4",
+    "aontu": "0.48.2",
     "chokidar": "5.0.0",
-    "jostraca": "0.31.0",
-    "shape": "10.1.0"
+    "jostraca": "0.31.2",
+    "shape": "10.1.3"
   }
 }

package/project/standard/.github/workflows/ci.yml

@@ -8,6 +8,30 @@ name: ci
 # Live API verification is NOT run here. It happens in the central
 # rebuild pipeline under controlled conditions, with per-API auth and
 # rate-limit handling.
+#
+# ---------------------------------------------------------------------------
+# COVERAGE TIERS
+#
+# sdkgen generates 22 language targets; this workflow used to have jobs for
+# eight of them (go, go-cli, go-mcp, ts, py, rb, php, lua). The other
+# fourteen were generated into every SDK repo and never compiled or tested
+# there, so a template regression in, say, rust or swift could only be found
+# by hand.
+#
+# BLOCKING — proven jobs. A failure here fails the build.
+#   go, go-cli, go-mcp, ts, py, rb, php, lua
+#
+# ADVISORY — added to close the coverage gap, marked continue-on-error until
+# each has had a green run in a real SDK repo. They report problems without
+# blocking a release; promote a job to blocking (drop continue-on-error) once
+# it has passed. Do not leave one advisory indefinitely — an advisory job that
+# is always red is the same blind spot in a different costume.
+#   js, csharp, java, kotlin, scala, swift, dart, rust, c, cpp, zig, perl,
+#   clojure, elixir, ocaml, haskell
+#
+# Every target exposes `make -C <lang> test`, so the jobs differ only in
+# toolchain setup.
+# ---------------------------------------------------------------------------
 
 on:
   push:
@@ -138,3 +162,211 @@ jobs:
         run: luarocks install busted
       - if: hashFiles('lua/Makefile') != ''
         run: make -C lua test
+
+  # ---- ADVISORY (see COVERAGE TIERS above) ---------------------------------
+
+  js:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - if: hashFiles('js/Makefile') != ''
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+      - if: hashFiles('js/package.json') != ''
+        run: cd js && npm install --no-audit --no-fund
+      - if: hashFiles('js/Makefile') != ''
+        run: make -C js test
+
+  csharp:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - if: hashFiles('csharp/Makefile') != ''
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '8.0.x'
+      - if: hashFiles('csharp/Makefile') != ''
+        run: make -C csharp test
+
+  java:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - if: hashFiles('java/Makefile') != ''
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '21'
+      - if: hashFiles('java/Makefile') != ''
+        run: make -C java test
+
+  kotlin:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - if: hashFiles('kotlin/Makefile') != ''
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '21'
+      - if: hashFiles('kotlin/Makefile') != ''
+        run: make -C kotlin test
+
+  scala:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - if: hashFiles('scala/Makefile') != ''
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '21'
+      # scala-cli, NOT sbt: the generated Makefile runs
+      # `scala-cli run . --main-class ...` and there is no build.sbt.
+      #
+      # Pinned to a release tag, not @main: every generated SDK runs this
+      # workflow, so a mutable default branch would let an upstream push change
+      # what executes in every consumer's CI with no change or review in their
+      # repo. Matches how the other third-party setup actions here are pinned.
+      - if: hashFiles('scala/Makefile') != ''
+        uses: VirtusLab/scala-cli-setup@v1.5.1
+      - if: hashFiles('scala/Makefile') != ''
+        run: make -C scala test
+
+  swift:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - if: hashFiles('swift/Makefile') != ''
+        uses: swift-actions/setup-swift@v2
+        with:
+          swift-version: '6.0'
+      - if: hashFiles('swift/Makefile') != ''
+        run: make -C swift test
+
+  dart:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - if: hashFiles('dart/Makefile') != ''
+        uses: dart-lang/setup-dart@v1
+        with:
+          sdk: stable
+      - if: hashFiles('dart/pubspec.yaml') != ''
+        run: cd dart && dart pub get
+      - if: hashFiles('dart/Makefile') != ''
+        run: make -C dart test
+
+  rust:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - if: hashFiles('rust/Makefile') != ''
+        uses: dtolnay/rust-toolchain@stable
+      - if: hashFiles('rust/Makefile') != ''
+        run: make -C rust test
+
+  c:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      # gcc/make are preinstalled on ubuntu-latest — no setup step needed.
+      - if: hashFiles('c/Makefile') != ''
+        run: make -C c test
+
+  cpp:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - if: hashFiles('cpp/Makefile') != ''
+        run: make -C cpp test
+
+  zig:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      # 0.13, NOT 0.14+: the generated build.zig.zon declares `.name` as a
+      # plain string, which 0.14 rejects ("expected enum literal"). Package_zig
+      # says the string form matches the target's toolchain pin — keep the two
+      # in step, or move both to the enum-literal + fingerprint form together.
+      - if: hashFiles('zig/build.zig') != ''
+        uses: mlugg/setup-zig@v1
+        with:
+          version: '0.13.0'
+      - if: hashFiles('zig/build.zig') != ''
+        run: make -C zig test
+
+  perl:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      # perl is preinstalled on ubuntu-latest.
+      - if: hashFiles('perl/Makefile') != ''
+        run: make -C perl test
+
+  clojure:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - if: hashFiles('clojure/Makefile') != ''
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '21'
+      - if: hashFiles('clojure/Makefile') != ''
+        uses: DeLaGuardo/setup-clojure@13
+        with:
+          cli: latest
+      - if: hashFiles('clojure/Makefile') != ''
+        run: make -C clojure test
+
+  elixir:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - if: hashFiles('elixir/Makefile') != ''
+        uses: erlef/setup-beam@v1
+        with:
+          otp-version: '27'
+          elixir-version: '1.17'
+      - if: hashFiles('elixir/Makefile') != ''
+        run: make -C elixir test
+
+  ocaml:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - if: hashFiles('ocaml/Makefile') != ''
+        uses: ocaml/setup-ocaml@v3
+        with:
+          ocaml-compiler: '5.2'
+      - if: hashFiles('ocaml/Makefile') != ''
+        run: make -C ocaml test
+
+  haskell:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - if: hashFiles('haskell/Makefile') != ''
+        uses: haskell-actions/setup@v2
+        with:
+          ghc-version: '9.6'
+      - if: hashFiles('haskell/Makefile') != ''
+        run: make -C haskell test

package/project/standard/.sdk/model/.model-config/model-config.aontu

@@ -5,7 +5,7 @@
 sys: model: action: {
   apidef: load: 'build/apidef.js'
   sdkgen: load: 'build/sdkgen.js'
-  // docgen: load: 'build/docgen.js'
+  # docgen: load: 'build/docgen.js'
 }
 
 sys: model: order: action: 'apidef,sdkgen'

package/project/standard/.sdk/package.json

@@ -3,7 +3,7 @@
   "version": "0.0.1",
   "description": "$$const.Name$$ SDK Project",
   "scripts": {
-    "generate": "tsc --build src && voxgig-model model/sdk.aontu",
+    "generate": "tsc --build src && voxgig-model model/sdk.aontu && voxgig-model test/test.aontu",
     "watch-generate": "voxgig-model -w model/sdk.aontu",
     "dry-generate": "tsc --build src && voxgig-model -y model/sdk.aontu",
     "watch-dry-generate": "voxgig-model -w -y model/sdk.aontu",

package/project/standard/.sdk/test/primary/clean.aontu

@@ -1,2 +1,15 @@
 
-basic: set: []
+# clean(ctx, val): redact sensitive values before they reach a log sink.
+#
+# The masking body is currently commented out in every port, so clean is a
+# PASSTHROUGH — and that is exactly what needs pinning across languages: a
+# port that "helpfully" implements masking early, or that clones/reshapes the
+# value on the way through, diverges from the reference without any test
+# noticing (this fixture was an empty `set: []`).
+
+basic: set: [
+  { mark:10, args: [ {options:{}}, {a:'A'} ], out: {a:'A'} }
+  { mark:20, args: [ {options:{}}, {} ], out: {} }
+  { mark:30, args: [ {options:{}}, 'plain' ], out: 'plain' }
+  { mark:40, args: [ {options:{}}, [1,2] ], out: [1,2] }
+]

package/project/standard/.sdk/test/primary/featureAdd.aontu

@@ -1,2 +1,11 @@
 
+# PENDING — this section is deliberately empty.
+#
+# Requires a constructed feature registry on a client instance.
+#
+# An empty `set` runs ZERO cases. Runners must not treat that as a pass by
+# accident: test/parity.test.ts in @voxgig/sdkgen asserts that every empty
+# fixture carries this PENDING marker, so an accidentally-blanked fixture
+# fails the build while a knowingly-deferred one does not.
+
 basic: set: []

package/project/standard/.sdk/test/primary/featureHook.aontu

@@ -1,2 +1,11 @@
 
+# PENDING — this section is deliberately empty.
+#
+# Requires a constructed feature registry on a client instance.
+#
+# An empty `set` runs ZERO cases. Runners must not treat that as a pass by
+# accident: test/parity.test.ts in @voxgig/sdkgen asserts that every empty
+# fixture carries this PENDING marker, so an accidentally-blanked fixture
+# fails the build while a knowingly-deferred one does not.
+
 basic: set: []

package/project/standard/.sdk/test/primary/featureInit.aontu

@@ -1,2 +1,11 @@
 
+# PENDING — this section is deliberately empty.
+#
+# Requires a constructed feature registry on a client instance.
+#
+# An empty `set` runs ZERO cases. Runners must not treat that as a pass by
+# accident: test/parity.test.ts in @voxgig/sdkgen asserts that every empty
+# fixture carries this PENDING marker, so an accidentally-blanked fixture
+# fails the build while a knowingly-deferred one does not.
+
 basic: set: []

package/project/standard/.sdk/test/primary/fetcher.aontu

@@ -1,2 +1,13 @@
 
+# PENDING — this section is deliberately empty.
+#
+# Needs a live/mocked transport and a client instance; the shared
+# runner has no transport-injection hook yet. Covered per-language by the
+# feature/netsim suites until this fixture can express a transport.
+#
+# An empty `set` runs ZERO cases. Runners must not treat that as a pass by
+# accident: test/parity.test.ts in @voxgig/sdkgen asserts that every empty
+# fixture carries this PENDING marker, so an accidentally-blanked fixture
+# fails the build while a knowingly-deferred one does not.
+
 basic: set: []

package/project/standard/.sdk/test/primary/makeFetchDef.aontu

@@ -1,2 +1,13 @@
 
+# PENDING — this section is deliberately empty.
+#
+# Depends on a fully built ctx (spec + point + options) that the
+# shared runner cannot assemble from a literal; covered by makeSpec/makeUrl
+# upstream and by the per-language pipeline suites.
+#
+# An empty `set` runs ZERO cases. Runners must not treat that as a pass by
+# accident: test/parity.test.ts in @voxgig/sdkgen asserts that every empty
+# fixture carries this PENDING marker, so an accidentally-blanked fixture
+# fails the build while a knowingly-deferred one does not.
+
 basic: set: []

package/project/standard/.sdk/test/primary/makePoint.aontu

@@ -1,2 +1,12 @@
 
+# PENDING — this section is deliberately empty.
+#
+# Requires an op with points plus SDK options.allow.op, i.e. a real
+# client; the runner has no client-construction hook for it yet.
+#
+# An empty `set` runs ZERO cases. Runners must not treat that as a pass by
+# accident: test/parity.test.ts in @voxgig/sdkgen asserts that every empty
+# fixture carries this PENDING marker, so an accidentally-blanked fixture
+# fails the build while a knowingly-deferred one does not.
+
 basic: set: []

package/project/standard/.sdk/test/primary/makeResult.aontu

@@ -1,2 +1,17 @@
 
+# PENDING — this section is deliberately empty.
+#
+# makeResult needs a ctx carrying a constructed Spec AND Result (built via the
+# SDK's own NewSpec/NewResult constructors), plus the error path for each being
+# absent. The shared runner builds a ctx from a literal map and has no
+# constructor hook, so the cases cannot be expressed here yet. Covered
+# per-language today (e.g. go's makeResult-basic / -no-spec / -no-result),
+# which is exactly the drift risk this corpus exists to remove — promoting it
+# needs a runner change, not just fixture data.
+#
+# An empty `set` runs ZERO cases. Runners must not treat that as a pass by
+# accident: test/corpus.test.ts here, and the PENDING lists in the language
+# runners, keep a deliberately-deferred section distinct from an accidentally
+# blanked one.
+
 basic: set: []

package/project/standard/.sdk/test/primary/preparePath.aontu

@@ -1,2 +1,31 @@
 
-basic: set: []
+# preparePath: join ctx.point.parts with '/', dropping empty segments.
+#
+# Path templating is the highest-risk request-shaping step, and this fixture
+# was an empty `set: []` — so every language "passed" it while running zero
+# cases. The cases below were lifted from the per-language hand-written tests
+# (go/py) that had drifted out of the shared corpus, plus the empty/blank
+# segment edges that `join(..., true)` is specifically responsible for.
+
+basic: set: [
+  # Multi-segment path, placeholder left intact (params are substituted later,
+  # by makeUrl — preparePath only assembles the template).
+  { mark:10, ctx: {point:{parts:[api,planet,'{id}'],args:{params:[]}}}, out: 'api/planet/{id}' }
+
+  # Single segment: no separator introduced.
+  { mark:20, ctx: {point:{parts:[items],args:{params:[]}}}, out: 'items' }
+
+  # No parts at all -> empty path (an entity mounted at the prefix root).
+  { mark:30, ctx: {point:{parts:[],args:{params:[]}}}, out: '' }
+
+  # Empty segments are DROPPED, not rendered as '//' — a doubled slash changes
+  # the request URL and 404s on strict routers.
+  { mark:40, ctx: {point:{parts:[a,'',b],args:{params:[]}}}, out: 'a/b' }
+
+  # Leading/trailing blanks likewise collapse.
+  { mark:50, ctx: {point:{parts:['',a,''],args:{params:[]}}}, out: 'a' }
+
+  # Several placeholders in one path.
+  { mark:60, ctx: {point:{parts:[api,'{a}',sub,'{b}'],args:{params:[]}}},
+    out: 'api/{a}/sub/{b}' }
+]

package/project/standard/.sdk/test/test.json

@@ -16633,7 +16633,58 @@
     },
     "clean": {
       "basic": {
-        "set": []
+        "set": [
+          {
+            "args": [
+              {
+                "options": {}
+              },
+              {
+                "a": "A"
+              }
+            ],
+            "mark": 10,
+            "out": {
+              "a": "A"
+            }
+          },
+          {
+            "args": [
+              {
+                "options": {}
+              },
+              {}
+            ],
+            "mark": 20,
+            "out": {}
+          },
+          {
+            "args": [
+              {
+                "options": {}
+              },
+              "plain"
+            ],
+            "mark": 30,
+            "out": "plain"
+          },
+          {
+            "args": [
+              {
+                "options": {}
+              },
+              [
+                1,
+                2
+              ]
+            ],
+            "mark": 40,
+            "out": [
+              1,
+              2
+            ]
+          }
+        ]
       }
     },
     "done": {
@@ -17227,7 +17278,7 @@
               "ctx": {
                 "spec": {
                   "headers": {
-                    "authorization": " APIKEY01"
+                    "authorization": "APIKEY01"
                   }
                 }
               }
@@ -17435,7 +17486,99 @@
     },
     "preparePath": {
       "basic": {
-        "set": []
+        "set": [
+          {
+            "ctx": {
+              "point": {
+                "args": {
+                  "params": []
+                },
+                "parts": [
+                  "api",
+                  "planet",
+                  "{id}"
+                ]
+              }
+            },
+            "mark": 10,
+            "out": "api/planet/{id}"
+          },
+          {
+            "ctx": {
+              "point": {
+                "args": {
+                  "params": []
+                },
+                "parts": [
+                  "items"
+                ]
+              }
+            },
+            "mark": 20,
+            "out": "items"
+          },
+          {
+            "ctx": {
+              "point": {
+                "args": {
+                  "params": []
+                },
+                "parts": []
+              }
+            },
+            "mark": 30,
+            "out": ""
+          },
+          {
+            "ctx": {
+              "point": {
+                "args": {
+                  "params": []
+                },
+                "parts": [
+                  "a",
+                  "",
+                  "b"
+                ]
+              }
+            },
+            "mark": 40,
+            "out": "a/b"
+          },
+          {
+            "ctx": {
+              "point": {
+                "args": {
+                  "params": []
+                },
+                "parts": [
+                  "",
+                  "a",
+                  ""
+                ]
+              }
+            },
+            "mark": 50,
+            "out": "a"
+          },
+          {
+            "ctx": {
+              "point": {
+                "args": {
+                  "params": []
+                },
+                "parts": [
+                  "api",
+                  "{a}",
+                  "sub",
+                  "{b}"
+                ]
+              }
+            },
+            "mark": 60,
+            "out": "api/{a}/sub/{b}"
+          }
+        ]
       }
     },
     "prepareQuery": {

package/src/create-sdkgen.ts

@@ -86,7 +86,12 @@ function CreateSdkGen(opts: FullCreateSdkGenOptions) {
       Path.isAbsolute(spec.folder) ? spec.folder :
         Path.join(cwd, spec.folder)
 
-    logCreate(folder)
+    // A dry run must not touch the filesystem — logCreate() mkdir's
+    // <folder>/.sdk/log and appends to create.log, which created a real
+    // directory tree for a run that is supposed to write nothing.
+    if (!dryrun) {
+      logCreate(folder)
+    }
 
     const jopts = {
       fs: () => fs,
@@ -262,6 +267,30 @@ async function installNpm(spec: GenerateSpec, opts: any, model: any) {
     await runNpm(['install'], spawn_opts)
   }
 
+  // `-t` / `-f` are INDEPENDENT of `--no-install`: the documented contract is
+  // that --no-install skips `npm install`, not that it drops the requested
+  // targets and features. Adding them is still valid without an install when
+  // the project already has its toolchain (re-scaffolding an existing folder
+  // is a supported flow — "if run against an existing folder generated files
+  // will be overwritten").
+  //
+  // They ARE npm run scripts that resolve @voxgig/sdkgen from node_modules, so
+  // without one they cannot work. Fail with an actionable message rather than
+  // the raw module-resolution error — and rather than silently skipping, which
+  // reports success while leaving config.aontu without the requested entries.
+  const wanted = [
+    (spec.target ?? []).length ? '--target' : '',
+    (spec.feature ?? []).length ? '--feature' : '',
+  ].filter(Boolean)
+
+  if (0 < wanted.length && !Fs.existsSync(Path.join(cwd, 'node_modules'))) {
+    throw new Error(
+      `${wanted.join(' / ')} needs the project toolchain, but ` +
+      `${Path.join(cwd, 'node_modules')} does not exist ` +
+      `(--no-install was given). Re-run without --no-install, or run ` +
+      `\`npm install\` then \`npm run add-target\` / \`add-feature\` in ${cwd}.`)
+  }
+
   await installTargets(spec, opts, model, spawn_opts)
   await installFeatures(spec, opts, model, spawn_opts)
 }

package/src/project/standard/CreateRoot.ts

@@ -23,8 +23,9 @@ const GITIGNORE_TOP = `# Local config / secrets
 *.local.*
 *.local
 
-# Dependencies
-node_modules/
+# Dependencies (no trailing slash: also ignores node_modules SYMLINKS, e.g.
+# ts/node_modules -> shared tree, which a dir-only rule leaves tracked)
+node_modules
 
 # Logs
 *.log
@@ -43,8 +44,9 @@ const GITIGNORE_SDK = `# Local config / secrets
 *.local.*
 *.local
 
-# Dependencies
-node_modules/
+# Dependencies (no trailing slash: also ignores node_modules SYMLINKS, e.g.
+# .sdk/node_modules -> shared tree, which a dir-only rule leaves tracked)
+node_modules
 
 # Build output
 dist/
@@ -60,6 +62,55 @@ log/
 `
 
 
+// The guide overlay is the ONE model file the user owns.
+//
+// Everything else the scaffold writes is toolchain-derived and is deliberately
+// OVERWRITTEN (see the `existing.txt.write` rationale in create-sdkgen.ts) so a
+// toolchain fix propagates. `model/guide/guide.aontu` is the exception: apidef
+// unifies it OVER the heuristic classification, and it is where every
+// documented customization lives — entity rename, hide, move, activate,
+// per-path deactivation, method override, param rename, response transform.
+// Copying the stub over it destroyed that work on every re-scaffold, and
+// cedar-regen.sh re-scaffolds on every regen, so the loss was silent and
+// repeated.
+//
+// It is excluded from the bulk Copy and merged instead (see mergeGuide).
+const GUIDE_FILE = 'guide.aontu'
+const GUIDE_REL = ['model', 'guide', GUIDE_FILE]
+
+
+// Merge the guide template into an existing guide overlay.
+//
+// A guide is the template's `@`-includes plus whatever the user added. The
+// includes are the only part the template OWNS, so the merge is: keep the
+// user's file verbatim, and restore any include it is missing. When nothing
+// is missing — the normal case — the file is returned byte-identical, so a
+// re-scaffold is a no-op on it.
+//
+// Missing includes are restored at the TOP, not appended: `base-guide.aontu`
+// carries the heuristic classification that the user's overrides unify over,
+// and the overlay reads correctly only when the includes precede it.
+function mergeGuide(existing: string | null, template: string): string {
+  if (null == existing) {
+    return template
+  }
+
+  const isInclude = (line: string) => line.trim().startsWith('@')
+
+  const have = new Set(existing.split('\n').map((line: string) => line.trim()))
+  const missing = template.split('\n')
+    .filter(isInclude)
+    .map((line: string) => line.trim())
+    .filter((line: string) => !have.has(line))
+
+  if (0 === missing.length) {
+    return existing
+  }
+
+  return missing.join('\n') + '\n\n' + existing
+}
+
+
 // TODO: rename to RootSdk
 const CreateRoot = cmp(function CreateRoot(props: any) {
   const { ctx$, ctx$: { folder }, spec, model } = props
@@ -81,9 +132,14 @@ const CreateRoot = cmp(function CreateRoot(props: any) {
 
     // console.log('FROM', from)
 
+    // Copy `exclude` matches the SOURCE-RELATIVE path exactly, so this names
+    // the one guide under the scaffold and nothing else. It is re-emitted,
+    // merged, in the model folder below.
+    const guideExclude = [spec.sdk_folder, ...GUIDE_REL].join('/')
+
     Copy({
       from,
-      exclude: [/\.fragment\./]
+      exclude: [/\.fragment\./, guideExclude]
     })
 
     File({ name: '.gitignore' }, () => {
@@ -113,6 +169,21 @@ const CreateRoot = cmp(function CreateRoot(props: any) {
 
       Folder({ name: 'model' }, () => {
         ModelSdk({ spec })
+
+        // Re-emit the guide the Copy skipped, merged over whatever is already
+        // there. On a fresh scaffold there is no existing file and this writes
+        // the template unchanged; on a re-scaffold the user's overlay survives.
+        Folder({ name: 'guide' }, () => {
+          const guideTemplate =
+            fs.readFileSync(Path.join(from, spec.sdk_folder, ...GUIDE_REL), 'utf8')
+          const guidePath = Path.join(folder, spec.sdk_folder, ...GUIDE_REL)
+          const existingGuide =
+            fs.existsSync(guidePath) ? fs.readFileSync(guidePath, 'utf8') : null
+
+          File({ name: GUIDE_FILE }, () => {
+            Content(mergeGuide(existingGuide, guideTemplate))
+          })
+        })
       })
     })