@owlmeans/viable-common 0.0.44 → 0.0.45

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

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

package/build/moderation/index.js

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

package/build/moderation/index.js.map

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

package/build/moderation/utils.d.ts

@@ -1,20 +1,8 @@
-import { ModerationCategory } from './consts.js';
+import type { ModerationCategory } from './consts.js';
 import type { ModerationAction, ModerationPolicy, ModerationVerdict } from './types.js';
-/**
- * Narrow whatever the model put in `category` to a real one, or to nothing.
- *
- * The wire field is a free string on purpose — see {@link ModerationVerdictSchema}. A model
- * that is allowing has nothing to categorise and still fills the field, so anything
- * unrecognized is treated as absent rather than as a failure.
- */
+/** @deprecated compat:factory-refactor — use `moderationVerdictHelper.normalizeCategory(…)` */
 export declare const normalizeCategory: (category?: string) => ModerationCategory | undefined;
-/**
- * What to do about a verdict.
- *
- * Pure, because this is the part with the operational levers on it and the part most likely
- * to be wrong in a hurry: `enforce` turns the whole gate into an observer without a deploy,
- * and `bypassEntities` releases one entity when a real customer is wrongly refused.
- */
+/** @deprecated compat:factory-refactor — use `moderationVerdictHelper.decideModeration(…)` */
 export declare const decideModeration: (verdict: ModerationVerdict, policy?: ModerationPolicy & {
     entityId?: string;
 }) => ModerationAction;

package/build/moderation/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/moderation/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEvF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,cAAe,MAAM,KAAG,kBAAkB,GAAG,SAM1E,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,YAClB,iBAAiB,WAAU,gBAAgB,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,KAC3E,gBAOF,CAAA"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/moderation/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAGvF,+FAA+F;AAC/F,eAAO,MAAM,iBAAiB,cAAe,MAAM,KAAG,kBAAkB,GAAG,SACtB,CAAA;AAErD,8FAA8F;AAC9F,eAAO,MAAM,gBAAgB,YAClB,iBAAiB,WAAU,gBAAgB,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,KAC3E,gBAA6E,CAAA"}

package/build/moderation/utils.js

@@ -1,31 +1,6 @@
-import { ModerationCategory } from './consts.js';
-/**
- * Narrow whatever the model put in `category` to a real one, or to nothing.
- *
- * The wire field is a free string on purpose — see {@link ModerationVerdictSchema}. A model
- * that is allowing has nothing to categorise and still fills the field, so anything
- * unrecognized is treated as absent rather than as a failure.
- */
-export const normalizeCategory = (category) => {
-    const values = Object.values(ModerationCategory);
-    return category != null && values.includes(category)
-        ? category
-        : undefined;
-};
-/**
- * What to do about a verdict.
- *
- * Pure, because this is the part with the operational levers on it and the part most likely
- * to be wrong in a hurry: `enforce` turns the whole gate into an observer without a deploy,
- * and `bypassEntities` releases one entity when a real customer is wrongly refused.
- */
-export const decideModeration = (verdict, policy = {}) => {
-    if (verdict.allowed)
-        return 'allow';
-    if (policy.entityId != null && policy.bypassEntities?.includes(policy.entityId) === true)
-        return 'allow';
-    // Defaults to ON: a gate that has to be switched on is a gate that is off in every
-    // environment nobody remembered to configure.
-    return policy.enforce !== false ? 'refuse' : 'shadow';
-};
+import { moderationVerdictHelper } from './verdict.js';
+/** @deprecated compat:factory-refactor — use `moderationVerdictHelper.normalizeCategory(…)` */
+export const normalizeCategory = (category) => moderationVerdictHelper.normalizeCategory(category);
+/** @deprecated compat:factory-refactor — use `moderationVerdictHelper.decideModeration(…)` */
+export const decideModeration = (verdict, policy = {}) => moderationVerdictHelper.decideModeration(verdict, policy);
 //# sourceMappingURL=utils.js.map

package/build/moderation/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/moderation/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGhD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAiB,EAAkC,EAAE;IACrF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAa,CAAA;IAE5D,OAAO,QAAQ,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAClD,CAAC,CAAC,QAA8B;QAChC,CAAC,CAAC,SAAS,CAAA;AACf,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,OAA0B,EAAE,MAAM,GAA6C,EAAE,EAC/D,EAAE;IACpB,IAAI,OAAO,CAAC,OAAO;QAAE,OAAO,OAAO,CAAA;IACnC,IAAI,MAAM,CAAC,QAAQ,IAAI,IAAI,IAAI,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI;QAAE,OAAO,OAAO,CAAA;IAExG,mFAAmF;IACnF,8CAA8C;IAC9C,OAAO,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAA;AACvD,CAAC,CAAA"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/moderation/utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAEtD,+FAA+F;AAC/F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAiB,EAAkC,EAAE,CACrF,uBAAuB,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAA;AAErD,8FAA8F;AAC9F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,OAA0B,EAAE,MAAM,GAA6C,EAAE,EAC/D,EAAE,CAAC,uBAAuB,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA"}

package/build/moderation/verdict/types.d.ts

@@ -0,0 +1,24 @@
+import type { ModerationCategory } from '../consts.js';
+import type { ModerationAction, ModerationPolicy, ModerationVerdict } from '../types.js';
+/** Reading a moderation verdict: its category, and what to do about it. */
+export interface ModerationVerdictHelper {
+    /**
+     * Narrow whatever the model put in `category` to a real one, or to nothing.
+     *
+     * The wire field is a free string on purpose — see {@link ModerationVerdictSchema}. A model
+     * that is allowing has nothing to categorise and still fills the field, so anything
+     * unrecognized is treated as absent rather than as a failure.
+     */
+    normalizeCategory: (category?: string) => ModerationCategory | undefined;
+    /**
+     * What to do about a verdict.
+     *
+     * Pure, because this is the part with the operational levers on it and the part most likely
+     * to be wrong in a hurry: `enforce` turns the whole gate into an observer without a deploy,
+     * and `bypassEntities` releases one entity when a real customer is wrongly refused.
+     */
+    decideModeration: (verdict: ModerationVerdict, policy?: ModerationPolicy & {
+        entityId?: string;
+    }) => ModerationAction;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/moderation/verdict/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/moderation/verdict/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAExF,2EAA2E;AAC3E,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,iBAAiB,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,kBAAkB,GAAG,SAAS,CAAA;IACxE;;;;;;OAMG;IACH,gBAAgB,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,gBAAgB,CAAA;CACtH"}

package/build/moderation/verdict/types.js

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

package/build/moderation/verdict/types.js.map

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

package/build/moderation/verdict.d.ts

@@ -0,0 +1,4 @@
+import type { ModerationVerdictHelper } from './verdict/types.js';
+export declare const createModerationVerdictHelper: () => ModerationVerdictHelper;
+export declare const moderationVerdictHelper: ModerationVerdictHelper;
+//# sourceMappingURL=verdict.d.ts.map

package/build/moderation/verdict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict.d.ts","sourceRoot":"","sources":["../../src/moderation/verdict.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAEjE,eAAO,MAAM,6BAA6B,QAAO,uBAqBhD,CAAA;AAED,eAAO,MAAM,uBAAuB,yBAAkC,CAAA"}

package/build/moderation/verdict.js

@@ -0,0 +1,21 @@
+import { ModerationCategory } from './consts.js';
+export const createModerationVerdictHelper = () => {
+    const normalizeCategory = (category) => {
+        const values = Object.values(ModerationCategory);
+        return category != null && values.includes(category)
+            ? category
+            : undefined;
+    };
+    const decideModeration = (verdict, policy = {}) => {
+        if (verdict.allowed)
+            return 'allow';
+        if (policy.entityId != null && policy.bypassEntities?.includes(policy.entityId) === true)
+            return 'allow';
+        // Defaults to ON: a gate that has to be switched on is a gate that is off in every
+        // environment nobody remembered to configure.
+        return policy.enforce !== false ? 'refuse' : 'shadow';
+    };
+    return { normalizeCategory, decideModeration };
+};
+export const moderationVerdictHelper = createModerationVerdictHelper();
+//# sourceMappingURL=verdict.js.map

package/build/moderation/verdict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict.js","sourceRoot":"","sources":["../../src/moderation/verdict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAIhD,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAA4B,EAAE;IACzE,MAAM,iBAAiB,GAAG,CAAC,QAAiB,EAAkC,EAAE;QAC9E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAa,CAAA;QAE5D,OAAO,QAAQ,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAClD,CAAC,CAAC,QAA8B;YAChC,CAAC,CAAC,SAAS,CAAA;IACf,CAAC,CAAA;IAED,MAAM,gBAAgB,GAAG,CACvB,OAA0B,EAAE,MAAM,GAA6C,EAAE,EAC/D,EAAE;QACpB,IAAI,OAAO,CAAC,OAAO;YAAE,OAAO,OAAO,CAAA;QACnC,IAAI,MAAM,CAAC,QAAQ,IAAI,IAAI,IAAI,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI;YAAE,OAAO,OAAO,CAAA;QAExG,mFAAmF;QACnF,8CAA8C;QAC9C,OAAO,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAA;IACvD,CAAC,CAAA;IAED,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,CAAA;AAChD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,6BAA6B,EAAE,CAAA"}

package/build/planning/card/types.d.ts

@@ -0,0 +1,42 @@
+import type { Workcard } from '@owlmeans/planning';
+import type { StoryDraft } from '../../areas/types.js';
+import type { UserStory } from '../../ba/types.js';
+import type { StoryDesign } from '../../design/types.js';
+import type { StoryWriteInput } from '../../metadata/types.js';
+import type { StoryWriteContent, ViableProjectCard, ViableProjectFields, ViableStoryCard, ViableStoryFields } from '../types.js';
+/** Reading Viable's planning cards — a project, a user story — and what a write carries. */
+export interface ViableCardHelper {
+    /** A `viable:project` card — kind AND type, since a foreign provider may share either alone. */
+    isViableProject: (card?: Workcard | null) => card is ViableProjectCard;
+    /** A `viable:user-story` card. */
+    isViableStory: (card?: Workcard | null) => card is ViableStoryCard;
+    /** Whether a write came from a person (`web`, `connect`) rather than the platform's own runs. */
+    isUserChannel: (channel?: string | null) => boolean;
+    projectFieldsOf: (card: Workcard) => ViableProjectFields;
+    /**
+     * A story card's fields, with the two required ones always answered.
+     *
+     * An absent area reads as `guest` — the area that guards nothing — and an absent primary flag as
+     * `false`, so a reader never branches on a card written by a store that dropped them.
+     */
+    storyFieldsOf: (card: Workcard) => ViableStoryFields;
+    /** The draft shape the analysis prompts and moderation take, from a card. */
+    storyDraftOf: (card: Workcard) => StoryDraft;
+    /**
+     * The aggregate the coders take, for a story CARD.
+     *
+     * The card wins on the narrative, the code, the area and the actor — a person may have changed any
+     * of them since the design was written. The design supplies what only it knows: the entities and
+     * the screens. Without a design the aggregate has no screens yet.
+     */
+    userStoryOf: (card: Workcard, design?: StoryDesign | null) => UserStory;
+    /**
+     * What the metadata store writes to `docs/stories/<code>.md`, from the card and a run's content.
+     *
+     * The CODE is the target's only story identifier — a card id never reaches a target file — so a
+     * story card without one is refused rather than filed under its id. The landing flag is carried
+     * only when it is set, so every other story's frontmatter keeps the shape it always had.
+     */
+    storyWriteInputOf: (card: Workcard, content: StoryWriteContent) => StoryWriteInput;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/planning/card/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/planning/card/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,KAAK,EACV,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,EAAE,iBAAiB,EAC9F,MAAM,aAAa,CAAA;AAEpB,4FAA4F;AAC5F,MAAM,WAAW,gBAAgB;IAC/B,gGAAgG;IAChG,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,IAAI,iBAAiB,CAAA;IACtE,kCAAkC;IAClC,aAAa,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,IAAI,eAAe,CAAA;IAClE,iGAAiG;IACjG,aAAa,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAA;IACnD,eAAe,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,mBAAmB,CAAA;IACxD;;;;;OAKG;IACH,aAAa,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,iBAAiB,CAAA;IACpD,6EAA6E;IAC7E,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,UAAU,CAAA;IAC5C;;;;;;OAMG;IACH,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,KAAK,SAAS,CAAA;IACvE;;;;;;OAMG;IACH,iBAAiB,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,KAAK,eAAe,CAAA;CACnF"}

package/build/planning/card/types.js

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

package/build/planning/card/types.js.map

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

package/build/planning/card.d.ts

@@ -0,0 +1,4 @@
+import type { ViableCardHelper } from './card/types.js';
+export declare const createViableCardHelper: () => ViableCardHelper;
+export declare const viableCardHelper: ViableCardHelper;
+//# sourceMappingURL=card.d.ts.map

package/build/planning/card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../src/planning/card.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,eAAO,MAAM,sBAAsB,QAAO,gBA2DzC,CAAA;AAED,eAAO,MAAM,gBAAgB,kBAA2B,CAAA"}

package/build/planning/card.js

@@ -0,0 +1,51 @@
+import { WorkcardKind } from '@owlmeans/planning';
+import { ProjectArea } from '../areas/consts.js';
+import { storyDesignHelper } from '../design/story.js';
+import { VIABLE_PROJECT_TYPE, VIABLE_STORY_TYPE, VIABLE_USER_CHANNELS } from './consts.js';
+import { ProjectStoryMissconfigured } from './errors.js';
+export const createViableCardHelper = () => {
+    const isViableProject = (card) => card != null && card.kind === WorkcardKind.Project && card.type === VIABLE_PROJECT_TYPE;
+    const isViableStory = (card) => card != null && card.kind === WorkcardKind.Card && card.type === VIABLE_STORY_TYPE;
+    const isUserChannel = (channel) => channel != null && VIABLE_USER_CHANNELS.includes(channel);
+    const projectFieldsOf = (card) => (card.fields ?? {});
+    const storyFieldsOf = (card) => {
+        const fields = (card.fields ?? {});
+        return { ...fields, area: fields.area ?? ProjectArea.Guest, primary: fields.primary === true };
+    };
+    const storyDraftOf = (card) => ({ story: card.title, area: storyFieldsOf(card).area });
+    const userStoryOf = (card, design) => {
+        const fields = storyFieldsOf(card);
+        const base = design != null
+            ? storyDesignHelper.userStoryOfDesign(design)
+            : { story: card.title, area: fields.area, entity: null, entities: [], screens: [] };
+        const code = card.code ?? base.code;
+        return {
+            ...base,
+            story: card.title,
+            ...(code != null ? { code } : {}),
+            area: fields.area,
+            ...(fields.actor != null ? { actor: fields.actor } : {}),
+        };
+    };
+    const storyWriteInputOf = (card, content) => {
+        if (card.code == null || card.code === '') {
+            throw new ProjectStoryMissconfigured('no-code');
+        }
+        const { status, ...rest } = content;
+        const fields = storyFieldsOf(card);
+        return {
+            ...rest,
+            code: card.code,
+            narrative: card.title,
+            status: status ?? card.status,
+            primary: fields.primary,
+            ...(fields.landing === true ? { landing: true } : {}),
+        };
+    };
+    return {
+        isViableProject, isViableStory, isUserChannel, projectFieldsOf, storyFieldsOf, storyDraftOf, userStoryOf,
+        storyWriteInputOf,
+    };
+};
+export const viableCardHelper = createViableCardHelper();
+//# sourceMappingURL=card.js.map

package/build/planning/card.js.map

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

package/build/planning/helpers.d.ts

@@ -4,52 +4,26 @@ import type { AgentProject, UserStory } from '../ba/types.js';
 import type { StoryDesign } from '../design/types.js';
 import type { StoryWriteInput } from '../metadata/types.js';
 import type { StoryWriteContent, ViableProjectCard, ViableProjectFields, ViableStoryCard, ViableStoryFields } from './types.js';
-/** A `viable:project` card — kind AND type, since a foreign provider may share either alone. */
+/** @deprecated compat:factory-refactor — use `viableCardHelper.isViableProject(…)` */
 export declare const isViableProject: (card?: Workcard | null) => card is ViableProjectCard;
-/** A `viable:user-story` card. */
+/** @deprecated compat:factory-refactor — use `viableCardHelper.isViableStory(…)` */
 export declare const isViableStory: (card?: Workcard | null) => card is ViableStoryCard;
-/** Whether a write came from a person (`web`, `connect`) rather than the platform's own runs. */
+/** @deprecated compat:factory-refactor — use `viableCardHelper.isUserChannel(…)` */
 export declare const isUserChannel: (channel?: string | null) => boolean;
+/** @deprecated compat:factory-refactor — use `viableCardHelper.projectFieldsOf(…)` */
 export declare const projectFieldsOf: (card: Workcard) => ViableProjectFields;
-/**
- * A story card's fields, with the two required ones always answered.
- *
- * An absent area reads as `guest` — the area that guards nothing — and an absent primary flag as
- * `false`, so a reader never branches on a card written by a store that dropped them.
- */
+/** @deprecated compat:factory-refactor — use `viableCardHelper.storyFieldsOf(…)` */
 export declare const storyFieldsOf: (card: Workcard) => ViableStoryFields;
-/** The draft shape the analysis prompts and moderation take, from a card. */
+/** @deprecated compat:factory-refactor — use `viableCardHelper.storyDraftOf(…)` */
 export declare const storyDraftOf: (card: Workcard) => StoryDraft;
-/**
- * The aggregate the coders take, for a story CARD.
- *
- * The card wins on the narrative, the code, the area and the actor — a person may have changed any
- * of them since the design was written. The design supplies what only it knows: the entities and
- * the screens. Without a design the aggregate has no screens yet.
- */
+/** @deprecated compat:factory-refactor — use `viableCardHelper.userStoryOf(…)` */
 export declare const userStoryOf: (card: Workcard, design?: StoryDesign | null) => UserStory;
-/**
- * The current document of one category among a card's specifications.
- *
- * The highest revision wins, then the most recently updated; a category nobody wrote answers
- * `null`.
- */
+/** @deprecated compat:factory-refactor — use `viableSpecHelper.currentSpecOf(…)` */
 export declare const currentSpecOf: (specs: readonly Specification[], category: string) => Specification | null;
-/** The body of a category's current document, `''` when there is none. */
+/** @deprecated compat:factory-refactor — use `viableSpecHelper.currentSpecBody(…)` */
 export declare const currentSpecBody: (specs: readonly Specification[], category: string) => string;
-/**
- * The brief a generator reads, assembled from the project card and its specifications.
- *
- * `name` is the card's title and `alias` its code; a brief part nobody wrote is `''`, which is
- * what every prompt already treats as "not stated".
- */
+/** @deprecated compat:factory-refactor — use `viableSpecHelper.projectBriefOf(…)` */
 export declare const projectBriefOf: (project: Workcard, specs: readonly Specification[]) => AgentProject;
-/**
- * What the metadata store writes to `docs/stories/<code>.md`, from the card and a run's content.
- *
- * The CODE is the target's only story identifier — a card id never reaches a target file — so a
- * story card without one is refused rather than filed under its id. The landing flag is carried
- * only when it is set, so every other story's frontmatter keeps the shape it always had.
- */
+/** @deprecated compat:factory-refactor — use `viableCardHelper.storyWriteInputOf(…)` */
 export declare const storyWriteInputOf: (card: Workcard, content: StoryWriteContent) => StoryWriteInput;
 //# sourceMappingURL=helpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/planning/helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAEjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAK3D,OAAO,KAAK,EACV,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,EAAE,iBAAiB,EAC9F,MAAM,YAAY,CAAA;AAEnB,gGAAgG;AAChG,eAAO,MAAM,eAAe,UAAW,QAAQ,GAAG,IAAI,KAAG,IAAI,IAAI,iBACwB,CAAA;AAEzF,kCAAkC;AAClC,eAAO,MAAM,aAAa,UAAW,QAAQ,GAAG,IAAI,KAAG,IAAI,IAAI,eACqB,CAAA;AAEpF,iGAAiG;AACjG,eAAO,MAAM,aAAa,aAAc,MAAM,GAAG,IAAI,KAAG,OACG,CAAA;AAE3D,eAAO,MAAM,eAAe,SAAU,QAAQ,KAAG,mBACL,CAAA;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,aAAa,SAAU,QAAQ,KAAG,iBAI9C,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,YAAY,SAAU,QAAQ,KAAG,UACW,CAAA;AAEzD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,SAAU,QAAQ,WAAW,WAAW,GAAG,IAAI,KAAG,SAczE,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,UACjB,SAAS,aAAa,EAAE,YAAY,MAAM,KAChD,aAAa,GAAG,IASP,CAAA;AAEZ,0EAA0E;AAC1E,eAAO,MAAM,eAAe,UAAW,SAAS,aAAa,EAAE,YAAY,MAAM,KAAG,MACxC,CAAA;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,cAAc,YAAa,QAAQ,SAAS,SAAS,aAAa,EAAE,KAAG,YAYnF,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,SAAU,QAAQ,WAAW,iBAAiB,KAAG,eAe9E,CAAA"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/planning/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAG3D,OAAO,KAAK,EACV,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,EAAE,iBAAiB,EAC9F,MAAM,YAAY,CAAA;AAEnB,sFAAsF;AACtF,eAAO,MAAM,eAAe,UAAW,QAAQ,GAAG,IAAI,KAAG,IAAI,IAAI,iBAA2D,CAAA;AAE5H,oFAAoF;AACpF,eAAO,MAAM,aAAa,UAAW,QAAQ,GAAG,IAAI,KAAG,IAAI,IAAI,eAAuD,CAAA;AAEtH,oFAAoF;AACpF,eAAO,MAAM,aAAa,aAAc,MAAM,GAAG,IAAI,KAAG,OAAkD,CAAA;AAE1G,sFAAsF;AACtF,eAAO,MAAM,eAAe,SAAU,QAAQ,KAAG,mBAA6D,CAAA;AAE9G,oFAAoF;AACpF,eAAO,MAAM,aAAa,SAAU,QAAQ,KAAG,iBAAyD,CAAA;AAExG,mFAAmF;AACnF,eAAO,MAAM,YAAY,SAAU,QAAQ,KAAG,UAAiD,CAAA;AAE/F,kFAAkF;AAClF,eAAO,MAAM,WAAW,SAAU,QAAQ,WAAW,WAAW,GAAG,IAAI,KAAG,SAC9B,CAAA;AAE5C,oFAAoF;AACpF,eAAO,MAAM,aAAa,UAAW,SAAS,aAAa,EAAE,YAAY,MAAM,KAAG,aAAa,GAAG,IACjD,CAAA;AAEjD,sFAAsF;AACtF,eAAO,MAAM,eAAe,UAAW,SAAS,aAAa,EAAE,YAAY,MAAM,KAAG,MACjC,CAAA;AAEnD,qFAAqF;AACrF,eAAO,MAAM,cAAc,YAAa,QAAQ,SAAS,SAAS,aAAa,EAAE,KAAG,YACnC,CAAA;AAEjD,wFAAwF;AACxF,eAAO,MAAM,iBAAiB,SAAU,QAAQ,WAAW,iBAAiB,KAAG,eAC5B,CAAA"}

package/build/planning/helpers.js

@@ -1,104 +1,25 @@
-import { WorkcardKind } from '@owlmeans/planning';
-import { ProjectArea } from '../areas/consts.js';
-import { userStoryOfDesign } from '../design/helpers.js';
-import { VIABLE_PROJECT_TYPE, VIABLE_STORY_TYPE, VIABLE_USER_CHANNELS, ViableSpecCategory, } from './consts.js';
-import { ProjectStoryMissconfigured } from './errors.js';
-/** A `viable:project` card — kind AND type, since a foreign provider may share either alone. */
-export const isViableProject = (card) => card != null && card.kind === WorkcardKind.Project && card.type === VIABLE_PROJECT_TYPE;
-/** A `viable:user-story` card. */
-export const isViableStory = (card) => card != null && card.kind === WorkcardKind.Card && card.type === VIABLE_STORY_TYPE;
-/** Whether a write came from a person (`web`, `connect`) rather than the platform's own runs. */
-export const isUserChannel = (channel) => channel != null && VIABLE_USER_CHANNELS.includes(channel);
-export const projectFieldsOf = (card) => (card.fields ?? {});
-/**
- * A story card's fields, with the two required ones always answered.
- *
- * An absent area reads as `guest` — the area that guards nothing — and an absent primary flag as
- * `false`, so a reader never branches on a card written by a store that dropped them.
- */
-export const storyFieldsOf = (card) => {
-    const fields = (card.fields ?? {});
-    return { ...fields, area: fields.area ?? ProjectArea.Guest, primary: fields.primary === true };
-};
-/** The draft shape the analysis prompts and moderation take, from a card. */
-export const storyDraftOf = (card) => ({ story: card.title, area: storyFieldsOf(card).area });
-/**
- * The aggregate the coders take, for a story CARD.
- *
- * The card wins on the narrative, the code, the area and the actor — a person may have changed any
- * of them since the design was written. The design supplies what only it knows: the entities and
- * the screens. Without a design the aggregate has no screens yet.
- */
-export const userStoryOf = (card, design) => {
-    const fields = storyFieldsOf(card);
-    const base = design != null
-        ? userStoryOfDesign(design)
-        : { story: card.title, area: fields.area, entity: null, entities: [], screens: [] };
-    const code = card.code ?? base.code;
-    return {
-        ...base,
-        story: card.title,
-        ...(code != null ? { code } : {}),
-        area: fields.area,
-        ...(fields.actor != null ? { actor: fields.actor } : {}),
-    };
-};
-/**
- * The current document of one category among a card's specifications.
- *
- * The highest revision wins, then the most recently updated; a category nobody wrote answers
- * `null`.
- */
-export const currentSpecOf = (specs, category) => specs
-    .filter(spec => spec.category === category)
-    .reduce((best, spec) => {
-    if (best == null)
-        return spec;
-    const byRevision = (spec.revision ?? 0) - (best.revision ?? 0);
-    if (byRevision !== 0)
-        return byRevision > 0 ? spec : best;
-    return (spec.updatedAt ?? spec.createdAt) > (best.updatedAt ?? best.createdAt) ? spec : best;
-}, null);
-/** The body of a category's current document, `''` when there is none. */
-export const currentSpecBody = (specs, category) => currentSpecOf(specs, category)?.body ?? '';
-/**
- * The brief a generator reads, assembled from the project card and its specifications.
- *
- * `name` is the card's title and `alias` its code; a brief part nobody wrote is `''`, which is
- * what every prompt already treats as "not stated".
- */
-export const projectBriefOf = (project, specs) => {
-    const { language } = projectFieldsOf(project);
-    return {
-        name: project.title,
-        ...(project.code != null ? { alias: project.code } : {}),
-        description: project.description ?? '',
-        specification: currentSpecBody(specs, ViableSpecCategory.Specification),
-        designSystem: currentSpecBody(specs, ViableSpecCategory.DesignSystem),
-        vision: currentSpecBody(specs, ViableSpecCategory.Vision),
-        ...(language != null ? { language } : {}),
-    };
-};
-/**
- * What the metadata store writes to `docs/stories/<code>.md`, from the card and a run's content.
- *
- * The CODE is the target's only story identifier — a card id never reaches a target file — so a
- * story card without one is refused rather than filed under its id. The landing flag is carried
- * only when it is set, so every other story's frontmatter keeps the shape it always had.
- */
-export const storyWriteInputOf = (card, content) => {
-    if (card.code == null || card.code === '') {
-        throw new ProjectStoryMissconfigured('no-code');
-    }
-    const { status, ...rest } = content;
-    const fields = storyFieldsOf(card);
-    return {
-        ...rest,
-        code: card.code,
-        narrative: card.title,
-        status: status ?? card.status,
-        primary: fields.primary,
-        ...(fields.landing === true ? { landing: true } : {}),
-    };
-};
+import { viableCardHelper } from './card.js';
+import { viableSpecHelper } from './spec.js';
+/** @deprecated compat:factory-refactor — use `viableCardHelper.isViableProject(…)` */
+export const isViableProject = (card) => viableCardHelper.isViableProject(card);
+/** @deprecated compat:factory-refactor — use `viableCardHelper.isViableStory(…)` */
+export const isViableStory = (card) => viableCardHelper.isViableStory(card);
+/** @deprecated compat:factory-refactor — use `viableCardHelper.isUserChannel(…)` */
+export const isUserChannel = (channel) => viableCardHelper.isUserChannel(channel);
+/** @deprecated compat:factory-refactor — use `viableCardHelper.projectFieldsOf(…)` */
+export const projectFieldsOf = (card) => viableCardHelper.projectFieldsOf(card);
+/** @deprecated compat:factory-refactor — use `viableCardHelper.storyFieldsOf(…)` */
+export const storyFieldsOf = (card) => viableCardHelper.storyFieldsOf(card);
+/** @deprecated compat:factory-refactor — use `viableCardHelper.storyDraftOf(…)` */
+export const storyDraftOf = (card) => viableCardHelper.storyDraftOf(card);
+/** @deprecated compat:factory-refactor — use `viableCardHelper.userStoryOf(…)` */
+export const userStoryOf = (card, design) => viableCardHelper.userStoryOf(card, design);
+/** @deprecated compat:factory-refactor — use `viableSpecHelper.currentSpecOf(…)` */
+export const currentSpecOf = (specs, category) => viableSpecHelper.currentSpecOf(specs, category);
+/** @deprecated compat:factory-refactor — use `viableSpecHelper.currentSpecBody(…)` */
+export const currentSpecBody = (specs, category) => viableSpecHelper.currentSpecBody(specs, category);
+/** @deprecated compat:factory-refactor — use `viableSpecHelper.projectBriefOf(…)` */
+export const projectBriefOf = (project, specs) => viableSpecHelper.projectBriefOf(project, specs);
+/** @deprecated compat:factory-refactor — use `viableCardHelper.storyWriteInputOf(…)` */
+export const storyWriteInputOf = (card, content) => viableCardHelper.storyWriteInputOf(card, content);
 //# sourceMappingURL=helpers.js.map

package/build/planning/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/planning/helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/planning/helpers.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAK5C,sFAAsF;AACtF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAsB,EAA6B,EAAE,CAAC,gBAAgB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;AAE5H,oFAAoF;AACpF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAsB,EAA2B,EAAE,CAAC,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;AAEtH,oFAAoF;AACpF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAuB,EAAW,EAAE,CAAC,gBAAgB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;AAE1G,sFAAsF;AACtF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAc,EAAuB,EAAE,CAAC,gBAAgB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;AAE9G,oFAAoF;AACpF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAc,EAAqB,EAAE,CAAC,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;AAExG,mFAAmF;AACnF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAc,EAAc,EAAE,CAAC,gBAAgB,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;AAE/F,kFAAkF;AAClF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAc,EAAE,MAA2B,EAAa,EAAE,CACpF,gBAAgB,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;AAE5C,oFAAoF;AACpF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAA+B,EAAE,QAAgB,EAAwB,EAAE,CACvG,gBAAgB,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AAEjD,sFAAsF;AACtF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAA+B,EAAE,QAAgB,EAAU,EAAE,CAC3F,gBAAgB,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AAEnD,qFAAqF;AACrF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAiB,EAAE,KAA+B,EAAgB,EAAE,CACjG,gBAAgB,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;AAEjD,wFAAwF;AACxF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAc,EAAE,OAA0B,EAAmB,EAAE,CAC/F,gBAAgB,CAAC,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA"}

package/build/planning/index.d.ts

@@ -1,7 +1,12 @@
 export * from './consts.js';
 export * from './errors.js';
 export * from './schemas.js';
+export * from './card.js';
+export * from './spec.js';
 export * from './helpers.js';
 export * from './landing.js';
 export type * from './types.js';
+export type * from './card/types.js';
+export type * from './spec/types.js';
+export type * from './landing/types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/planning/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,mBAAmB,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/planning/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,iBAAiB,CAAA;AACpC,mBAAmB,iBAAiB,CAAA;AACpC,mBAAmB,oBAAoB,CAAA"}

package/build/planning/index.js

@@ -1,6 +1,8 @@
 export * from './consts.js';
 export * from './errors.js';
 export * from './schemas.js';
+export * from './card.js';
+export * from './spec.js';
 export * from './helpers.js';
 export * from './landing.js';
 //# sourceMappingURL=index.js.map

package/build/planning/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/planning/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/planning/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/build/planning/landing/types.d.ts

@@ -0,0 +1,16 @@
+/** The landing sentence a landing-gate story's narrative carries. */
+export interface LandingSentenceHelper {
+    /** Whether a narrative already carries the landing sentence, whatever whitespace surrounds it. */
+    hasLandingSentence: (title: string) => boolean;
+    /**
+     * The narrative with the landing sentence appended once.
+     *
+     * Idempotent — a narrative that already carries the sentence comes back unchanged, so a decision
+     * step that is resumed after it wrote the card never appends a second copy. It never produces a
+     * title longer than a card accepts (`TITLE_MAX`): a narrative with no room left is returned as it
+     * is rather than cut, because a person's words are worth more than the note, and the flag on the
+     * card still carries the fact.
+     */
+    withLandingSentence: (title: string) => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/planning/landing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/planning/landing/types.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,kGAAkG;IAClG,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;IAC9C;;;;;;;;OAQG;IACH,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;CAC/C"}

package/build/planning/landing/types.js

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

package/build/planning/landing/types.js.map

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

package/build/planning/landing.d.ts

@@ -1,13 +1,8 @@
-/** Whether a narrative already carries the landing sentence, whatever whitespace surrounds it. */
+import type { LandingSentenceHelper } from './landing/types.js';
+export declare const createLandingSentenceHelper: () => LandingSentenceHelper;
+export declare const landingSentenceHelper: LandingSentenceHelper;
+/** @deprecated compat:factory-refactor — use `landingSentenceHelper.hasLandingSentence(…)` */
 export declare const hasLandingSentence: (title: string) => boolean;
-/**
- * The narrative with the landing sentence appended once.
- *
- * Idempotent — a narrative that already carries the sentence comes back unchanged, so a decision
- * step that is resumed after it wrote the card never appends a second copy. It never produces a
- * title longer than a card accepts (`TITLE_MAX`): a narrative with no room left is returned as it
- * is rather than cut, because a person's words are worth more than the note, and the flag on the
- * card still carries the fact.
- */
+/** @deprecated compat:factory-refactor — use `landingSentenceHelper.withLandingSentence(…)` */
 export declare const withLandingSentence: (title: string) => string;
 //# sourceMappingURL=landing.d.ts.map