@contractkit/plugin-bruno 1.2.0 → 1.4.0

package/coverage/tests/helpers.ts.html

@@ -266,11 +266,11 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">258x</span>
+<span class="cline-any cline-yes">288x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">48x</span>
+<span class="cline-any cline-yes">53x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -298,7 +298,7 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">11x</span>
+<span class="cline-any cline-yes">12x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -310,7 +310,7 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">36x</span>
+<span class="cline-any cline-yes">39x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -322,7 +322,7 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">9x</span>
+<span class="cline-any cline-yes">11x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -332,7 +332,7 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">8x</span>
+<span class="cline-any cline-yes">10x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -355,8 +355,8 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">19x</span>
-<span class="cline-any cline-yes">19x</span>
+<span class="cline-any cline-yes">22x</span>
+<span class="cline-any cline-yes">22x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -384,10 +384,10 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">99x</span>
-<span class="cline-any cline-yes">99x</span>
-<span class="cline-any cline-yes">99x</span>
-<span class="cline-any cline-yes">99x</span>
+<span class="cline-any cline-yes">115x</span>
+<span class="cline-any cline-yes">115x</span>
+<span class="cline-any cline-yes">115x</span>
+<span class="cline-any cline-yes">115x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -402,12 +402,12 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">95x</span>
-<span class="cline-any cline-yes">95x</span>
+<span class="cline-any cline-yes">104x</span>
+<span class="cline-any cline-yes">104x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">92x</span>
+<span class="cline-any cline-yes">101x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import type {
     ContractRootNode,
@@ -589,7 +589,7 @@ export function opRoot(routes: OpRouteNode[], file = 'users.op', meta: Record&lt
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-01T19:55:27.966Z
+                at 2026-05-07T11:09:13.542Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/tests/index.html

@@ -101,7 +101,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-01T19:55:27.966Z
+                at 2026-05-07T11:09:13.542Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/dist/codegen-bruno.d.ts

@@ -1,4 +1,4 @@
-import type { OpRootNode, ContractRootNode } from '@contractkit/core';
+import type { OpRootNode, ContractRootNode, IncrementalManifest, IncrementalResult as IncrementalResultBase } from '@contractkit/core';
 /** A single file produced by the Bruno codegen — a relative output path and its YAML content. */
 export interface OpenCollectionFile {
     relativePath: string;
@@ -6,6 +6,12 @@ export interface OpenCollectionFile {
 }
 /** Manifest filename — tracks which files this plugin previously generated so subsequent runs can clean up only those, leaving any user-added files alone. */
 export declare const MANIFEST_FILENAME = ".contractkit-bruno-manifest.json";
+/**
+ * Bumped whenever the codegen output shape changes in a way that should bust
+ * every per-op fingerprint. Mixed into the per-op fingerprint so a plugin
+ * upgrade forces full regeneration even when source `.ck` files are unchanged.
+ */
+export declare const BRUNO_CODEGEN_VERSION = "1";
 /** Subset of a security scheme sufficient for Bruno auth generation (non-HMAC). */
 export interface BrunoSecurityScheme {
     type: string;
@@ -49,14 +55,46 @@ export interface OpenCollectionOptions {
      */
     environments?: Record<string, Record<string, unknown>>;
 }
+/**
+ * @deprecated Use {@link IncrementalManifest} from `@contractkit/core`. Re-exported here for backwards compatibility.
+ */
+export type BrunoManifest = IncrementalManifest;
+/** Result of {@link generateOpenCollectionIncremental}. Renamed `skippedOpCount` for Bruno-specific clarity but otherwise the shared {@link IncrementalResultBase}. */
+export interface IncrementalResult extends Omit<IncrementalResultBase, 'skippedUnitCount'> {
+    /** Number of ops whose codegen was skipped because their fingerprint matched. */
+    skippedOpCount: number;
+}
 /**
  * Generates an OpenCollection (https://spec.opencollection.com/) API collection
  * from a set of operation roots. Produces opencollection.yml, an environment
  * file, and one .yml request file per operation.
+ *
+ * This is the full-regeneration entry point — every file is rebuilt from scratch.
+ * For cache-aware incremental builds, use {@link generateOpenCollectionIncremental}.
  */
 export declare function generateOpenCollection(roots: OpRootNode[], options: OpenCollectionOptions): OpenCollectionFile[];
-/** Parse a previously-written manifest. Returns the list of relative paths to clean up. Returns [] if missing or unreadable so a stale/garbled manifest never blocks regeneration. */
-export declare function parseManifest(content: string): string[];
+/**
+ * Cache-aware variant of {@link generateOpenCollection}. Skips re-rendering YAML
+ * for any op whose fingerprint matches the entry in `prevManifest`. The caller is
+ * responsible for emitting `filesToWrite`, deleting `deletedPaths`, and persisting
+ * `manifest` so the next run can match against it.
+ *
+ * Global files (collection root, env files, folder.yml) are always regenerated —
+ * they're cheap and depend on options the manifest doesn't fingerprint.
+ */
+export declare function generateOpenCollectionIncremental(roots: OpRootNode[], options: OpenCollectionOptions, prevManifest: IncrementalManifest, fileExists?: (relativePath: string) => boolean): IncrementalResult;
+/** Empty-state manifest, used when none has been written yet (or when the cache is being bypassed). */
+export declare function emptyManifest(): IncrementalManifest;
+/**
+ * Parse a previously-written manifest. Accepts both v1 (`{ files: string[] }`) and v2
+ * (full {@link IncrementalManifest}) shapes. v1 manifests are returned with an empty
+ * `units` map so the next run treats every op as a cache miss while still cleaning up
+ * the tracked file list.
+ *
+ * Returns an empty manifest on any parse error so a stale/garbled file never blocks
+ * regeneration.
+ */
+export declare function parseManifest(content: string): IncrementalManifest;
 /**
  * Deep-merges a YAML override string into a generated YAML string.
  *

package/dist/codegen-bruno.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codegen-bruno.d.ts","sourceRoot":"","sources":["../src/codegen-bruno.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,UAAU,EAMV,gBAAgB,EAGnB,MAAM,mBAAmB,CAAC;AAK3B,iGAAiG;AACjG,MAAM,WAAW,kBAAkB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,8JAA8J;AAC9J,eAAO,MAAM,iBAAiB,qCAAqC,CAAC;AAEpE,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACf;AAED,kHAAkH;AAClH,MAAM,WAAW,gBAAgB;IAC7B,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CACjD;AAED,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,qBAAqB,GAAG,kBAAkB,EAAE,CAuEhH;AAED,sLAAsL;AACtL,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAUvD;AAsBD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAOxF;AA2cD,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASjD"}
+{"version":3,"file":"codegen-bruno.d.ts","sourceRoot":"","sources":["../src/codegen-bruno.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,UAAU,EAMV,gBAAgB,EAGhB,mBAAmB,EAEnB,iBAAiB,IAAI,qBAAqB,EAC7C,MAAM,mBAAmB,CAAC;AAe3B,iGAAiG;AACjG,MAAM,WAAW,kBAAkB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,8JAA8J;AAC9J,eAAO,MAAM,iBAAiB,qCAAqC,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACf;AAED,kHAAkH;AAClH,MAAM,WAAW,gBAAgB;IAC7B,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CACjD;AAED,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1D;AAiBD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,mBAAmB,CAAC;AAEhD,uKAAuK;AACvK,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,qBAAqB,EAAE,kBAAkB,CAAC;IACtF,iFAAiF;IACjF,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,qBAAqB,GAAG,kBAAkB,EAAE,CAGhH;AAED;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAC7C,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,EAAE,qBAAqB,EAC9B,YAAY,EAAE,mBAAmB,EACjC,UAAU,GAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAoB,GAC3D,iBAAiB,CAiEnB;AAkHD,uGAAuG;AACvG,wBAAgB,aAAa,IAAI,mBAAmB,CAEnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAmBlE;AAsBD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAOxF;AA2cD,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASjD"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import type { BrunoSecurityScheme } from './codegen-bruno.js';
-import type { ContractKitPlugin } from '@contractkit/core';
+import type { ContractKitPlugin, PluginValue } from '@contractkit/core';
 /** Configuration accepted by the Bruno plugin, both via `contractkit.config.json` and `createBrunoPlugin`. */
 export interface BrunoPluginConfig {
     baseDir?: string;
@@ -33,6 +33,15 @@ export interface BrunoPluginOptions extends BrunoPluginConfig {
         schemes?: Record<string, BrunoSecurityScheme>;
     };
 }
+/**
+ * Validates a `plugins.bruno` extension entry on an operation. The expected shape is
+ * `{ template?: string }`, where `template` is a YAML fragment to deep-merge into the
+ * generated request file (typically a `file://...` URL whose contents have already
+ * been loaded by the CLI resolver).
+ */
+export declare function validateBrunoExtension(value: PluginValue): {
+    errors?: string[];
+} | void;
 declare const plugin: ContractKitPlugin;
 export default plugin;
 /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,8GAA8G;AAC9G,MAAM,WAAW,iBAAiB;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1D;AAED,mHAAmH;AACnH,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IACzD,IAAI,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;KAAE,CAAC;CACnF;AAID,QAAA,MAAM,MAAM,EAAE,iBAuBb,CAAC;AAEF,eAAe,MAAM,CAAC;AAItB;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;CAAE,GAChF,iBAAiB,CAwBnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAiB,WAAW,EAAqD,MAAM,mBAAmB,CAAC;AAE1I,8GAA8G;AAC9G,MAAM,WAAW,iBAAiB;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1D;AAED,mHAAmH;AACnH,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IACzD,IAAI,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;KAAE,CAAC;CACnF;AAID;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAavF;AAQD,QAAA,MAAM,MAAM,EAAE,iBAOb,CAAC;AAEF,eAAe,MAAM,CAAC;AAItB;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;CAAE,GAChF,iBAAiB,CAUnB"}

package/dist/index.js

@@ -6,23 +6,24 @@ import { resolve, basename as basename2, dirname } from "path";
 import { existsSync, readFileSync, rmSync, readdirSync, rmdirSync } from "fs";
 
 // src/codegen-bruno.ts
-import { resolveSecurity, resolveModifiers, SECURITY_NONE } from "@contractkit/core";
+import { resolveSecurity, resolveModifiers, SECURITY_NONE, collectTransitiveModelRefs, runIncrementalCodegen, parseIncrementalManifest, emptyIncrementalManifest, hashFingerprint, INCREMENTAL_MANIFEST_VERSION } from "@contractkit/core";
 import { basename } from "path";
 import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
 var MANIFEST_FILENAME = ".contractkit-bruno-manifest.json";
-function generateOpenCollection(roots, options) {
-  const files = [];
+var BRUNO_CODEGEN_VERSION = "1";
+function generateOpenCollectionIncremental(roots, options, prevManifest, fileExists = () => true) {
   const modelMap = buildModelMap(options.contractRoots ?? []);
   const authOpts = options.auth;
   const defaultScheme = authOpts?.defaultScheme ? authOpts.schemes?.[authOpts.defaultScheme] : void 0;
   const randomExamples = options.randomExamples ?? false;
   const includeInternal = options.includeInternal ?? true;
-  files.push({
+  const globalFiles = [];
+  globalFiles.push({
     relativePath: "opencollection.yml",
     content: generateCollectionRoot(options.collectionName, defaultScheme)
   });
   for (const envFile of generateEnvFiles(options.environments, defaultScheme)) {
-    files.push(envFile);
+    globalFiles.push(envFile);
   }
   const sortedRoots = [
     ...roots
@@ -33,11 +34,12 @@ function generateOpenCollection(roots, options) {
     if (cmp !== 0) return cmp;
     return (a.meta["subarea"] ?? "").localeCompare(b.meta["subarea"] ?? "");
   });
+  const units = [];
   for (let rootIdx = 0; rootIdx < sortedRoots.length; rootIdx++) {
     const root = sortedRoots[rootIdx];
     const folder = root.meta["area"] ? slugifyName(root.meta["area"]) : deriveFolderName(root.file);
     const displayName = (root.meta["area"] ?? folder).charAt(0).toUpperCase() + (root.meta["area"] ?? folder).slice(1);
-    files.push({
+    globalFiles.push({
       relativePath: `${folder}/folder.yml`,
       content: generateFolderFile(displayName, rootIdx + 1)
     });
@@ -46,60 +48,164 @@ function generateOpenCollection(roots, options) {
     const requestDir = subareaSlug ? `${folder}/${subareaSlug}` : folder;
     if (subareaSlug) {
       const subareaDisplayName = subarea.charAt(0).toUpperCase() + subarea.slice(1);
-      files.push({
+      globalFiles.push({
         relativePath: `${requestDir}/folder.yml`,
         content: generateFolderFile(subareaDisplayName, 1)
       });
     }
-    const requests = [];
-    for (const route of root.routes) {
-      for (const op of route.operations) {
-        if (!includeInternal && resolveModifiers(route, op).includes("internal")) continue;
-        requests.push({
-          route,
-          op,
-          requestName: op.name ?? route.path
-        });
-      }
+    for (const entry of buildOpEntries(root, requestDir, includeInternal)) {
+      units.push({
+        key: entry.opKey,
+        fingerprint: computeOpFingerprint(entry, modelMap, defaultScheme, randomExamples),
+        render: /* @__PURE__ */ __name(() => [
+          renderOpFile(entry, modelMap, defaultScheme, randomExamples)
+        ], "render")
+      });
     }
-    requests.sort((a, b) => a.requestName.localeCompare(b.requestName));
-    let seq = 1;
-    for (const { route, op, requestName } of requests) {
-      const fileName = op.name ? `${slugifyName(op.name)}.yml` : `${op.method}-${sanitizePath(route.path)}.yml`;
-      let content = generateRequestFile(route, op, requestName, seq, modelMap, root, defaultScheme, randomExamples);
-      const pluginOverride = op.pluginFiles?.["bruno"];
-      if (pluginOverride !== void 0) {
-        content = mergePluginFile(content, pluginOverride);
-      }
-      files.push({
-        relativePath: `${requestDir}/${fileName}`,
-        content
+  }
+  const result = runIncrementalCodegen({
+    codegenVersion: BRUNO_CODEGEN_VERSION,
+    manifestFilename: MANIFEST_FILENAME,
+    prevManifest,
+    globalFiles,
+    units,
+    fileExists
+  });
+  return {
+    filesToWrite: result.filesToWrite,
+    manifest: result.manifest,
+    deletedPaths: result.deletedPaths,
+    skippedOpCount: result.skippedUnitCount
+  };
+}
+__name(generateOpenCollectionIncremental, "generateOpenCollectionIncremental");
+function buildOpEntries(root, requestDir, includeInternal) {
+  const requests = [];
+  for (const route of root.routes) {
+    for (const op of route.operations) {
+      if (!includeInternal && resolveModifiers(route, op).includes("internal")) continue;
+      requests.push({
+        route,
+        op,
+        requestName: op.name ?? route.path
       });
-      seq++;
     }
   }
-  const trackedPaths = [
-    ...files.map((f) => f.relativePath),
-    MANIFEST_FILENAME
-  ].sort();
-  files.push({
-    relativePath: MANIFEST_FILENAME,
-    content: JSON.stringify({
-      files: trackedPaths
-    }, null, 2) + "\n"
+  requests.sort((a, b) => a.requestName.localeCompare(b.requestName));
+  const entries = [];
+  let seq = 1;
+  for (const { route, op, requestName } of requests) {
+    const fileName = op.name ? `${slugifyName(op.name)}.yml` : `${op.method}-${sanitizePath(route.path)}.yml`;
+    entries.push({
+      opKey: `${root.file}::${op.method.toUpperCase()} ${route.path}`,
+      relativePath: `${requestDir}/${fileName}`,
+      requestName,
+      seq,
+      route,
+      op,
+      root
+    });
+    seq++;
+  }
+  return entries;
+}
+__name(buildOpEntries, "buildOpEntries");
+function renderOpFile(entry, modelMap, defaultScheme, randomExamples) {
+  let content = generateRequestFile(entry.route, entry.op, entry.requestName, entry.seq, modelMap, entry.root, defaultScheme, randomExamples);
+  const brunoExt = entry.op.pluginExtensions?.["bruno"];
+  const pluginOverride = brunoExt && typeof brunoExt === "object" && !Array.isArray(brunoExt) ? brunoExt["template"] : void 0;
+  if (typeof pluginOverride === "string") {
+    content = mergePluginFile(content, pluginOverride);
+  }
+  return {
+    relativePath: entry.relativePath,
+    content
+  };
+}
+__name(renderOpFile, "renderOpFile");
+function computeOpFingerprint(entry, modelMap, defaultScheme, randomExamples) {
+  const referencedModels = collectTransitiveModelRefs(collectOpTypeNodes(entry.route, entry.op), modelMap);
+  const modelSnapshot = {};
+  for (const name of [
+    ...referencedModels
+  ].sort()) {
+    const m = modelMap.get(name);
+    if (m) modelSnapshot[name] = m;
+  }
+  const routeShape = {
+    path: entry.route.path,
+    params: entry.route.params ?? null,
+    modifiers: entry.route.modifiers ?? null,
+    security: entry.route.security ?? null,
+    description: entry.route.description ?? null
+  };
+  return hashFingerprint({
+    v: BRUNO_CODEGEN_VERSION,
+    opKey: entry.opKey,
+    relativePath: entry.relativePath,
+    requestName: entry.requestName,
+    seq: entry.seq,
+    route: routeShape,
+    op: entry.op,
+    rootMeta: entry.root.meta,
+    rootFile: entry.root.file,
+    defaultScheme: defaultScheme ?? null,
+    randomExamples,
+    models: modelSnapshot
   });
-  return files;
 }
-__name(generateOpenCollection, "generateOpenCollection");
+__name(computeOpFingerprint, "computeOpFingerprint");
+function collectOpTypeNodes(route, op) {
+  const out = [];
+  pushFromParamSource(route.params, out);
+  pushFromParamSource(op.query, out);
+  pushFromParamSource(op.headers, out);
+  if (op.request) {
+    for (const body of op.request.bodies) out.push(body.bodyType);
+  }
+  for (const resp of op.responses) {
+    if (resp.bodyType) out.push(resp.bodyType);
+    if (resp.headers) {
+      for (const h of resp.headers) out.push(h.type);
+    }
+  }
+  return out;
+}
+__name(collectOpTypeNodes, "collectOpTypeNodes");
+function pushFromParamSource(src, out) {
+  if (!src) return;
+  if (src.kind === "params") {
+    for (const n of src.nodes) out.push(n.type);
+  } else if (src.kind === "ref") {
+    out.push({
+      kind: "ref",
+      name: src.name
+    });
+  } else if (src.kind === "type") {
+    out.push(src.node);
+  }
+}
+__name(pushFromParamSource, "pushFromParamSource");
+function emptyManifest() {
+  return emptyIncrementalManifest(BRUNO_CODEGEN_VERSION);
+}
+__name(emptyManifest, "emptyManifest");
 function parseManifest(content) {
+  const parsed = parseIncrementalManifest(content);
+  if (parsed.files.length > 0 || Object.keys(parsed.units).length > 0) return parsed;
   try {
-    const parsed = JSON.parse(content);
-    if (Array.isArray(parsed?.files) && parsed.files.every((f) => typeof f === "string")) {
-      return parsed.files;
+    const raw = JSON.parse(content);
+    if (Array.isArray(raw?.files) && raw.files.every((f) => typeof f === "string")) {
+      return {
+        version: INCREMENTAL_MANIFEST_VERSION,
+        codegenVersion: "",
+        files: raw.files,
+        units: {}
+      };
     }
   } catch {
   }
-  return [];
+  return emptyManifest();
 }
 __name(parseManifest, "parseManifest");
 function deepMerge(base, override) {
@@ -610,64 +716,88 @@ function yamlString(value) {
 __name(yamlString, "yamlString");
 
 // src/index.ts
+function validateBrunoExtension(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    return {
+      errors: [
+        `expected an object, got ${describe(value)}`
+      ]
+    };
+  }
+  const errors = [];
+  for (const [key, val] of Object.entries(value)) {
+    if (key === "template") {
+      if (typeof val !== "string") errors.push(`'template' must be a string, got ${describe(val)}`);
+    } else {
+      errors.push(`unknown field '${key}' (allowed: template)`);
+    }
+  }
+  return errors.length ? {
+    errors
+  } : void 0;
+}
+__name(validateBrunoExtension, "validateBrunoExtension");
+function describe(value) {
+  if (value === null) return "null";
+  if (Array.isArray(value)) return "array";
+  return typeof value;
+}
+__name(describe, "describe");
 var plugin = {
   name: "bruno",
-  cacheKey: "bruno",
+  validateExtension: validateBrunoExtension,
   async generateTargets({ opRoots, contractRoots }, ctx) {
     const { auth, ...config } = ctx.options;
-    const base = config.baseDir ? resolve(ctx.rootDir, config.baseDir) : ctx.rootDir;
-    const outDir = resolve(base, config.output ?? "bruno-collection");
-    const collectionName = config.collectionName ?? basename2(ctx.rootDir);
-    cleanupTrackedFiles(outDir);
-    const files = generateOpenCollection(opRoots, {
-      collectionName,
-      contractRoots,
-      auth,
-      randomExamples: config.randomExamples ?? true,
-      includeInternal: config.includeInternal,
-      environments: config.environments
-    });
-    for (const { relativePath, content } of files) {
-      ctx.emitFile(resolve(outDir, relativePath), content);
-    }
+    await runBrunoCodegen(opRoots, contractRoots, ctx, config, auth);
   }
 };
 var index_default = plugin;
 function createBrunoPlugin(config, rootDir, auth) {
   return {
     name: "bruno",
-    cacheKey: `bruno:${JSON.stringify(config)}`,
+    validateExtension: validateBrunoExtension,
     async generateTargets({ opRoots, contractRoots }, ctx) {
-      const base = config.baseDir ? resolve(rootDir, config.baseDir) : rootDir;
-      const outDir = resolve(base, config.output ?? "bruno-collection");
-      const collectionName = config.collectionName ?? basename2(rootDir);
-      cleanupTrackedFiles(outDir);
-      const files = generateOpenCollection(opRoots, {
-        collectionName,
-        contractRoots,
-        auth,
-        randomExamples: config.randomExamples ?? true,
-        includeInternal: config.includeInternal,
-        environments: config.environments
-      });
-      for (const { relativePath, content } of files) {
-        ctx.emitFile(resolve(outDir, relativePath), content);
-      }
+      await runBrunoCodegen(opRoots, contractRoots, {
+        ...ctx,
+        rootDir
+      }, config, auth);
     }
   };
 }
 __name(createBrunoPlugin, "createBrunoPlugin");
-function cleanupTrackedFiles(outDir) {
+async function runBrunoCodegen(opRoots, contractRoots, ctx, config, auth) {
+  const base = config.baseDir ? resolve(ctx.rootDir, config.baseDir) : ctx.rootDir;
+  const outDir = resolve(base, config.output ?? "bruno-collection");
+  const collectionName = config.collectionName ?? basename2(ctx.rootDir);
+  const prevManifest = ctx.cacheEnabled ? readManifest(outDir) : emptyManifest();
+  const result = generateOpenCollectionIncremental(opRoots, {
+    collectionName,
+    contractRoots,
+    auth,
+    randomExamples: config.randomExamples ?? true,
+    includeInternal: config.includeInternal,
+    environments: config.environments
+  }, prevManifest, (relPath) => existsSync(resolve(outDir, relPath)));
+  deleteStalePaths(outDir, result.deletedPaths);
+  for (const { relativePath, content } of result.filesToWrite) {
+    ctx.emitFile(resolve(outDir, relativePath), content);
+  }
+}
+__name(runBrunoCodegen, "runBrunoCodegen");
+function readManifest(outDir) {
   const manifestPath = resolve(outDir, MANIFEST_FILENAME);
-  if (!existsSync(manifestPath)) return;
-  let tracked;
+  if (!existsSync(manifestPath)) return emptyManifest();
   try {
-    tracked = parseManifest(readFileSync(manifestPath, "utf-8"));
+    return parseManifest(readFileSync(manifestPath, "utf-8"));
   } catch {
-    return;
+    return emptyManifest();
   }
+}
+__name(readManifest, "readManifest");
+function deleteStalePaths(outDir, relPaths) {
+  if (relPaths.length === 0) return;
   const removedDirs = /* @__PURE__ */ new Set();
-  for (const rel of tracked) {
+  for (const rel of relPaths) {
     const abs = resolve(outDir, rel);
     if (existsSync(abs)) {
       rmSync(abs, {
@@ -692,9 +822,10 @@ function cleanupTrackedFiles(outDir) {
     }
   }
 }
-__name(cleanupTrackedFiles, "cleanupTrackedFiles");
+__name(deleteStalePaths, "deleteStalePaths");
 export {
   createBrunoPlugin,
-  index_default as default
+  index_default as default,
+  validateBrunoExtension
 };
 //# sourceMappingURL=index.js.map