@superbee/core 0.2.0-pre.14 → 0.2.0-pre.16

package/dist/recipe-lifecycle/evolution.d.ts

@@ -0,0 +1,71 @@
+import type { LoadedRecipe } from "../recipes.js";
+import type { Bundle, ConceptId, Version } from "../types.js";
+import { type RecipeEvolutionCompletedDefinition } from "./errors.js";
+import { type RecipeStampState } from "./stamp.js";
+export interface RecipeEvolutionDefinition {
+    id: ConceptId;
+    governs: string;
+    /** Content only: whether the convention's declarations change. */
+    action: "missing" | "unchanged" | "update";
+    /** The installed convention's recipe stamp relative to this recipe. */
+    stamp: RecipeStampState;
+    expected_version: Version | null;
+    desired_version: Version;
+    /** Exact additive semantic paths this automatic plan will introduce. */
+    added_paths: string[];
+}
+export interface RecipeEvolutionBlocker {
+    code: string;
+    id: string;
+    message: string;
+    field?: string;
+}
+/** Public representation of one read-only, state-bound preflight decision. */
+export interface RecipeEvolutionPlan {
+    recipe: "evolution plan";
+    id: string;
+    version: string;
+    source: string;
+    okf_version: string;
+    ready: boolean;
+    /** Content only: whether any convention's declarations change. */
+    changed: boolean;
+    /** How many conventions the apply writes: every content update and every stale or missing stamp. */
+    writes: number;
+    plan_token: string;
+    definitions: RecipeEvolutionDefinition[];
+    counts: {
+        definitions: number;
+        updates: number;
+        /** Writes that only record the stamp: write-set members whose action is not `update`. */
+        stamp_writes: number;
+        unchanged: number;
+        missing: number;
+        instances_checked: number;
+        blockers: number;
+    };
+    blockers: RecipeEvolutionBlocker[];
+}
+export interface RecipeEvolutionApplyResult {
+    /** `evolved`: a content update was written; `stamped`: only stamps were; `already current`: nothing. */
+    recipe: "evolved" | "stamped" | "already current";
+    id: string;
+    version: string;
+    source: string;
+    /** True whenever anything was written. */
+    changed: boolean;
+    plan_token: string;
+    definitions: RecipeEvolutionCompletedDefinition[];
+    counts: {
+        updated: number;
+        stamped: number;
+        unchanged: number;
+    };
+}
+/** Build a read-only, state-bound preflight for installed recipe convention evolution. */
+export declare function planRecipeEvolution(bundle: Bundle, recipe: LoadedRecipe): Promise<RecipeEvolutionPlan>;
+/** Apply only the exact ready plan the caller previously observed. */
+export declare function applyRecipeEvolution(bundle: Bundle, recipe: LoadedRecipe, expectedPlanToken: string, options?: {
+    actor?: string;
+}): Promise<RecipeEvolutionApplyResult>;
+//# sourceMappingURL=evolution.d.ts.map

package/dist/recipe-lifecycle/evolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evolution.d.ts","sourceRoot":"","sources":["../../src/recipe-lifecycle/evolution.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAe,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3E,OAAO,EAML,KAAK,kCAAkC,EACxC,MAAM,aAAa,CAAC;AAMrB,OAAO,EAOL,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAUpB,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,SAAS,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3C,uEAAuE;IACvE,KAAK,EAAE,gBAAgB,CAAC;IACxB,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,eAAe,EAAE,OAAO,CAAC;IACzB,wEAAwE;IACxE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,gBAAgB,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;IACjB,oGAAoG;IACpG,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,yBAAyB,EAAE,CAAC;IACzC,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,yFAAyF;QACzF,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,EAAE,sBAAsB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,0BAA0B;IACzC,wGAAwG;IACxG,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,iBAAiB,CAAC;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,kCAAkC,EAAE,CAAC;IAClD,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE;AAgwBD,0FAA0F;AAC1F,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAE9B;AAED,sEAAsE;AACtE,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,EACpB,iBAAiB,EAAE,MAAM,EACzB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,0BAA0B,CAAC,CAsHrC"}