@cat-factory/contracts 0.107.0 → 0.108.0

package/dist/environment-analyst-merge.d.ts

@@ -0,0 +1,61 @@
+import type { AnalystCitation, AnalystRecipeDraft, AnalystRecipeNote } from './environment-analyst.js';
+import type { ProvisioningDetectionConfidence, ProvisioningRecommendation } from './environments.js';
+import type { StackRecipe } from './stack-recipes.js';
+/** The top-level {@link StackRecipe} fields the merge tracks provenance for, in display order. */
+export declare const MERGEABLE_RECIPE_FIELDS: readonly ["composeFiles", "composeProfiles", "envFiles", "externalNetworks", "sharedStackRefs", "prerequisites", "setupSteps", "healthGate", "teardownSteps"];
+/** A {@link StackRecipe} field whose value + provenance the merge resolves. */
+export type MergeableRecipeField = (typeof MERGEABLE_RECIPE_FIELDS)[number];
+/**
+ * Which source supplied the value that landed in the merged recipe for a field:
+ * - `detector` — only the deterministic detector produced it (authoritative).
+ * - `analyst`  — only the analyst produced it (a draft the human edits/confirms).
+ * - `both`     — both produced it and the DETECTOR's value won (the analyst's is surfaced as a
+ *   dissenting note via {@link MergedRecipeDraft.analystNotes}, not applied).
+ */
+export type RecipeFieldOrigin = 'detector' | 'analyst' | 'both';
+/**
+ * Provenance for one populated recipe field. Carries the WINNING source's rationale: the detector
+ * confidence + note when a detected fact won (`detector`/`both`), or the analyst rationale +
+ * citations when the analyst's draft won (`analyst`). The wizard renders this as the per-field
+ * confidence / "suggested by analysis of …" chip.
+ */
+export interface MergedRecipeField {
+    /** The recipe field this entry describes. */
+    field: MergeableRecipeField;
+    /** Which source's value landed in the merged recipe. */
+    origin: RecipeFieldOrigin;
+    /** Detector confidence, present when a detected fact won (`origin` `detector`/`both`). */
+    confidence?: ProvisioningDetectionConfidence;
+    /** The detector's rationale message, present when a detected fact won. */
+    detectorMessage?: string;
+    /** The analyst's rationale, present when the analyst's draft won (`origin` `analyst`). */
+    analystRationale?: string;
+    /** Analyst source citations backing the field, present when the analyst's draft won. */
+    citations?: AnalystCitation[];
+}
+/**
+ * The merged, reviewable recipe: the detector-wins {@link StackRecipe} plus per-field provenance,
+ * the analyst's summary + verbatim notes (so the wizard can render granular per-step provenance
+ * such as `setupSteps[2]`), and whether the analyst contributed anything at all.
+ */
+export interface MergedRecipeDraft {
+    /** The merged recipe (detector facts win on overlap; analyst-only fields fill the gaps). */
+    recipe: StackRecipe;
+    /** Provenance for each populated recipe field, in {@link MERGEABLE_RECIPE_FIELDS} order. */
+    fields: MergedRecipeField[];
+    /** The analyst's one-paragraph environment summary, when it ran and returned one. */
+    summary?: string;
+    /** Every analyst note verbatim (for per-step provenance the field-level view can't hold). */
+    analystNotes: AnalystRecipeNote[];
+    /** True when an analyst draft contributed a recipe field, a note, or a summary. */
+    hasAnalystInput: boolean;
+}
+/**
+ * Merge a deterministic {@link ProvisioningRecommendation} with an opt-in
+ * {@link AnalystRecipeDraft} into a single {@link MergedRecipeDraft}: detector facts win where
+ * both produce a field, analyst-only fields fill the gaps, and every populated field carries the
+ * winning source's provenance. `draft` absent (the analyst never ran) ⇒ the detector's recipe
+ * verbatim with detector provenance and no analyst input.
+ */
+export declare function mergeAnalystRecipeDraft(recommendation: ProvisioningRecommendation, draft?: AnalystRecipeDraft): MergedRecipeDraft;
+//# sourceMappingURL=environment-analyst-merge.d.ts.map

package/dist/environment-analyst-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-analyst-merge.d.ts","sourceRoot":"","sources":["../src/environment-analyst-merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EACV,+BAA+B,EAE/B,0BAA0B,EAC3B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAwBrD,kGAAkG;AAClG,eAAO,MAAM,uBAAuB,+JAUe,CAAA;AAEnD,+EAA+E;AAC/E,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE3E;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAA;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,KAAK,EAAE,oBAAoB,CAAA;IAC3B,wDAAwD;IACxD,MAAM,EAAE,iBAAiB,CAAA;IACzB,0FAA0F;IAC1F,UAAU,CAAC,EAAE,+BAA+B,CAAA;IAC5C,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,0FAA0F;IAC1F,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,wFAAwF;IACxF,SAAS,CAAC,EAAE,eAAe,EAAE,CAAA;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,4FAA4F;IAC5F,MAAM,EAAE,WAAW,CAAA;IACnB,4FAA4F;IAC5F,MAAM,EAAE,iBAAiB,EAAE,CAAA;IAC3B,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6FAA6F;IAC7F,YAAY,EAAE,iBAAiB,EAAE,CAAA;IACjC,mFAAmF;IACnF,eAAe,EAAE,OAAO,CAAA;CACzB;AA+DD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,0BAA0B,EAC1C,KAAK,CAAC,EAAE,kBAAkB,GACzB,iBAAiB,CAgEnB"}

package/dist/environment-analyst-merge.js

@@ -0,0 +1,152 @@
+// ---------------------------------------------------------------------------
+// ANALYST DRAFT MERGE — combine the DETERMINISTIC provisioning recommendation
+// (`provisioningRecommendationSchema`, read checkout-free by the detector) with the opt-in
+// environment analyst's `AnalystRecipeDraft` (the LLM's read of the imperative bring-up) into a
+// single reviewable recipe, per field, WITH PROVENANCE. This is the "review recipe" input for
+// the setup wizard (slice 7 of docs/initiatives/stack-recipes-and-shared-stacks.md).
+//
+// The rule the initiative fixes (see `environment-analyst.ts`): **deterministic detector facts
+// WIN where both produce a field; analyst-only fields fill the gaps, editable + flagged with the
+// analyst's rationale/citations.** The detector is authoritative because it read the actual
+// compose truth; the analyst only translates the imperative parts a scan can't see (setup steps,
+// health gate, prerequisites) — so it never overrides a mechanically-detected fact, it only adds
+// what the detector couldn't know.
+//
+// PURE + no IO (both inputs are already-parsed contract types), so it lives in @cat-factory/contracts
+// beside the types it merges and is directly consumable by BOTH the SPA wizard (client-side, no
+// extra endpoint) and any backend caller — the same shared-pure-helper shape as
+// `resolveFrontendBindings` / `buildFrontendRunNotes`. The output is a view model, not a wire type:
+// nothing here crosses a boundary, and on save the wizard persists only the resulting `StackRecipe`
+// (re-validated against the STRICT `stackRecipeSchema`) onto the service frame.
+// ---------------------------------------------------------------------------
+/** The top-level {@link StackRecipe} fields the merge tracks provenance for, in display order. */
+export const MERGEABLE_RECIPE_FIELDS = [
+    'composeFiles',
+    'composeProfiles',
+    'envFiles',
+    'externalNetworks',
+    'sharedStackRefs',
+    'prerequisites',
+    'setupSteps',
+    'healthGate',
+    'teardownSteps',
+];
+/** A produced field = a defined non-array value, or a non-empty array (an empty array is "not produced"). */
+function isProduced(value) {
+    if (value === undefined || value === null)
+        return false;
+    if (Array.isArray(value))
+        return value.length > 0;
+    return true;
+}
+/**
+ * The base field name a note targets, stripping any index/path suffix so a per-step analyst note
+ * (`setupSteps[2]`, `healthGate.url`) still maps to the top-level field it explains.
+ */
+function baseNoteField(field) {
+    const trimmed = field.trim();
+    let end = trimmed.length;
+    const bracket = trimmed.indexOf('[');
+    if (bracket >= 0 && bracket < end)
+        end = bracket;
+    const dot = trimmed.indexOf('.');
+    if (dot >= 0 && dot < end)
+        end = dot;
+    return trimmed.slice(0, end);
+}
+/** The detector note for a field (exact `field` match), if any. */
+function detectorNoteFor(notes, field) {
+    return notes.find((note) => note.field === field);
+}
+/**
+ * Deep-clone a JSON-shaped contract value (recipe fields + analyst notes are pure data — strings,
+ * numbers, arrays, plain objects, no Date/Map/class instances). Used so the merged view model
+ * shares NO mutable reference with the caller's recommendation/draft: the wizard edits the merged
+ * recipe/notes in place, and an in-place edit must never reach back and mutate the deterministic
+ * detector fact or the non-binding draft. (A `structuredClone` global isn't typed in this pure,
+ * browser-shared package's `ES2022` lib, so this stays dependency-free.)
+ */
+function cloneData(value) {
+    if (Array.isArray(value))
+        return value.map((item) => cloneData(item));
+    if (value !== null && typeof value === 'object') {
+        const out = {};
+        for (const [key, nested] of Object.entries(value))
+            out[key] = cloneData(nested);
+        return out;
+    }
+    return value;
+}
+/**
+ * The analyst note for a field: an exact `field` match wins over an indexed/path-suffixed one
+ * (e.g. `setupSteps` is preferred over `setupSteps[0]` for the field-level chip).
+ */
+function analystNoteFor(notes, field) {
+    return (notes.find((note) => note.field.trim() === field) ??
+        notes.find((note) => baseNoteField(note.field) === field));
+}
+/**
+ * Merge a deterministic {@link ProvisioningRecommendation} with an opt-in
+ * {@link AnalystRecipeDraft} into a single {@link MergedRecipeDraft}: detector facts win where
+ * both produce a field, analyst-only fields fill the gaps, and every populated field carries the
+ * winning source's provenance. `draft` absent (the analyst never ran) ⇒ the detector's recipe
+ * verbatim with detector provenance and no analyst input.
+ */
+export function mergeAnalystRecipeDraft(recommendation, draft) {
+    const detectorRecipe = recommendation.provisioning.recipe;
+    const analystRecipe = draft?.recipe;
+    // Clone the analyst notes up front so the returned view model shares no mutable reference with
+    // the caller's `draft` — the wizard edits this recipe/notes in place, and an in-place edit must
+    // never reach back and mutate the deterministic detector fact or the non-binding draft.
+    const analystNotes = draft?.notes ? cloneData(draft.notes) : [];
+    const recipe = {};
+    const fields = [];
+    for (const field of MERGEABLE_RECIPE_FIELDS) {
+        const detectorValue = detectorRecipe?.[field];
+        const analystValue = analystRecipe?.[field];
+        const detectorHas = isProduced(detectorValue);
+        const analystHas = isProduced(analystValue);
+        if (detectorHas) {
+            // The detector read the compose truth — its fact wins even if the analyst also proposed one.
+            // Clone the value so an edit to the merged recipe can't mutate the source recommendation.
+            Object.assign(recipe, { [field]: cloneData(detectorValue) });
+            const note = detectorNoteFor(recommendation.notes, field);
+            fields.push({
+                field,
+                origin: analystHas ? 'both' : 'detector',
+                ...(note ? { confidence: note.confidence, detectorMessage: note.message } : {}),
+            });
+        }
+        else if (analystHas) {
+            // Analyst-only field (setup steps, health gate, prerequisites the detector can't see).
+            // Clone the value so an edit to the merged recipe can't mutate the source draft.
+            Object.assign(recipe, { [field]: cloneData(analystValue) });
+            const note = analystNoteFor(analystNotes, field);
+            fields.push({
+                field,
+                origin: 'analyst',
+                ...(note
+                    ? {
+                        analystRationale: note.rationale,
+                        ...(note.citations ? { citations: note.citations } : {}),
+                    }
+                    : {}),
+            });
+        }
+    }
+    const summary = draft?.summary;
+    // A blank summary (absent, empty, or whitespace-only — the lenient draft schema doesn't trim)
+    // is "no summary": it neither counts as analyst input nor rides along in the output, so the
+    // `summary` presence and `hasAnalystInput` signals can't disagree for the same draft.
+    const hasSummary = summary !== undefined && summary.trim() !== '';
+    const analystContributedRecipe = MERGEABLE_RECIPE_FIELDS.some((field) => isProduced(analystRecipe?.[field]));
+    const hasAnalystInput = Boolean(draft && (analystContributedRecipe || analystNotes.length > 0 || hasSummary));
+    return {
+        recipe,
+        fields,
+        ...(hasSummary ? { summary } : {}),
+        analystNotes,
+        hasAnalystInput,
+    };
+}
+//# sourceMappingURL=environment-analyst-merge.js.map

package/dist/environment-analyst-merge.js.map

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

package/dist/errors.d.ts

@@ -8,6 +8,6 @@
  * type for `ConflictError`, and the SPA keys an exhaustive `Record<ConflictReason, …>` of
  * localized titles off it — adding a value without a title trips the frontend typecheck.
  */
-export declare const CONFLICT_REASONS: readonly ['providers_unconfigured', 'preset_unsatisfiable', 'dependencies_unmet', 'task_limit_reached', 'tester_infra_unsupported', 'binary_storage_unconfigured', 'agent_backend_unconfigured', 'run_not_retryable', 'no_pr_to_merge', 'github_not_connected', 'bootstrap_not_retryable', 'bootstrap_reference_missing', 'provision_type_unhandled', 'visual_pipeline_no_frontend'];
+export declare const CONFLICT_REASONS: readonly ['providers_unconfigured', 'preset_unsatisfiable', 'dependencies_unmet', 'task_limit_reached', 'tester_infra_unsupported', 'binary_storage_unconfigured', 'agent_backend_unconfigured', 'run_not_retryable', 'no_pr_to_merge', 'github_not_connected', 'bootstrap_not_retryable', 'bootstrap_reference_missing', 'provision_type_unhandled', 'visual_pipeline_no_frontend', 'deployer_required_before_tester'];
 export type ConflictReason = (typeof CONFLICT_REASONS)[number];
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,YAC3B,wBAAwB,EAKxB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,6BAA6B,EAC7B,4BAA4B,EAC5B,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,6BAA6B,EAG7B,0BAA0B,EAG1B,6BAA6B,CACrB,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,YAC3B,wBAAwB,EAKxB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,6BAA6B,EAC7B,4BAA4B,EAC5B,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,6BAA6B,EAG7B,0BAA0B,EAG1B,6BAA6B,EAI7B,iCAAiC,CACzB,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA"}

package/dist/errors.js

@@ -32,5 +32,9 @@ export const CONFLICT_REASONS = [
     // A pipeline with visual steps (`tester-ui` / `visual-confirmation`) was started on a frame
     // with no UI to exercise — neither a `frontend` frame nor a frame a frontend links to.
     'visual_pipeline_no_frontend',
+    // A `kubernetes`/`custom` service's pipeline reaches a Tester / human-test / playwright step
+    // with no enabled `deployer` before it, so nothing would provision the env it needs — the run
+    // would dead-end inside the consumer. The Deployer is the single environment provisioner.
+    'deployer_required_before_tester',
 ];
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,wBAAwB;IACxB,8FAA8F;IAC9F,4FAA4F;IAC5F,+FAA+F;IAC/F,8EAA8E;IAC9E,sBAAsB;IACtB,oBAAoB;IACpB,oBAAoB;IACpB,0BAA0B;IAC1B,6BAA6B;IAC7B,4BAA4B;IAC5B,mBAAmB;IACnB,gBAAgB;IAChB,sBAAsB;IACtB,yBAAyB;IACzB,6BAA6B;IAC7B,kFAAkF;IAClF,kFAAkF;IAClF,0BAA0B;IAC1B,4FAA4F;IAC5F,uFAAuF;IACvF,6BAA6B;CACrB,CAAA"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,wBAAwB;IACxB,8FAA8F;IAC9F,4FAA4F;IAC5F,+FAA+F;IAC/F,8EAA8E;IAC9E,sBAAsB;IACtB,oBAAoB;IACpB,oBAAoB;IACpB,0BAA0B;IAC1B,6BAA6B;IAC7B,4BAA4B;IAC5B,mBAAmB;IACnB,gBAAgB;IAChB,sBAAsB;IACtB,yBAAyB;IACzB,6BAA6B;IAC7B,kFAAkF;IAClF,kFAAkF;IAClF,0BAA0B;IAC1B,4FAA4F;IAC5F,uFAAuF;IACvF,6BAA6B;IAC7B,6FAA6F;IAC7F,8FAA8F;IAC9F,0FAA0F;IAC1F,iCAAiC;CACzB,CAAA"}

package/dist/index.d.ts

@@ -21,6 +21,7 @@ export * from './preflights.js';
 export * from './stack-recipes.js';
 export * from './shared-stacks.js';
 export * from './environment-analyst.js';
+export * from './environment-analyst-merge.js';
 export * from './runners.js';
 export * from './bootstrap.js';
 export * from './env-config-repair.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,0BAA0B,CAAA;AACxC,cAAc,cAAc,CAAA;AAC5B,cAAc,sBAAsB,CAAA;AACpC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,2BAA2B,CAAA;AACzC,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,0BAA0B,CAAA;AACxC,cAAc,cAAc,CAAA;AAC5B,cAAc,sBAAsB,CAAA;AACpC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,2BAA2B,CAAA;AACzC,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA"}

package/dist/index.js

@@ -21,6 +21,7 @@ export * from './preflights.js';
 export * from './stack-recipes.js';
 export * from './shared-stacks.js';
 export * from './environment-analyst.js';
+export * from './environment-analyst-merge.js';
 export * from './runners.js';
 export * from './bootstrap.js';
 export * from './env-config-repair.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,0BAA0B,CAAA;AACxC,cAAc,cAAc,CAAA;AAC5B,cAAc,sBAAsB,CAAA;AACpC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,2BAA2B,CAAA;AACzC,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,0BAA0B,CAAA;AACxC,cAAc,cAAc,CAAA;AAC5B,cAAc,sBAAsB,CAAA;AACpC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,2BAA2B,CAAA;AACzC,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/contracts",
-  "version": "0.107.0",
+  "version": "0.108.0",
   "description": "Valibot wire contract shared between the Agent Architecture Board frontend and backend.",
   "repository": {
     "type": "git",