@owlmeans/viable-common 0.0.43 → 0.0.45

package/build/convert/utils.js

@@ -0,0 +1,6 @@
+import { conversionDocHelper } from './docs.js';
+/** @deprecated compat:factory-refactor — use `conversionDocHelper.conversionStoryDoc(…)` */
+export const conversionStoryDoc = (code) => conversionDocHelper.conversionStoryDoc(code);
+/** @deprecated compat:factory-refactor — use `conversionDocHelper.conversionSeedDoc(…)` */
+export const conversionSeedDoc = (name) => conversionDocHelper.conversionSeedDoc(name);
+//# sourceMappingURL=utils.js.map

package/build/convert/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/convert/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAE/C,4FAA4F;AAC5F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAA;AAExG,2FAA2F;AAC3F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA"}

package/build/design/consts.d.ts

@@ -6,6 +6,7 @@
  * the fields it is missing were absent because they had not been designed and which because the
  * shape did not have them yet. Those are different questions with different answers.
  */
+import type { StoryDesignRuntime } from './types.js';
 export declare const STORY_DESIGN_VERSION = 1;
 /** How far a design may drift from the project it was written against before it is stale. */
 export declare enum DesignStaleness {
@@ -20,4 +21,40 @@ export declare enum DesignStaleness {
     /** The generated tree moved under it. Re-run the stages that read the tree. */
     Tree = "tree"
 }
+/** Who acts in a story. */
+export declare enum StoryActor {
+    /** A person, in one of the four areas. Every story until something says otherwise. */
+    Human = "human",
+    /**
+     * The application's own LLM agent.
+     *
+     * An EPHEMERAL role: it holds no permissions and has no area of its own, because there is nobody
+     * to sign in as it. A story belongs to it when the work is the agent's — the human half is a
+     * separate, paired story that starts the work and watches it.
+     */
+    Agent = "agent",
+    /** A queue consumer. Ephemeral in exactly the same sense. */
+    Worker = "worker"
+}
+/** The ephemeral actors — those a permission may never be granted to. */
+export declare const EPHEMERAL_ACTORS: StoryActor[];
+/**
+ * The three shapes that can perform work with a model, cheapest first.
+ *
+ * They are not interchangeable and the difference is who decides the order. A CALL is one prompt
+ * and one answer; a PIPELINE runs steps this application named in advance; an AGENT is handed
+ * tools and works out its own path. Each step up buys capability with latency, money and a
+ * failure mode, so the right answer is the simplest shape that does the job — and for most work
+ * that asks for a model at all, it is a call.
+ */
+export declare enum StoryAgentKind {
+    /** One prompt, one answer, optionally schema-shaped. The default. */
+    Call = "call",
+    /** Ordered steps decided by the application, not by the model. */
+    Pipeline = "pipeline",
+    /** The model chooses its own path through the tools it was given. */
+    Agent = "agent"
+}
+/** What a design carries when nobody has asked the question — and when the answer was "no". */
+export declare const NO_RUNTIME: StoryDesignRuntime;
 //# sourceMappingURL=consts.d.ts.map

package/build/design/consts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../src/design/consts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC,6FAA6F;AAC7F,oBAAY,eAAe;IACzB,2BAA2B;IAC3B,KAAK,UAAU;IACf,mDAAmD;IACnD,OAAO,YAAY;IACnB,oDAAoD;IACpD,SAAS,cAAc;IACvB,uFAAuF;IACvF,OAAO,YAAY;IACnB,+EAA+E;IAC/E,IAAI,SAAS;CACd"}
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../src/design/consts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC,6FAA6F;AAC7F,oBAAY,eAAe;IACzB,2BAA2B;IAC3B,KAAK,UAAU;IACf,mDAAmD;IACnD,OAAO,YAAY;IACnB,oDAAoD;IACpD,SAAS,cAAc;IACvB,uFAAuF;IACvF,OAAO,YAAY;IACnB,+EAA+E;IAC/E,IAAI,SAAS;CACd;AAED,2BAA2B;AAC3B,oBAAY,UAAU;IACpB,sFAAsF;IACtF,KAAK,UAAU;IACf;;;;;;OAMG;IACH,KAAK,UAAU;IACf,6DAA6D;IAC7D,MAAM,WAAW;CAClB;AAED,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,EAAE,UAAU,EAA0C,CAAA;AAEnF;;;;;;;;GAQG;AACH,oBAAY,cAAc;IACxB,qEAAqE;IACrE,IAAI,SAAS;IACb,kEAAkE;IAClE,QAAQ,aAAa;IACrB,qEAAqE;IACrE,KAAK,UAAU;CAChB;AAED,+FAA+F;AAC/F,eAAO,MAAM,UAAU,EAAE,kBAMxB,CAAA"}

package/build/design/consts.js

@@ -1,11 +1,3 @@
-/**
- * The design shape's own version.
- *
- * A mismatch REFUSES; it never adapts. A design is read back days after it was written, by code
- * that has since changed — and a reader that "adapted" an older shape would be guessing which of
- * the fields it is missing were absent because they had not been designed and which because the
- * shape did not have them yet. Those are different questions with different answers.
- */
 export const STORY_DESIGN_VERSION = 1;
 /** How far a design may drift from the project it was written against before it is stale. */
 export var DesignStaleness;
@@ -21,4 +13,48 @@ export var DesignStaleness;
     /** The generated tree moved under it. Re-run the stages that read the tree. */
     DesignStaleness["Tree"] = "tree";
 })(DesignStaleness || (DesignStaleness = {}));
+/** Who acts in a story. */
+export var StoryActor;
+(function (StoryActor) {
+    /** A person, in one of the four areas. Every story until something says otherwise. */
+    StoryActor["Human"] = "human";
+    /**
+     * The application's own LLM agent.
+     *
+     * An EPHEMERAL role: it holds no permissions and has no area of its own, because there is nobody
+     * to sign in as it. A story belongs to it when the work is the agent's — the human half is a
+     * separate, paired story that starts the work and watches it.
+     */
+    StoryActor["Agent"] = "agent";
+    /** A queue consumer. Ephemeral in exactly the same sense. */
+    StoryActor["Worker"] = "worker";
+})(StoryActor || (StoryActor = {}));
+/** The ephemeral actors — those a permission may never be granted to. */
+export const EPHEMERAL_ACTORS = [StoryActor.Agent, StoryActor.Worker];
+/**
+ * The three shapes that can perform work with a model, cheapest first.
+ *
+ * They are not interchangeable and the difference is who decides the order. A CALL is one prompt
+ * and one answer; a PIPELINE runs steps this application named in advance; an AGENT is handed
+ * tools and works out its own path. Each step up buys capability with latency, money and a
+ * failure mode, so the right answer is the simplest shape that does the job — and for most work
+ * that asks for a model at all, it is a call.
+ */
+export var StoryAgentKind;
+(function (StoryAgentKind) {
+    /** One prompt, one answer, optionally schema-shaped. The default. */
+    StoryAgentKind["Call"] = "call";
+    /** Ordered steps decided by the application, not by the model. */
+    StoryAgentKind["Pipeline"] = "pipeline";
+    /** The model chooses its own path through the tools it was given. */
+    StoryAgentKind["Agent"] = "agent";
+})(StoryAgentKind || (StoryAgentKind = {}));
+/** What a design carries when nobody has asked the question — and when the answer was "no". */
+export const NO_RUNTIME = {
+    actor: StoryActor.Human,
+    worker: false,
+    jobs: [],
+    agents: [],
+    kv: false,
+};
 //# sourceMappingURL=consts.js.map

package/build/design/consts.js.map

@@ -1 +1 @@
-{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/design/consts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAA;AAErC,6FAA6F;AAC7F,MAAM,CAAN,IAAY,eAWX;AAXD,WAAY,eAAe;IACzB,2BAA2B;IAC3B,kCAAe,CAAA;IACf,mDAAmD;IACnD,sCAAmB,CAAA;IACnB,oDAAoD;IACpD,0CAAuB,CAAA;IACvB,uFAAuF;IACvF,sCAAmB,CAAA;IACnB,+EAA+E;IAC/E,gCAAa,CAAA;AACf,CAAC,EAXW,eAAe,KAAf,eAAe,QAW1B"}
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/design/consts.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAA;AAErC,6FAA6F;AAC7F,MAAM,CAAN,IAAY,eAWX;AAXD,WAAY,eAAe;IACzB,2BAA2B;IAC3B,kCAAe,CAAA;IACf,mDAAmD;IACnD,sCAAmB,CAAA;IACnB,oDAAoD;IACpD,0CAAuB,CAAA;IACvB,uFAAuF;IACvF,sCAAmB,CAAA;IACnB,+EAA+E;IAC/E,gCAAa,CAAA;AACf,CAAC,EAXW,eAAe,KAAf,eAAe,QAW1B;AAED,2BAA2B;AAC3B,MAAM,CAAN,IAAY,UAaX;AAbD,WAAY,UAAU;IACpB,sFAAsF;IACtF,6BAAe,CAAA;IACf;;;;;;OAMG;IACH,6BAAe,CAAA;IACf,6DAA6D;IAC7D,+BAAiB,CAAA;AACnB,CAAC,EAbW,UAAU,KAAV,UAAU,QAarB;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAiB,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;AAEnF;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,cAOX;AAPD,WAAY,cAAc;IACxB,qEAAqE;IACrE,+BAAa,CAAA;IACb,kEAAkE;IAClE,uCAAqB,CAAA;IACrB,qEAAqE;IACrE,iCAAe,CAAA;AACjB,CAAC,EAPW,cAAc,KAAd,cAAc,QAOzB;AAED,+FAA+F;AAC/F,MAAM,CAAC,MAAM,UAAU,GAAuB;IAC5C,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,EAAE;IACR,MAAM,EAAE,EAAE;IACV,EAAE,EAAE,KAAK;CACV,CAAA"}

package/build/design/helpers.d.ts

@@ -1,64 +1,24 @@
 import type { UserStory } from '../ba/types.js';
-import { DesignStaleness } from './consts.js';
+import type { DesignStaleness } from './consts.js';
 import type { StoryDesign } from './types.js';
-/**
- * The in-memory aggregate the coders take, derived from the design ALONE.
- *
- * Derived rather than stored, and derived HERE rather than at the platform: the aggregate is what
- * every generation helper reads, and a second place that assembles it is a second place that can
- * assemble it differently. The `code` in particular is load-bearing - the scaffold stamps every
- * placeholder it draws with it, so a run keyed by anything else cannot recognise its own
- * reservation.
- *
- * For a context with no card behind it. Where a story card exists, `userStoryOf(card, design)` is
- * the reader: the card wins on the narrative, code, area and actor, which a person may have
- * changed since the design was written.
- */
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.userStoryOfDesign(…)` */
 export declare const userStoryOfDesign: (design: StoryDesign) => UserStory;
-/** Screen name to component names - the shape every UX and UI prompt takes. */
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.screenMapOf(…)` */
 export declare const screenMapOf: (design: StoryDesign) => Record<string, string[]>;
-/** Every path the design names, in the order the implementation stage visits them. */
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.designPaths(…)` */
 export declare const designPaths: (design: StoryDesign) => string[];
-/**
- * How far the world has moved since the design was written.
- *
- * Ordered by severity, and each answer has one correct reaction: a version mismatch REFUSES, a
- * changed narrative re-designs, a changed project warns and continues, a moved tree re-runs only
- * the stages that read the tree. Collapsing them into a boolean would make every one of those the
- * most expensive of the four.
- */
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.designStaleness(…)` */
 export declare const designStaleness: (design: StoryDesign, now: {
     narrativeHash: string;
     projectHash: string;
     registryHash: string;
 }) => DesignStaleness;
-/**
- * A stable, dependency-free hash of arbitrary text.
- *
- * FNV-1a, because what is being detected is "did this change", not "is this authentic" - and a
- * design record must be readable by a browser bundle, a worker and a test with no crypto import
- * between them.
- */
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.designHash(…)` */
 export declare const designHash: (...parts: Array<string | undefined>) => string;
-/** An empty design, so every stage can fill its own slice without inventing the shape. */
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.emptyStoryDesign(…)` */
 export declare const emptyStoryDesign: (input: Pick<StoryDesign, 'code' | 'narrative' | 'area'> & Partial<StoryDesign>) => StoryDesign;
-/**
- * The design, small enough to hand a model, complete enough to act on.
- *
- * What a free-flight agent needs is names and counts: which screens exist, what is on them, which
- * types and endpoints the story implies. The UX and UI prose is the bulk of a design and none of
- * it helps an agent decide what to do next, so it is deliberately left out.
- */
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.designDigest(…)` */
 export declare const designDigest: (design: StoryDesign) => string;
-/**
- * Apply a patch to a design, refusing anything that would rename an allocated artifact.
- *
- * A path or an alias is registry-owned. Changing one behind the registry's back leaves two
- * spellings of the same thing in a project, and no number of fix attempts repairs that — the
- * compiler sees a missing module and the fixer, reasonably, renames the reference to match
- * whichever spelling it found first.
- *
- * Returns the reason as a STRING when it refuses, so a model can read it and take the other route.
- */
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.amendStoryDesign(…)` */
 export declare const amendStoryDesign: (design: StoryDesign, patch: Record<string, unknown>) => StoryDesign | string;
 //# sourceMappingURL=helpers.d.ts.map

package/build/design/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/design/helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAuC,SAAS,EAAE,MAAM,gBAAgB,CAAA;AACpF,OAAO,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAA;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,WAAY,WAAW,KAAG,SA2CvD,CAAA;AAED,+EAA+E;AAC/E,eAAO,MAAM,WAAW,WAAY,WAAW,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAKjE,CAAA;AAER,sFAAsF;AACtF,eAAO,MAAM,WAAW,WAAY,WAAW,KAAG,MAAM,EAQvD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,WAClB,WAAW,OACd;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,KACxE,eAeF,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,aAAc,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,KAAG,MAShE,CAAA;AAED,0FAA0F;AAC1F,eAAO,MAAM,gBAAgB,UACpB,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,KAC7E,WAqBD,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,WAAY,WAAW,KAAG,MAqDlD,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,WACnB,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAClD,WAAW,GAAG,MA8BhB,CAAA"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/design/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,yFAAyF;AACzF,eAAO,MAAM,iBAAiB,WAAY,WAAW,KAAG,SAAwD,CAAA;AAEhH,mFAAmF;AACnF,eAAO,MAAM,WAAW,WAAY,WAAW,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAA0C,CAAA;AAEnH,mFAAmF;AACnF,eAAO,MAAM,WAAW,WAAY,WAAW,KAAG,MAAM,EAA2C,CAAA;AAEnG,uFAAuF;AACvF,eAAO,MAAM,eAAe,WAClB,WAAW,OACd;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,KACxE,eAAiE,CAAA;AAEpE,kFAAkF;AAClF,eAAO,MAAM,UAAU,aAAc,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,KAAG,MAAgD,CAAA;AAEjH,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,UACpB,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,KAC7E,WAAwD,CAAA;AAE3D,oFAAoF;AACpF,eAAO,MAAM,YAAY,WAAY,WAAW,KAAG,MAAgD,CAAA;AAEnG,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,WAAY,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,WAAW,GAAG,MAClD,CAAA"}

package/build/design/helpers.js

@@ -1,225 +1,18 @@
-import { SpecCategory } from '../ba/consts.js';
-import { DesignStaleness, STORY_DESIGN_VERSION } from './consts.js';
-/**
- * The in-memory aggregate the coders take, derived from the design ALONE.
- *
- * Derived rather than stored, and derived HERE rather than at the platform: the aggregate is what
- * every generation helper reads, and a second place that assembles it is a second place that can
- * assemble it differently. The `code` in particular is load-bearing - the scaffold stamps every
- * placeholder it draws with it, so a run keyed by anything else cannot recognise its own
- * reservation.
- *
- * For a context with no card behind it. Where a story card exists, `userStoryOf(card, design)` is
- * the reader: the card wins on the narrative, code, area and actor, which a person may have
- * changed since the design was written.
- */
-export const userStoryOfDesign = (design) => {
-    const componentOf = (name) => {
-        const component = design.components.find(entry => entry.name === name);
-        if (component == null) {
-            return null;
-        }
-        return {
-            name: component.name,
-            description: '',
-            specs: {
-                [SpecCategory.UX]: component.specs.ux,
-                [SpecCategory.UI]: component.specs.ui,
-            },
-            entities: component.entities.map(entity => ({
-                name: entity, description: '', attributes: [],
-            })),
-        };
-    };
-    const screens = design.screens.map(screen => ({
-        name: screen.name,
-        description: '',
-        ...(screen.section != null ? { section: screen.section } : {}),
-        specs: {
-            [SpecCategory.UX]: screen.specs.ux,
-            [SpecCategory.UI]: screen.specs.ui,
-        },
-        components: screen.components
-            .map(componentOf)
-            .filter((component) => component != null),
-    }));
-    return {
-        story: design.narrative,
-        code: design.code,
-        area: design.area,
-        entity: null,
-        entities: design.entities.map(entity => ({
-            name: entity.name, description: entity.description, attributes: [],
-        })),
-        screens,
-    };
-};
-/** Screen name to component names - the shape every UX and UI prompt takes. */
-export const screenMapOf = (design) => design.screens.reduce((map, screen) => {
-    map[screen.name] = [...screen.components];
-    return map;
-}, {});
-/** Every path the design names, in the order the implementation stage visits them. */
-export const designPaths = (design) => [
-    ...design.types.map(entry => entry.path),
-    ...design.resources.map(entry => entry.path),
-    ...design.models.map(entry => entry.path),
-    ...design.api.map(entry => entry.path),
-    ...design.stores.map(entry => entry.path),
-    ...design.components.flatMap(entry => [entry.viewModelPath, entry.path]),
-    ...design.screens.map(entry => entry.path),
-];
-/**
- * How far the world has moved since the design was written.
- *
- * Ordered by severity, and each answer has one correct reaction: a version mismatch REFUSES, a
- * changed narrative re-designs, a changed project warns and continues, a moved tree re-runs only
- * the stages that read the tree. Collapsing them into a boolean would make every one of those the
- * most expensive of the four.
- */
-export const designStaleness = (design, now) => {
-    if (design.version !== STORY_DESIGN_VERSION) {
-        return DesignStaleness.Version;
-    }
-    if (design.provenance.narrativeHash !== now.narrativeHash) {
-        return DesignStaleness.Narrative;
-    }
-    if (design.provenance.projectHash !== now.projectHash) {
-        return DesignStaleness.Project;
-    }
-    if (design.provenance.registryHash !== now.registryHash) {
-        return DesignStaleness.Tree;
-    }
-    return DesignStaleness.Fresh;
-};
-/**
- * A stable, dependency-free hash of arbitrary text.
- *
- * FNV-1a, because what is being detected is "did this change", not "is this authentic" - and a
- * design record must be readable by a browser bundle, a worker and a test with no crypto import
- * between them.
- */
-export const designHash = (...parts) => {
-    const text = parts.filter(part => part != null).join(' ');
-    let hash = 0x811c9dc5;
-    for (let at = 0; at < text.length; at += 1) {
-        hash ^= text.charCodeAt(at);
-        hash = Math.imul(hash, 0x01000193) >>> 0;
-    }
-    return hash.toString(16).padStart(8, '0');
-};
-/** An empty design, so every stage can fill its own slice without inventing the shape. */
-export const emptyStoryDesign = (input) => ({
-    version: STORY_DESIGN_VERSION,
-    reserved: {},
-    entities: [],
-    screens: [],
-    components: [],
-    types: [],
-    resources: [],
-    models: [],
-    api: [],
-    stores: [],
-    transitions: [],
-    access: { list: {}, resolvedAt: {} },
-    provenance: {
-        designedAt: new Date().toISOString(),
-        narrativeHash: '',
-        projectHash: '',
-        registryHash: '',
-        paths: [],
-    },
-    ...input,
-});
-/**
- * The design, small enough to hand a model, complete enough to act on.
- *
- * What a free-flight agent needs is names and counts: which screens exist, what is on them, which
- * types and endpoints the story implies. The UX and UI prose is the bulk of a design and none of
- * it helps an agent decide what to do next, so it is deliberately left out.
- */
-export const designDigest = (design) => {
-    const lines = [
-        `Story ${design.code} (${design.area}): ${design.narrative}`,
-    ];
-    if (design.reserved.section != null || design.reserved.screen != null) {
-        lines.push(`Reserved: section=${design.reserved.section ?? '-'} screen=${design.reserved.screen ?? '-'}`);
-    }
-    lines.push('', 'Screens:');
-    for (const screen of design.screens) {
-        lines.push(`- ${screen.name} -> ${screen.path} (alias ${screen.alias}`
-            + `${screen.section != null ? `, section ${screen.section}` : ''}`
-            + `${screen.adopted ? ', existing' : ''}) renders ${screen.components.join(', ') || '-'}`);
-    }
-    lines.push('', 'Components:');
-    for (const component of design.components) {
-        lines.push(`- ${component.name} -> ${component.path} (+ ${component.viewModelPath})`
-            + `${component.entities.length > 0 ? ` about ${component.entities.join(', ')}` : ''}`);
-    }
-    lines.push('', 'Data layer:');
-    for (const type of design.types) {
-        lines.push(`- type ${type.path} (${type.entity})`);
-    }
-    for (const resource of design.resources) {
-        lines.push(`- resource ${resource.path} (${resource.entity})`);
-    }
-    for (const model of design.models) {
-        lines.push(`- model ${model.path} (${model.entities.join(', ')})`);
-    }
-    for (const api of design.api) {
-        lines.push(`- api ${api.path} (${api.entity})`
-            + `${api.endpoints.length > 0 ? `: ${api.endpoints.map(e => e.alias).join(', ')}` : ''}`);
-    }
-    for (const store of design.stores) {
-        lines.push(`- store ${store.path} (${store.entity})`);
-    }
-    if (design.transitions.length > 0) {
-        lines.push('', 'Transitions:');
-        for (const transition of design.transitions) {
-            lines.push(`- ${transition.from} -> ${transition.to} (${transition.action})`);
-        }
-    }
-    const guarded = Object.keys(design.access.list);
-    if (guarded.length > 0) {
-        lines.push('', `Access declared on: ${guarded.join(', ')}`);
-    }
-    return lines.join('\n');
-};
-/**
- * Apply a patch to a design, refusing anything that would rename an allocated artifact.
- *
- * A path or an alias is registry-owned. Changing one behind the registry's back leaves two
- * spellings of the same thing in a project, and no number of fix attempts repairs that — the
- * compiler sees a missing module and the fixer, reasonably, renames the reference to match
- * whichever spelling it found first.
- *
- * Returns the reason as a STRING when it refuses, so a model can read it and take the other route.
- */
-export const amendStoryDesign = (design, patch) => {
-    const forbidden = [];
-    const checkList = (key, current, next) => {
-        if (!Array.isArray(next))
-            return;
-        for (const entry of next) {
-            const known = current.find(item => item.name === entry.name);
-            if (known == null)
-                continue;
-            if (entry.path != null && known.path != null && entry.path !== known.path) {
-                forbidden.push(`${key}.${String(entry.name)}.path`);
-            }
-            if (entry.alias != null && known.alias != null && entry.alias !== known.alias) {
-                forbidden.push(`${key}.${String(entry.name)}.alias`);
-            }
-        }
-    };
-    checkList('screens', design.screens, patch.screens);
-    checkList('components', design.components, patch.components);
-    if (forbidden.length > 0) {
-        return `Refused: ${forbidden.join(', ')} name artifacts the project's registry allocated. `
-            + 'A design may change what a screen or a component DOES - its UX, its UI, its section, its '
-            + 'endpoints - but never where it lives or what it is called. Rename through the registry, '
-            + 'or leave the name alone and change the behaviour.';
-    }
-    return { ...design, ...patch };
-};
+import { storyDesignHelper } from './story.js';
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.userStoryOfDesign(…)` */
+export const userStoryOfDesign = (design) => storyDesignHelper.userStoryOfDesign(design);
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.screenMapOf(…)` */
+export const screenMapOf = (design) => storyDesignHelper.screenMapOf(design);
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.designPaths(…)` */
+export const designPaths = (design) => storyDesignHelper.designPaths(design);
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.designStaleness(…)` */
+export const designStaleness = (design, now) => storyDesignHelper.designStaleness(design, now);
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.designHash(…)` */
+export const designHash = (...parts) => storyDesignHelper.designHash(...parts);
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.emptyStoryDesign(…)` */
+export const emptyStoryDesign = (input) => storyDesignHelper.emptyStoryDesign(input);
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.designDigest(…)` */
+export const designDigest = (design) => storyDesignHelper.designDigest(design);
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.amendStoryDesign(…)` */
+export const amendStoryDesign = (design, patch) => storyDesignHelper.amendStoryDesign(design, patch);
 //# sourceMappingURL=helpers.js.map

package/build/design/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/design/helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/design/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAG9C,yFAAyF;AACzF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAmB,EAAa,EAAE,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAA;AAEhH,mFAAmF;AACnF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAmB,EAA4B,EAAE,CAAC,iBAAiB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;AAEnH,mFAAmF;AACnF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAmB,EAAY,EAAE,CAAC,iBAAiB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;AAEnG,uFAAuF;AACvF,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,MAAmB,EACnB,GAAyE,EACxD,EAAE,CAAC,iBAAiB,CAAC,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAEpE,kFAAkF;AAClF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAG,KAAgC,EAAU,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,CAAA;AAEjH,wFAAwF;AACxF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,KAA8E,EACjE,EAAE,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;AAE3D,oFAAoF;AACpF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAmB,EAAU,EAAE,CAAC,iBAAiB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;AAEnG,wFAAwF;AACxF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAmB,EAAE,KAA8B,EAAwB,EAAE,CAC5G,iBAAiB,CAAC,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA"}

package/build/design/index.d.ts

@@ -1,6 +1,9 @@
 export * from './consts.js';
+export * from './story.js';
 export * from './helpers.js';
 export * from './schemas.js';
 export type * from './types.js';
+export type * from './story/types.js';
+export type * from './runtime/types.js';
 export * from './runtime.js';
 //# sourceMappingURL=index.d.ts.map

package/build/design/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/design/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,mBAAmB,YAAY,CAAA;AAC/B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/design/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,oBAAoB,CAAA;AACvC,cAAc,cAAc,CAAA"}

package/build/design/index.js

@@ -1,4 +1,5 @@
 export * from './consts.js';
+export * from './story.js';
 export * from './helpers.js';
 export * from './schemas.js';
 export * from './runtime.js';

package/build/design/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/design/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAE5B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/design/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAI5B,cAAc,cAAc,CAAA"}

package/build/design/runtime/types.d.ts

@@ -0,0 +1,16 @@
+import type { StoryActor } from '../consts.js';
+import type { StoryDesignRuntime } from '../types.js';
+/**
+ * What a story needs BEYOND a screen, an endpoint and a table — and the standing answer is
+ * "nothing". See `design/runtime.ts`.
+ */
+export interface StoryRuntimeHelper {
+    isEphemeralActor: (actor?: StoryActor) => boolean;
+    /** Read the gate off a design, total over a design that predates it. */
+    runtimeOf: (design?: {
+        runtime?: StoryDesignRuntime;
+    }) => StoryDesignRuntime;
+    /** Whether anything at all was asked for — the one check every new step is gated on. */
+    needsRuntime: (runtime: StoryDesignRuntime) => boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/design/runtime/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/design/runtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,CAAC,KAAK,CAAC,EAAE,UAAU,KAAK,OAAO,CAAA;IACjD,wEAAwE;IACxE,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,kBAAkB,CAAA;KAAE,KAAK,kBAAkB,CAAA;IAC5E,wFAAwF;IACxF,YAAY,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAA;CACvD"}

package/build/design/runtime/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/design/runtime/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/design/runtime/types.ts"],"names":[],"mappings":""}