@owlmeans/viable-common 0.0.4

package/build/areas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/areas/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAA"}

package/build/areas/types.d.ts

@@ -0,0 +1,28 @@
+import type { ProjectArea } from './consts.js';
+/**
+ * A user story as the analysis stage produces it: the narrative, plus the area whose
+ * audience acts in it.
+ *
+ * The area is structured data rather than a phrase inside the sentence because everything
+ * downstream keys off it — which entrypoint the story's screens hang under, what access they
+ * inherit, and which URL the preview opens when the story is done.
+ */
+export interface StoryDraft {
+    story: string;
+    area: ProjectArea;
+}
+/**
+ * One line of the generated application's navigation.
+ *
+ * A screen reaches the menus through exactly one of these. `section` groups entries into the
+ * top menu; it is a label, never a URL segment — the address of a screen is its entrypoint
+ * path and nothing else.
+ */
+export interface NavEntry {
+    area: ProjectArea;
+    section: string;
+    /** The screen's `app.web.*` alias. */
+    alias: string;
+    label: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/areas/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/areas/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,WAAW,CAAA;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd"}

package/build/areas/types.js

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

package/build/areas/types.js.map

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

package/build/ba/consts.d.ts

@@ -0,0 +1,38 @@
+export declare enum SpecCategory {
+    BA = "ba",
+    UX = "ux",
+    UI = "ui"
+}
+/**
+ * The four screens that hold a flow together.
+ *
+ * A flow step acts on ONE record and never says how its actor reached it — which of the hundreds
+ * waiting for them they opened, where they saw it was waiting at all, or where they look afterwards
+ * to find out what became of it. These are the four shapes that answer that question.
+ *
+ * The taxonomy is CLOSED on purpose: a kind nothing derives is a screen nobody asked for, and every
+ * story here costs a full develop run the project's owner pays for.
+ */
+export declare enum ConnectingStoryKind {
+    /** The list of records waiting for THIS actor to perform their step. Derived from a hand-off. */
+    Queue = "queue",
+    /** The directory of a kind of record, where an actor finds and opens the one they mean. */
+    Index = "index",
+    /** One record gathered — what has happened to it, and the flow actions that start from it. */
+    Record = "record",
+    /** An actor's own submissions and the state each reached. The sending side of a hand-off. */
+    Tracker = "tracker"
+}
+/**
+ * Which half of the analysis a story came from.
+ *
+ * `flow` stories implement the numbered steps of the main flow — each adds value to one record.
+ * `connective` stories are what a person needs to get from one step to the next. Neither is
+ * persisted: the init pipeline is the only thing that has ever needed to tell them apart, and it
+ * knows at creation time.
+ */
+export declare enum StoryKind {
+    Flow = "flow",
+    Connective = "connective"
+}
+//# sourceMappingURL=consts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../src/ba/consts.ts"],"names":[],"mappings":"AACA,oBAAY,YAAY;IACtB,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;CACV;AAED;;;;;;;;;GASG;AACH,oBAAY,mBAAmB;IAC7B,iGAAiG;IACjG,KAAK,UAAU;IACf,2FAA2F;IAC3F,KAAK,UAAU;IACf,8FAA8F;IAC9F,MAAM,WAAW;IACjB,6FAA6F;IAC7F,OAAO,YAAY;CACpB;AAED;;;;;;;GAOG;AACH,oBAAY,SAAS;IACnB,IAAI,SAAS;IACb,UAAU,eAAe;CAC1B"}

package/build/ba/consts.js

@@ -0,0 +1,41 @@
+export var SpecCategory;
+(function (SpecCategory) {
+    SpecCategory["BA"] = "ba";
+    SpecCategory["UX"] = "ux";
+    SpecCategory["UI"] = "ui";
+})(SpecCategory || (SpecCategory = {}));
+/**
+ * The four screens that hold a flow together.
+ *
+ * A flow step acts on ONE record and never says how its actor reached it — which of the hundreds
+ * waiting for them they opened, where they saw it was waiting at all, or where they look afterwards
+ * to find out what became of it. These are the four shapes that answer that question.
+ *
+ * The taxonomy is CLOSED on purpose: a kind nothing derives is a screen nobody asked for, and every
+ * story here costs a full develop run the project's owner pays for.
+ */
+export var ConnectingStoryKind;
+(function (ConnectingStoryKind) {
+    /** The list of records waiting for THIS actor to perform their step. Derived from a hand-off. */
+    ConnectingStoryKind["Queue"] = "queue";
+    /** The directory of a kind of record, where an actor finds and opens the one they mean. */
+    ConnectingStoryKind["Index"] = "index";
+    /** One record gathered — what has happened to it, and the flow actions that start from it. */
+    ConnectingStoryKind["Record"] = "record";
+    /** An actor's own submissions and the state each reached. The sending side of a hand-off. */
+    ConnectingStoryKind["Tracker"] = "tracker";
+})(ConnectingStoryKind || (ConnectingStoryKind = {}));
+/**
+ * Which half of the analysis a story came from.
+ *
+ * `flow` stories implement the numbered steps of the main flow — each adds value to one record.
+ * `connective` stories are what a person needs to get from one step to the next. Neither is
+ * persisted: the init pipeline is the only thing that has ever needed to tell them apart, and it
+ * knows at creation time.
+ */
+export var StoryKind;
+(function (StoryKind) {
+    StoryKind["Flow"] = "flow";
+    StoryKind["Connective"] = "connective";
+})(StoryKind || (StoryKind = {}));
+//# sourceMappingURL=consts.js.map

package/build/ba/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/ba/consts.ts"],"names":[],"mappings":"AACA,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,yBAAS,CAAA;IACT,yBAAS,CAAA;IACT,yBAAS,CAAA;AACX,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB;AAED;;;;;;;;;GASG;AACH,MAAM,CAAN,IAAY,mBASX;AATD,WAAY,mBAAmB;IAC7B,iGAAiG;IACjG,sCAAe,CAAA;IACf,2FAA2F;IAC3F,sCAAe,CAAA;IACf,8FAA8F;IAC9F,wCAAiB,CAAA;IACjB,6FAA6F;IAC7F,0CAAmB,CAAA;AACrB,CAAC,EATW,mBAAmB,KAAnB,mBAAmB,QAS9B;AAED;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,0BAAa,CAAA;IACb,sCAAyB,CAAA;AAC3B,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB"}

package/build/ba/helpers.d.ts

@@ -0,0 +1,41 @@
+import type { StoryDraft } from "../areas/types.js";
+import type { ConnectingStoryDraft, MergedStoryDraft } from "./types.js";
+/**
+ * How many connecting stories one flow may carry.
+ *
+ * An N-step chain has N-1 joints, and a connecting story exists to bridge one of them — so the
+ * flow sizes its own supporting cast, and a three-step product can never end up with eight list
+ * screens. It is a CEILING, not a target: the prompt is told to write as few as its rules actually
+ * derived, and most flows land well below this.
+ *
+ * The real reason for a hard number: every story here becomes a full develop run the project's
+ * owner pays for.
+ */
+export declare const connectingStoryCap: (flowCount: number) => number;
+/**
+ * Interleave the connecting stories into the flow they were derived from.
+ *
+ * `after` is an ANCHOR, not a position: it names the flow story whose result the connecting story
+ * displays, so the connecting story lands immediately behind it — which is also immediately in
+ * front of the step it leads into. The result is ONE ordered list, and it is the order records are
+ * created in.
+ *
+ * This is the only place the anchor is interpreted. Both halves of the feature — the prompt that
+ * produces it and the pipeline that persists the result — read it through here, or the two drift
+ * and nothing fails loudly enough to notice.
+ *
+ * Four properties are deliberate:
+ *
+ * - **The flow subsequence is never disturbed.** Strip the connecting stories back out and you have
+ *   `flow`, in `flow` order: story N still implements numbered step N. Everything that finds the
+ *   primary story depends on that.
+ * - **Nothing precedes the first flow story.** An anchor below 1 is clamped up rather than opening a
+ *   position in front of the flow — nothing can be listed before the step that produced it, and
+ *   story 1 stays the enabling action.
+ * - **A placement is advice; the story is work already paid for.** An anchor past the end means
+ *   "at the end", and one that is not a number at all means the front of the flow. Neither is a
+ *   reason to lose a story.
+ * - **Ties keep the model's order**, which is the only ranking anything has.
+ */
+export declare const mergeConnectingStories: (flow: StoryDraft[], connecting: ConnectingStoryDraft[]) => MergedStoryDraft[];
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/ba/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAGxE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,cAAe,MAAM,KAAG,MAAoC,CAAA;AAK3F;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,sBAAsB,SAC3B,UAAU,EAAE,cAAc,oBAAoB,EAAE,KACrD,gBAAgB,EA6ClB,CAAA"}

package/build/ba/helpers.js

@@ -0,0 +1,79 @@
+import { StoryKind } from "./consts.js";
+/**
+ * How many connecting stories one flow may carry.
+ *
+ * An N-step chain has N-1 joints, and a connecting story exists to bridge one of them — so the
+ * flow sizes its own supporting cast, and a three-step product can never end up with eight list
+ * screens. It is a CEILING, not a target: the prompt is told to write as few as its rules actually
+ * derived, and most flows land well below this.
+ *
+ * The real reason for a hard number: every story here becomes a full develop run the project's
+ * owner pays for.
+ */
+export const connectingStoryCap = (flowCount) => Math.max(flowCount - 1, 0);
+/** Collapse case and whitespace, so "the same story twice" is recognised as such. */
+const canonical = (story) => story.trim().replace(/\s+/g, ' ').toLowerCase();
+/**
+ * Interleave the connecting stories into the flow they were derived from.
+ *
+ * `after` is an ANCHOR, not a position: it names the flow story whose result the connecting story
+ * displays, so the connecting story lands immediately behind it — which is also immediately in
+ * front of the step it leads into. The result is ONE ordered list, and it is the order records are
+ * created in.
+ *
+ * This is the only place the anchor is interpreted. Both halves of the feature — the prompt that
+ * produces it and the pipeline that persists the result — read it through here, or the two drift
+ * and nothing fails loudly enough to notice.
+ *
+ * Four properties are deliberate:
+ *
+ * - **The flow subsequence is never disturbed.** Strip the connecting stories back out and you have
+ *   `flow`, in `flow` order: story N still implements numbered step N. Everything that finds the
+ *   primary story depends on that.
+ * - **Nothing precedes the first flow story.** An anchor below 1 is clamped up rather than opening a
+ *   position in front of the flow — nothing can be listed before the step that produced it, and
+ *   story 1 stays the enabling action.
+ * - **A placement is advice; the story is work already paid for.** An anchor past the end means
+ *   "at the end", and one that is not a number at all means the front of the flow. Neither is a
+ *   reason to lose a story.
+ * - **Ties keep the model's order**, which is the only ranking anything has.
+ */
+export const mergeConnectingStories = (flow, connecting) => {
+    if (flow.length < 1) {
+        return [];
+    }
+    const seen = new Set(flow.map(({ story }) => canonical(story)));
+    const placed = [];
+    for (const draft of connecting) {
+        const text = canonical(draft.story);
+        // A connecting story that repeats a flow story is not a second story: it is one develop run
+        // spent twice AND — since the home-screen detector matches its answer back by exact text — a
+        // second record that answer could resolve to.
+        if (text === '' || seen.has(text)) {
+            continue;
+        }
+        seen.add(text);
+        const after = Number(draft.after);
+        placed.push({
+            draft,
+            at: Number.isFinite(after) ? Math.min(Math.max(Math.trunc(after), 1), flow.length) : 1,
+        });
+    }
+    // Over the cap, the LATEST-anchored go: a story late in the flow gates the fewest steps behind
+    // it, while the queue that hands step 1 to step 2 is what makes everything after it reachable.
+    // The sort is stable, so two stories on the same step keep the order they were derived in.
+    const surviving = placed
+        .map((entry, order) => ({ ...entry, order }))
+        .sort((a, b) => a.at - b.at || a.order - b.order)
+        .slice(0, connectingStoryCap(flow.length));
+    // Bucket N holds what comes immediately after flow story N (1-based, as the prompt numbers them).
+    const buckets = flow.map(() => []);
+    for (const { draft, at } of surviving) {
+        buckets[at - 1].push(draft);
+    }
+    return flow.flatMap(({ story, area }, index) => [
+        { story, area, kind: StoryKind.Flow },
+        ...buckets[index].map(draft => ({ story: draft.story.trim(), area: draft.area, kind: StoryKind.Connective })),
+    ]);
+};
+//# sourceMappingURL=helpers.js.map

package/build/ba/helpers.js.map

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

package/build/ba/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ba/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,mBAAmB,YAAY,CAAA"}

package/build/ba/index.js

@@ -0,0 +1,4 @@
+export * from './schemas.js';
+export * from './helpers.js';
+export * from './consts.js';
+//# sourceMappingURL=index.js.map

package/build/ba/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ba/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA"}

package/build/ba/schemas.d.ts

@@ -0,0 +1,13 @@
+import type { JSONSchemaType } from "ajv";
+import type { EntityList, StoryList, Entity, Attribute, MainStoryProbability, MainStoryCandidates, ConnectingStoryDraft, ConnectingStoryList } from "./types.js";
+import type { StoryDraft } from "../areas/types.js";
+export declare const StoryDraftSchema: JSONSchemaType<StoryDraft>;
+export declare const ConnectingStoryDraftSchema: JSONSchemaType<ConnectingStoryDraft>;
+export declare const ConnectingStoryListSchema: JSONSchemaType<ConnectingStoryList>;
+export declare const EntityListSchema: JSONSchemaType<EntityList>;
+export declare const StoryListSchema: JSONSchemaType<StoryList>;
+export declare const AttributeSchema: JSONSchemaType<Attribute>;
+export declare const EntitySchema: JSONSchemaType<Entity>;
+export declare const MainStoryProbabilitySchema: JSONSchemaType<MainStoryProbability>;
+export declare const MainStoryCandidatesSchema: JSONSchemaType<MainStoryCandidates>;
+//# sourceMappingURL=schemas.d.ts.map

package/build/ba/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/ba/schemas.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAChK,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAsBnD,eAAO,MAAM,gBAAgB,EAAE,cAAc,CAAC,UAAU,CAiBvD,CAAA;AAED,eAAO,MAAM,0BAA0B,EAAE,cAAc,CAAC,oBAAoB,CAiC3E,CAAA;AAED,eAAO,MAAM,yBAAyB,EAAE,cAAc,CAAC,mBAAmB,CAYzE,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,cAAc,CAAC,UAAU,CAevD,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,SAAS,CAYrD,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,SAAS,CAgBrD,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,cAAc,CAAC,MAAM,CAqB/C,CAAA;AAED,eAAO,MAAM,0BAA0B,EAAE,cAAc,CAAC,oBAAoB,CAgB3E,CAAA;AAED,eAAO,MAAM,yBAAyB,EAAE,cAAc,CAAC,mBAAmB,CAYzE,CAAA"}

package/build/ba/schemas.js

@@ -0,0 +1,181 @@
+import { ProjectArea } from "../areas/consts.js";
+import { ConnectingStoryKind } from "./consts.js";
+/**
+ * The one rendering of the area field's description.
+ *
+ * Every schema that carries an area points at this. Two copies drift, and the drift is invisible:
+ * both schemas keep validating, and the two prompts that read them start classifying differently.
+ * It is the same reason `AREA_CLASSIFICATION` is spelled once in the BA helper.
+ */
+const AREA_FIELD_DESCRIPTION = `
+      Which area of the application the acting user works in:
+- guest - the actor is NOT signed in (public visitors, prospects, anonymous readers)
+- user - the actor is a signed-in end user consuming the product's value (the front office)
+- operator - the actor is staff running the product's business process from the inside (the back office)
+- admin - the actor is the owner configuring or managing the application itself
+      `;
+const STORY_BODY_DESCRIPTION = "User story body in format: As a [role], I want to [make something] so that [I get the following results]";
+export const StoryDraftSchema = {
+    type: "object",
+    title: "StoryDraft",
+    description: "One user story and the area of the application its actor works in",
+    properties: {
+        story: {
+            type: "string",
+            description: STORY_BODY_DESCRIPTION
+        },
+        area: {
+            type: "string",
+            enum: Object.values(ProjectArea),
+            description: AREA_FIELD_DESCRIPTION
+        },
+    },
+    required: ["story", "area"],
+    additionalProperties: false
+};
+export const ConnectingStoryDraftSchema = {
+    type: "object",
+    title: "ConnectingStoryDraft",
+    description: "One user story that connects the numbered steps of the main flow to each other",
+    properties: {
+        story: {
+            type: "string",
+            description: STORY_BODY_DESCRIPTION
+        },
+        area: {
+            type: "string",
+            enum: Object.values(ProjectArea),
+            description: AREA_FIELD_DESCRIPTION
+        },
+        kind: {
+            type: "string",
+            enum: Object.values(ConnectingStoryKind),
+            description: `
+      Which connecting screen this story is:
+- queue - the list of records waiting for THIS actor to perform their step on them
+- index - the directory of a kind of record, where the actor finds and opens the one they mean
+- record - the page of ONE record: everything that has happened to it, and the actions that start from it
+- tracker - the actor's own list of what they submitted, and what state each one has reached
+      `
+        },
+        after: {
+            type: "integer",
+            minimum: 1,
+            description: "The NUMBER of the flow user story whose result this story displays - this story belongs immediately after that one. Never 0, and never greater than the number of flow stories given"
+        },
+    },
+    required: ["story", "area", "kind", "after"],
+    additionalProperties: false
+};
+export const ConnectingStoryListSchema = {
+    type: "object",
+    title: "ConnectingStoryList",
+    description: "User stories that connect the numbered steps of the main flow to each other",
+    properties: {
+        stories: {
+            type: "array",
+            items: ConnectingStoryDraftSchema,
+            description: "The connecting stories, each anchored to the flow story it comes after"
+        },
+    },
+    required: ["stories"]
+};
+export const EntityListSchema = {
+    type: "object",
+    title: "EntityList",
+    description: "Domain entities",
+    properties: {
+        entities: {
+            type: "array",
+            items: {
+                type: "string",
+                description: "Domain entity name, only alphanumeric characters are allowed no more than 2 words"
+            },
+            description: "List of domain entities"
+        },
+    },
+    required: ["entities"]
+};
+export const StoryListSchema = {
+    type: "object",
+    title: "StoryList",
+    description: "User stories",
+    properties: {
+        stories: {
+            type: "array",
+            items: StoryDraftSchema,
+            description: "List of user stories IN FLOW ORDER - the order of the numbered steps they were taken from"
+        },
+    },
+    required: ["stories"]
+};
+export const AttributeSchema = {
+    type: "object",
+    title: "Attribute",
+    description: "Entity attribute",
+    properties: {
+        name: {
+            type: "string",
+            description: "Attribute name, should be descriptive and use camelCase"
+        },
+        description: {
+            type: "string",
+            description: "Detailed description of the attribute in the domain entity"
+        }
+    },
+    required: ["name", "description"],
+    additionalProperties: false,
+};
+export const EntitySchema = {
+    type: "object",
+    title: "Entity",
+    description: "Domain entity with attributes",
+    properties: {
+        name: {
+            type: "string",
+            description: "Entity name, should be descriptive and use PascalCase"
+        },
+        description: {
+            type: "string",
+            description: "Detailed description of the entity and its role in the domain"
+        },
+        attributes: {
+            type: "array",
+            items: AttributeSchema,
+            description: "List of entity attributes"
+        }
+    },
+    required: ["name", "description", "attributes"],
+    additionalProperties: false,
+};
+export const MainStoryProbabilitySchema = {
+    type: "object",
+    title: "MainStoryProbability",
+    description: "Probability that the user story describes main action on the home screen",
+    properties: {
+        story: {
+            type: "string",
+            description: "Exact user story text copied from input"
+        },
+        probability: {
+            type: "number",
+            description: "Probability scroe — from 0 to 10 — that the user story describes main action on the home screen if we compare with other stories"
+        }
+    },
+    required: ["story", "probability"],
+    additionalProperties: false,
+};
+export const MainStoryCandidatesSchema = {
+    type: "object",
+    title: "MainStoryCandidates",
+    description: "List of main story candidates",
+    properties: {
+        candidates: {
+            type: "array",
+            items: MainStoryProbabilitySchema,
+        }
+    },
+    required: ["candidates"],
+    additionalProperties: false,
+};
+//# sourceMappingURL=schemas.js.map

package/build/ba/schemas.js.map

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

package/build/ba/types.d.ts

@@ -0,0 +1,113 @@
+import { SpecCategory } from "./consts";
+import type { ConnectingStoryKind, StoryKind } from "./consts.js";
+import type { ProjectArea } from "../areas/consts.js";
+import type { StoryDraft } from "../areas/types.js";
+import type { StoryActor } from "../design/runtime.js";
+export interface EntityList {
+    entities: string[];
+}
+export interface StoryList {
+    /** In flow order — story N implements numbered step N of the main flow. */
+    stories: StoryDraft[];
+}
+/**
+ * A story that CONNECTS two numbered steps of the main flow to each other.
+ *
+ * A {@link StoryDraft} plus an ANCHOR. `after` is not a position in the answer — it is the number
+ * of the FLOW story whose result this one displays, so the consumer interleaves these into flow
+ * order instead of appending them. The flow list is never rewritten or reordered by the call that
+ * produces these.
+ */
+export interface ConnectingStoryDraft extends StoryDraft {
+    kind: ConnectingStoryKind;
+    /** 1-based index into the flow story list that was passed in. Never 0, never past its end. */
+    after: number;
+}
+export interface ConnectingStoryList {
+    stories: ConnectingStoryDraft[];
+}
+/**
+ * One entry of the single ordered story list init persists — the flow interleaved with the
+ * stories that connect it.
+ *
+ * `kind` survives only as far as the consumer that creates the records; nothing downstream of the
+ * story list has ever had a use for it.
+ */
+export interface MergedStoryDraft extends StoryDraft {
+    kind: StoryKind;
+}
+export interface UserStory {
+    story: string;
+    /**
+     * The platform's own code for this story (`US-XXXXX`), when the caller has one.
+     *
+     * Optional because the aggregate is also built in contexts that have no record behind them,
+     * but it is what makes a story's OWNERSHIP comparable: the scaffold stamps every placeholder it
+     * draws with this code, so a develop run that keys its registry by anything else cannot tell
+     * its own reserved placeholder from another story's — which is how one run came to rewrite a
+     * different story's widget.
+     */
+    code?: string;
+    /** The audience acting in this story. Its screens hang under this area's entrypoint. */
+    area: ProjectArea;
+    /**
+     * WHO acts — a person, or one of the application's own machines.
+     *
+     * Optional and defaulting to a person, which is what every story is until a design stage says
+     * otherwise. An ephemeral actor holds no permissions and owns no screen; it still carries an
+     * `area`, because that says which human audience the work is FOR and therefore where its
+     * progress is shown.
+     */
+    actor?: StoryActor;
+    entity: string;
+    entities: Entity[];
+    screens: StoryScreen[];
+}
+export interface StoryScreen {
+    name: string;
+    specs: Record<SpecCategory, string>;
+    description: string;
+    /** The top-menu group this screen belongs to. A label — never a URL segment. */
+    section?: string;
+    components: StoryComponent[];
+}
+export interface StoryComponent {
+    name: string;
+    specs: Record<SpecCategory, string>;
+    description: string;
+    entities: Entity[];
+}
+export interface Entity {
+    name: string;
+    description: string;
+    attributes: Attribute[];
+}
+export interface Attribute {
+    name: string;
+    description: string;
+}
+export interface AgentProject {
+    name: string;
+    description: string;
+    specification: string;
+    designSystem: string;
+    vision: string;
+    /**
+     * The language every piece of generated UI text is written in, as an IETF tag (`en`, `pl`).
+     *
+     * Optional here and required on `ProjectMeta`, because the two answer different questions: a
+     * brief may or may not state a language, while a project on disk always has one — whatever the
+     * screens were written in. The store carries a stated one through and keeps the recorded one
+     * otherwise; nothing re-decides it per pass, since a screen scaffolded in one language and
+     * extended in another compiles, passes its tests, and is a mixed interface.
+     */
+    language?: string;
+}
+export interface MainStoryProbability {
+    story: string;
+    probability: number;
+}
+export interface MainStoryCandidates {
+    candidates: MainStoryProbability[];
+}
+//# sourceMappingURL=types.d.ts.map

package/build/ba/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ba/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEtD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,2EAA2E;IAC3E,OAAO,EAAE,UAAU,EAAE,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,IAAI,EAAE,mBAAmB,CAAA;IACzB,8FAA8F;IAC9F,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,oBAAoB,EAAE,CAAA;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,IAAI,EAAE,SAAS,CAAA;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wFAAwF;IACxF,IAAI,EAAE,WAAW,CAAA;IACjB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,OAAO,EAAE,WAAW,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,cAAc,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,SAAS,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,oBAAoB,EAAE,CAAA;CACnC"}

package/build/ba/types.js

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

package/build/ba/types.js.map

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