@owlmeans/viable-common 0.0.18 → 0.0.20

package/build/planning/consts.js

@@ -0,0 +1,170 @@
+import { CodeScope, CodeStyle } from '@owlmeans/planning';
+/**
+ * The OwlMeans Viable vocabulary over `@owlmeans/planning`.
+ *
+ * A project, a user story and the documents behind them are planning WORKCARDS of the types
+ * declared here. Everything generic — the record, the transition, the fold, the store, the protocol
+ * tree — belongs to the planning packages; what a Viable project or story IS, which statuses it
+ * moves through and which documents it carries, is declared once in this module and read by every
+ * runtime that writes one.
+ */
+/** A Viable project — the card every story, document and platform record of a product hangs under. */
+export const VIABLE_PROJECT_TYPE = 'viable:project';
+/** A user story — the unit of development a person starts. */
+export const VIABLE_STORY_TYPE = 'viable:user-story';
+/** Every document a project or story card carries (specification, vision, design system, plans). */
+export const VIABLE_SPEC_TYPE = 'viable:spec';
+/**
+ * Reserved card types. Declared in full so their code prefix and flow are decided once, and
+ * deliberately absent from the project type's `cardTypes`: nothing may create one yet.
+ */
+export const VIABLE_BUG_TYPE = 'viable:bug';
+export const VIABLE_IMPROVEMENT_TYPE = 'viable:improvement';
+export const VIABLE_REQUIREMENT_TYPE = 'viable:requirement';
+export const VIABLE_PROJECT_FLOW = 'viable:project';
+export const VIABLE_STORY_FLOW = 'viable:user-story';
+/** The one-status flow a document runs — a specification has no lifecycle of its own. */
+export const VIABLE_SPEC_FLOW = 'viable:spec';
+/**
+ * The story flow's status keys.
+ *
+ * Byte-identical to the strings a story has always carried — the frontmatter of
+ * `docs/stories/<code>.md`, the connector's job status mapping, the board's columns, their i18n
+ * keys and every end-to-end selector read these exact values. A key is a wire contract and is
+ * never renamed.
+ */
+export var ViableStoryStatus;
+(function (ViableStoryStatus) {
+    ViableStoryStatus["Planned"] = "planned";
+    ViableStoryStatus["InProgress"] = "in-progress";
+    ViableStoryStatus["Completed"] = "completed";
+    /** Intrinsically PLANNED: a failed story is work still to do, and retrying it is `start`. */
+    ViableStoryStatus["Failed"] = "failed";
+})(ViableStoryStatus || (ViableStoryStatus = {}));
+export var ViableStoryTransition;
+(function (ViableStoryTransition) {
+    /** `planned | failed → in-progress` — the only move that asks for development. */
+    ViableStoryTransition["Start"] = "start";
+    ViableStoryTransition["Complete"] = "complete";
+    ViableStoryTransition["Fail"] = "fail";
+    /** `* → planned` — the manual recovery, and the one move a completed story still accepts. */
+    ViableStoryTransition["Reset"] = "reset";
+})(ViableStoryTransition || (ViableStoryTransition = {}));
+export var ViableProjectStatus;
+(function (ViableProjectStatus) {
+    /** Created from a prompt, specification drafted, nothing provisioned. */
+    ViableProjectStatus["Draft"] = "draft";
+    /** The owner confirmed the brief; initialization is running or has run. */
+    ViableProjectStatus["Confirmed"] = "confirmed";
+    /** Initialization finished at least once. */
+    ViableProjectStatus["Active"] = "active";
+    ViableProjectStatus["Archived"] = "archived";
+})(ViableProjectStatus || (ViableProjectStatus = {}));
+export var ViableProjectTransition;
+(function (ViableProjectTransition) {
+    ViableProjectTransition["Confirm"] = "confirm";
+    ViableProjectTransition["Activate"] = "activate";
+    ViableProjectTransition["Archive"] = "archive";
+    ViableProjectTransition["Reopen"] = "reopen";
+})(ViableProjectTransition || (ViableProjectTransition = {}));
+/** The single status a document holds. */
+export var ViableSpecStatus;
+(function (ViableSpecStatus) {
+    ViableSpecStatus["Current"] = "current";
+})(ViableSpecStatus || (ViableSpecStatus = {}));
+/** The palette key a board renders a status with. Presentation data, carried on the flow. */
+export var ViableTone;
+(function (ViableTone) {
+    ViableTone["Blue"] = "blue";
+    ViableTone["Yellow"] = "yellow";
+    ViableTone["Green"] = "green";
+    ViableTone["Red"] = "red";
+    ViableTone["Neutral"] = "neutral";
+})(ViableTone || (ViableTone = {}));
+/**
+ * The specification slots Viable cards carry.
+ *
+ * Project: `specification`, `vision`, `design-system` (the brief) and `scaffold` (the drawn plan).
+ * Story: `design`. The co-located `*.spec/.ux/.ui.md` files of a target are FILES, not slots — that
+ * prose already lives inside the `design` payload — so `SpecCategory` is not a slot vocabulary.
+ */
+export var ViableSpecCategory;
+(function (ViableSpecCategory) {
+    ViableSpecCategory["Specification"] = "specification";
+    ViableSpecCategory["Vision"] = "vision";
+    ViableSpecCategory["DesignSystem"] = "design-system";
+    ViableSpecCategory["Scaffold"] = "scaffold";
+    ViableSpecCategory["Design"] = "design";
+})(ViableSpecCategory || (ViableSpecCategory = {}));
+/** How many revisions of a `design` or `scaffold` document the history must be able to answer. */
+export const VIABLE_DESIGN_REVISIONS_KEPT = 3;
+/**
+ * Relationship types between story cards.
+ *
+ * `follows` is WRITTEN: a connective story follows the flow story it was anchored after, created in
+ * the same transition as the card. `shares-widget` and `shares-screen` are DECLARED ONLY — the
+ * `scaffold` specification is their single authority, and a second copy as links would be a second
+ * answer that can disagree with it.
+ */
+export var ViableRelationship;
+(function (ViableRelationship) {
+    ViableRelationship["Follows"] = "follows";
+    ViableRelationship["SharesWidget"] = "shares-widget";
+    ViableRelationship["SharesScreen"] = "shares-screen";
+})(ViableRelationship || (ViableRelationship = {}));
+/**
+ * Where a write came from, carried on `PlanningScope.channel` and recorded on the transition's
+ * `actor.channel`.
+ *
+ * It is never read from the wire: the manager API derives `Connect` from an access-token request
+ * and `Web` from everything else; the agent writes as `Agent` or `Pipeline`. Three rules key on it
+ * — the balance refusal class (`ConnectOutOfCredits` for `Connect`), re-formatting a narrative
+ * (`Web`/`Connect` only), and the develop trigger (a committed `start` by `Web`/`Connect` only).
+ */
+export var ViableChannel;
+(function (ViableChannel) {
+    ViableChannel["Web"] = "web";
+    ViableChannel["Connect"] = "connect";
+    ViableChannel["Agent"] = "agent";
+    ViableChannel["Pipeline"] = "pipeline";
+})(ViableChannel || (ViableChannel = {}));
+/** The channels a PERSON writes through. */
+export const VIABLE_USER_CHANNELS = Object.freeze([
+    ViableChannel.Web, ViableChannel.Connect,
+]);
+export const VIABLE_STORY_CODE_PREFIX = 'US-';
+export const VIABLE_BUG_CODE_PREFIX = 'BUG-';
+export const VIABLE_IMPROVEMENT_CODE_PREFIX = 'IMP-';
+export const VIABLE_REQUIREMENT_CODE_PREFIX = 'REQ-';
+export const VIABLE_CARD_CODE_LENGTH = 5;
+/** `US-` + five uppercase characters, unique within the project. The code a target is keyed by. */
+export const VIABLE_STORY_CODE = Object.freeze({
+    prefix: VIABLE_STORY_CODE_PREFIX,
+    style: CodeStyle.Random,
+    length: VIABLE_CARD_CODE_LENGTH,
+    uppercase: true,
+    uniqueWithin: CodeScope.Parent,
+});
+/**
+ * A project's code is its alias — a slug unique within the organization.
+ *
+ * Minted by the platform's name ladder, which knows about retired aliases and refused hostnames;
+ * a code policy only guards uniqueness, so a create always supplies the code.
+ */
+export const VIABLE_PROJECT_CODE = Object.freeze({
+    style: CodeStyle.Slug,
+    uniqueWithin: CodeScope.Entity,
+    // The alias moves: a rename changes it, and a refused preview certificate walks it to `alias-2`.
+    // A story code never moves — the target's files are named after it.
+    mutable: true,
+});
+export const VIABLE_BUG_CODE = Object.freeze({
+    ...VIABLE_STORY_CODE, prefix: VIABLE_BUG_CODE_PREFIX,
+});
+export const VIABLE_IMPROVEMENT_CODE = Object.freeze({
+    ...VIABLE_STORY_CODE, prefix: VIABLE_IMPROVEMENT_CODE_PREFIX,
+});
+export const VIABLE_REQUIREMENT_CODE = Object.freeze({
+    ...VIABLE_STORY_CODE, prefix: VIABLE_REQUIREMENT_CODE_PREFIX,
+});
+//# sourceMappingURL=consts.js.map

package/build/planning/consts.js.map

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

package/build/planning/errors.d.ts

@@ -0,0 +1,64 @@
+import { ResilientError } from '@owlmeans/error';
+import { ResourceError } from '@owlmeans/resource';
+/**
+ * The project and story refusals every process that writes a planning card can raise.
+ *
+ * Declared HERE rather than by the platform because the viable planning plugin throws them from a
+ * process-neutral package, and a refusal class that exists only on one side of a hop cannot be
+ * `instanceof`-matched on the other. Type names and markers are wire contracts: the browser
+ * phrases a refusal by marker (`viable-project:…`), so neither may change. The bases are declared
+ * with them because an error class is unmarshalled by type name with the LAST registration
+ * winning — a second declaration of a base anywhere else would replace this one.
+ */
+export declare class ProjectResourceError extends ResourceError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** No project card with that id in the caller's organization. */
+export declare class ProjectNotFound extends ProjectResourceError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** The project exists, and the caller may not act on it. */
+export declare class ProjectPermissionError extends ProjectResourceError {
+    static typeName: string;
+    constructor(message?: string);
+}
+export declare class ProjectStoryError extends ProjectResourceError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** No story card with that id or code under the project. */
+export declare class ProjectStoryNotFound extends ProjectStoryError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/**
+ * The story is in a state the requested write does not apply to.
+ *
+ * `wrong-status` is the marker a completed story's refusal carries — the manager matches the whole
+ * `viable-project:story:missconfigured:` prefix, so the reason after it is free to grow.
+ */
+export declare class ProjectStoryMissconfigured extends ProjectStoryError {
+    static typeName: string;
+    constructor(message?: string);
+}
+export declare class ProjectError extends ResilientError {
+    static typeName: string;
+    constructor(message?: string);
+}
+export declare class ProjectAgentError extends ProjectError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/**
+ * The project's agent is already busy with what was asked for.
+ *
+ * `story` is the reason a second story start carries: one story of a project is in progress at a
+ * time, because a develop run holds the project's sandbox for its whole length.
+ */
+export declare class ProjectAgentOccupied extends ProjectAgentError {
+    static typeName: string;
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/planning/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD;;;;;;;;;GASG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;IACrD,OAAuB,QAAQ,SAA2C;IAE1E,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED,iEAAiE;AACjE,qBAAa,eAAgB,SAAQ,oBAAoB;IACvD,OAAuB,QAAQ,SAA6C;IAE5E,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED,4DAA4D;AAC5D,qBAAa,sBAAuB,SAAQ,oBAAoB;IAC9D,OAAuB,QAAQ,SAA+C;IAE9E,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED,qBAAa,iBAAkB,SAAQ,oBAAoB;IACzD,OAAuB,QAAQ,SAA0C;IAEzE,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED,4DAA4D;AAC5D,qBAAa,oBAAqB,SAAQ,iBAAiB;IACzD,OAAuB,QAAQ,SAA0C;IAEzE,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED;;;;;GAKG;AACH,qBAAa,0BAA2B,SAAQ,iBAAiB;IAC/D,OAAuB,QAAQ,SAAgD;IAE/E,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED,qBAAa,YAAa,SAAQ,cAAc;IAC9C,OAAuB,QAAQ,SAA4C;IAE3E,YAAY,OAAO,GAAE,MAAgB,EAEpC;CACF;AAED,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,OAAuB,QAAQ,SAAkC;IAEjE,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,iBAAiB;IACzD,OAAuB,QAAQ,SAA0C;IAEzE,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF"}

package/build/planning/errors.js

@@ -0,0 +1,99 @@
+import { ResilientError } from '@owlmeans/error';
+import { ResourceError } from '@owlmeans/resource';
+/**
+ * The project and story refusals every process that writes a planning card can raise.
+ *
+ * Declared HERE rather than by the platform because the viable planning plugin throws them from a
+ * process-neutral package, and a refusal class that exists only on one side of a hop cannot be
+ * `instanceof`-matched on the other. Type names and markers are wire contracts: the browser
+ * phrases a refusal by marker (`viable-project:…`), so neither may change. The bases are declared
+ * with them because an error class is unmarshalled by type name with the LAST registration
+ * winning — a second declaration of a base anywhere else would replace this one.
+ */
+export class ProjectResourceError extends ResourceError {
+    static typeName = `ViableProject${ResourceError.typeName}`;
+    constructor(message = 'error') {
+        super(`viable-project:${message}`);
+        this.type = ProjectResourceError.typeName;
+    }
+}
+/** No project card with that id in the caller's organization. */
+export class ProjectNotFound extends ProjectResourceError {
+    static typeName = `NotFound${ProjectResourceError.typeName}`;
+    constructor(message = 'error') {
+        super(`not-found:${message}`);
+        this.type = ProjectNotFound.typeName;
+    }
+}
+/** The project exists, and the caller may not act on it. */
+export class ProjectPermissionError extends ProjectResourceError {
+    static typeName = `Permission${ProjectResourceError.typeName}`;
+    constructor(message = 'error') {
+        super(`permission:${message}`);
+        this.type = ProjectPermissionError.typeName;
+    }
+}
+export class ProjectStoryError extends ProjectResourceError {
+    static typeName = `Story${ProjectResourceError.typeName}`;
+    constructor(message = 'error') {
+        super(`story:${message}`);
+        this.type = ProjectStoryError.typeName;
+    }
+}
+/** No story card with that id or code under the project. */
+export class ProjectStoryNotFound extends ProjectStoryError {
+    static typeName = `NotFound${ProjectStoryError.typeName}`;
+    constructor(message = 'error') {
+        super(`not-found:${message}`);
+        this.type = ProjectStoryNotFound.typeName;
+    }
+}
+/**
+ * The story is in a state the requested write does not apply to.
+ *
+ * `wrong-status` is the marker a completed story's refusal carries — the manager matches the whole
+ * `viable-project:story:missconfigured:` prefix, so the reason after it is free to grow.
+ */
+export class ProjectStoryMissconfigured extends ProjectStoryError {
+    static typeName = `Missconfigured${ProjectStoryError.typeName}`;
+    constructor(message = 'error') {
+        super(`missconfigured:${message}`);
+        this.type = ProjectStoryMissconfigured.typeName;
+    }
+}
+export class ProjectError extends ResilientError {
+    static typeName = `ViableProject${ResilientError.typeName}`;
+    constructor(message = 'error') {
+        super(ProjectError.typeName, `viable-project:${message}`);
+    }
+}
+export class ProjectAgentError extends ProjectError {
+    static typeName = `Agent${ProjectError.typeName}`;
+    constructor(message = 'error') {
+        super(`agent:${message}`);
+        this.type = ProjectAgentError.typeName;
+    }
+}
+/**
+ * The project's agent is already busy with what was asked for.
+ *
+ * `story` is the reason a second story start carries: one story of a project is in progress at a
+ * time, because a develop run holds the project's sandbox for its whole length.
+ */
+export class ProjectAgentOccupied extends ProjectAgentError {
+    static typeName = `Occupied${ProjectAgentError.typeName}`;
+    constructor(message = 'error') {
+        super(`occupied:${message}`);
+        this.type = ProjectAgentOccupied.typeName;
+    }
+}
+ResilientError.registerErrorClass(ProjectResourceError);
+ResilientError.registerErrorClass(ProjectNotFound);
+ResilientError.registerErrorClass(ProjectPermissionError);
+ResilientError.registerErrorClass(ProjectStoryError);
+ResilientError.registerErrorClass(ProjectStoryNotFound);
+ResilientError.registerErrorClass(ProjectStoryMissconfigured);
+ResilientError.registerErrorClass(ProjectError);
+ResilientError.registerErrorClass(ProjectAgentError);
+ResilientError.registerErrorClass(ProjectAgentOccupied);
+//# sourceMappingURL=errors.js.map

package/build/planning/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/planning/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD;;;;;;;;;GASG;AACH,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IAC9C,MAAM,CAAU,QAAQ,GAAG,gBAAgB,aAAa,CAAC,QAAQ,EAAE,CAAA;IAE1E,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAA;QAClC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC,QAAQ,CAAA;IAC3C,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,OAAO,eAAgB,SAAQ,oBAAoB;IAChD,MAAM,CAAU,QAAQ,GAAG,WAAW,oBAAoB,CAAC,QAAQ,EAAE,CAAA;IAE5E,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,aAAa,OAAO,EAAE,CAAC,CAAA;QAC7B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAA;IACtC,CAAC;CACF;AAED,4DAA4D;AAC5D,MAAM,OAAO,sBAAuB,SAAQ,oBAAoB;IACvD,MAAM,CAAU,QAAQ,GAAG,aAAa,oBAAoB,CAAC,QAAQ,EAAE,CAAA;IAE9E,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,cAAc,OAAO,EAAE,CAAC,CAAA;QAC9B,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,QAAQ,CAAA;IAC7C,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,oBAAoB;IAClD,MAAM,CAAU,QAAQ,GAAG,QAAQ,oBAAoB,CAAC,QAAQ,EAAE,CAAA;IAEzE,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;QACzB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAA;IACxC,CAAC;CACF;AAED,4DAA4D;AAC5D,MAAM,OAAO,oBAAqB,SAAQ,iBAAiB;IAClD,MAAM,CAAU,QAAQ,GAAG,WAAW,iBAAiB,CAAC,QAAQ,EAAE,CAAA;IAEzE,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,aAAa,OAAO,EAAE,CAAC,CAAA;QAC7B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC,QAAQ,CAAA;IAC3C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,0BAA2B,SAAQ,iBAAiB;IACxD,MAAM,CAAU,QAAQ,GAAG,iBAAiB,iBAAiB,CAAC,QAAQ,EAAE,CAAA;IAE/E,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAA;QAClC,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC,QAAQ,CAAA;IACjD,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,cAAc;IACvC,MAAM,CAAU,QAAQ,GAAG,gBAAgB,cAAc,CAAC,QAAQ,EAAE,CAAA;IAE3E,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,kBAAkB,OAAO,EAAE,CAAC,CAAA;IAC3D,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IAC1C,MAAM,CAAU,QAAQ,GAAG,QAAQ,YAAY,CAAC,QAAQ,EAAE,CAAA;IAEjE,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;QACzB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAA;IACxC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,oBAAqB,SAAQ,iBAAiB;IAClD,MAAM,CAAU,QAAQ,GAAG,WAAW,iBAAiB,CAAC,QAAQ,EAAE,CAAA;IAEzE,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,YAAY,OAAO,EAAE,CAAC,CAAA;QAC5B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC,QAAQ,CAAA;IAC3C,CAAC;CACF;AAED,cAAc,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,CAAA;AACvD,cAAc,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAA;AAClD,cAAc,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,CAAA;AACzD,cAAc,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAA;AACpD,cAAc,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,CAAA;AACvD,cAAc,CAAC,kBAAkB,CAAC,0BAA0B,CAAC,CAAA;AAC7D,cAAc,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAA;AAC/C,cAAc,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAA;AACpD,cAAc,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,CAAA"}

package/build/planning/flows.d.ts

@@ -0,0 +1,34 @@
+import type { AnyTypeSchema, ProjectTypeSchema, RelationshipType, SpecificationSlot, StatusFlowSchema, WorkcardTypeSchema } from '@owlmeans/planning';
+/**
+ * The story flow.
+ *
+ * `failed` maps to PLANNED: a failed story is work still to do, so "done" is the closed count and
+ * a retry is simply `start` again. `reset` from anywhere is the manual recovery — the one move a
+ * completed story still accepts.
+ */
+export declare const VIABLE_STORY_FLOW_SCHEMA: StatusFlowSchema;
+/**
+ * The project flow.
+ *
+ * A create lands at `draft`; confirming the brief is `confirm`; the end of an initialization is
+ * `activate`. A reinitialization and a failed initialization are SLOT facts, not transitions, and
+ * destroying a project is a `delete` plus the platform's cascade — never `archive`.
+ */
+export declare const VIABLE_PROJECT_FLOW_SCHEMA: StatusFlowSchema;
+/** A document is written or revised; it has no lifecycle to move through. */
+export declare const VIABLE_SPEC_FLOW_SCHEMA: StatusFlowSchema;
+/** The brief a person confirms, and the plan the scaffold draws from it. */
+export declare const VIABLE_PROJECT_SLOTS: SpecificationSlot[];
+/** A story's design — the payload the implementation stage consumes. */
+export declare const VIABLE_STORY_SLOTS: SpecificationSlot[];
+export declare const VIABLE_STORY_RELATIONSHIPS: RelationshipType[];
+export declare const VIABLE_PROJECT_TYPE_SCHEMA: ProjectTypeSchema;
+export declare const VIABLE_STORY_TYPE_SCHEMA: WorkcardTypeSchema;
+export declare const VIABLE_SPEC_TYPE_SCHEMA: WorkcardTypeSchema;
+/** Registered so their prefixes and flow are decided once; not creatable under a project yet. */
+export declare const VIABLE_RESERVED_TYPE_SCHEMAS: WorkcardTypeSchema[];
+/** Every Viable type — what a planning plugin registers. */
+export declare const VIABLE_TYPE_SCHEMAS: AnyTypeSchema[];
+/** Every Viable flow — registered beside the types. */
+export declare const VIABLE_FLOW_SCHEMAS: StatusFlowSchema[];
+//# sourceMappingURL=flows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../../src/planning/flows.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EACvF,kBAAkB,EACnB,MAAM,oBAAoB,CAAA;AAgB3B;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,EAAE,gBA6BtC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,EAAE,gBA6BxC,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB,EAAE,gBAOrC,CAAA;AAMD,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,EAAE,iBAAiB,EAOnD,CAAA;AAED,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,EAAE,iBAAiB,EAOjD,CAAA;AAKD,eAAO,MAAM,0BAA0B,EAAE,gBAAgB,EAIxD,CAAA;AAED,eAAO,MAAM,0BAA0B,EAAE,iBAUxC,CAAA;AAED,eAAO,MAAM,wBAAwB,EAAE,kBAUtC,CAAA;AAED,eAAO,MAAM,uBAAuB,EAAE,kBAOrC,CAAA;AAaD,iGAAiG;AACjG,eAAO,MAAM,4BAA4B,EAAE,kBAAkB,EAI5D,CAAA;AAED,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,EAAE,aAAa,EAK9C,CAAA;AAED,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,EAAE,gBAAgB,EAIjD,CAAA"}

package/build/planning/flows.js

@@ -0,0 +1,174 @@
+import { IntrinsicPolicy, IntrinsicStatus, SpecificationFormat, WorkcardKind } from '@owlmeans/planning';
+import { STORY_DESIGN_VERSION } from '../design/consts.js';
+import { StoryDesignSchema } from '../design/schemas.js';
+import { ScaffoldPlanSchema } from '../scaffold/schemas.js';
+import { VIABLE_BUG_CODE, VIABLE_BUG_TYPE, VIABLE_DESIGN_REVISIONS_KEPT, VIABLE_IMPROVEMENT_CODE, VIABLE_IMPROVEMENT_TYPE, VIABLE_PROJECT_CODE, VIABLE_PROJECT_FLOW, VIABLE_PROJECT_TYPE, VIABLE_REQUIREMENT_CODE, VIABLE_REQUIREMENT_TYPE, VIABLE_SPEC_FLOW, VIABLE_SPEC_TYPE, VIABLE_STORY_CODE, VIABLE_STORY_FLOW, VIABLE_STORY_TYPE, ViableProjectStatus, ViableProjectTransition, ViableRelationship, ViableSpecCategory, ViableSpecStatus, ViableStoryStatus, ViableStoryTransition, ViableTone, } from './consts.js';
+import { ViableOpenFieldsSchema, ViableProjectFieldsSchema, ViableSpecFieldsSchema, ViableStoryFieldsSchema, } from './schemas.js';
+/**
+ * The story flow.
+ *
+ * `failed` maps to PLANNED: a failed story is work still to do, so "done" is the closed count and
+ * a retry is simply `start` again. `reset` from anywhere is the manual recovery — the one move a
+ * completed story still accepts.
+ */
+export const VIABLE_STORY_FLOW_SCHEMA = {
+    id: VIABLE_STORY_FLOW,
+    version: 1,
+    statuses: [
+        { key: ViableStoryStatus.Planned, intrinsic: IntrinsicStatus.Planned, initial: true, tone: ViableTone.Blue },
+        { key: ViableStoryStatus.InProgress, intrinsic: IntrinsicStatus.InProgress, tone: ViableTone.Yellow },
+        { key: ViableStoryStatus.Completed, intrinsic: IntrinsicStatus.Closed, tone: ViableTone.Green },
+        { key: ViableStoryStatus.Failed, intrinsic: IntrinsicStatus.Planned, tone: ViableTone.Red },
+    ],
+    transitions: [
+        {
+            name: ViableStoryTransition.Start,
+            from: [ViableStoryStatus.Planned, ViableStoryStatus.Failed],
+            to: ViableStoryStatus.InProgress,
+            explicit: true,
+        },
+        {
+            name: ViableStoryTransition.Complete,
+            from: [ViableStoryStatus.InProgress],
+            to: ViableStoryStatus.Completed,
+            explicit: true,
+        },
+        {
+            name: ViableStoryTransition.Fail,
+            from: [ViableStoryStatus.InProgress],
+            to: ViableStoryStatus.Failed,
+        },
+        { name: ViableStoryTransition.Reset, from: '*', to: ViableStoryStatus.Planned, explicit: true },
+    ],
+};
+/**
+ * The project flow.
+ *
+ * A create lands at `draft`; confirming the brief is `confirm`; the end of an initialization is
+ * `activate`. A reinitialization and a failed initialization are SLOT facts, not transitions, and
+ * destroying a project is a `delete` plus the platform's cascade — never `archive`.
+ */
+export const VIABLE_PROJECT_FLOW_SCHEMA = {
+    id: VIABLE_PROJECT_FLOW,
+    version: 1,
+    statuses: [
+        { key: ViableProjectStatus.Draft, intrinsic: IntrinsicStatus.Planned, initial: true, tone: ViableTone.Blue },
+        { key: ViableProjectStatus.Confirmed, intrinsic: IntrinsicStatus.InProgress, tone: ViableTone.Yellow },
+        { key: ViableProjectStatus.Active, intrinsic: IntrinsicStatus.InProgress, tone: ViableTone.Green },
+        { key: ViableProjectStatus.Archived, intrinsic: IntrinsicStatus.Closed, tone: ViableTone.Neutral },
+    ],
+    transitions: [
+        {
+            name: ViableProjectTransition.Confirm,
+            from: [ViableProjectStatus.Draft],
+            to: ViableProjectStatus.Confirmed,
+            explicit: true,
+        },
+        {
+            name: ViableProjectTransition.Activate,
+            from: [ViableProjectStatus.Confirmed],
+            to: ViableProjectStatus.Active,
+        },
+        { name: ViableProjectTransition.Archive, from: '*', to: ViableProjectStatus.Archived, explicit: true },
+        {
+            name: ViableProjectTransition.Reopen,
+            from: [ViableProjectStatus.Archived],
+            to: ViableProjectStatus.Active,
+            explicit: true,
+        },
+    ],
+};
+/** A document is written or revised; it has no lifecycle to move through. */
+export const VIABLE_SPEC_FLOW_SCHEMA = {
+    id: VIABLE_SPEC_FLOW,
+    version: 1,
+    statuses: [
+        { key: ViableSpecStatus.Current, intrinsic: IntrinsicStatus.Closed, initial: true, tone: ViableTone.Neutral },
+    ],
+    transitions: [],
+};
+const slot = (category, format, extra = {}) => ({ category, format, type: VIABLE_SPEC_TYPE, ...extra });
+/** The brief a person confirms, and the plan the scaffold draws from it. */
+export const VIABLE_PROJECT_SLOTS = [
+    slot(ViableSpecCategory.Specification, SpecificationFormat.Markdown, { required: true }),
+    slot(ViableSpecCategory.Vision, SpecificationFormat.Markdown),
+    slot(ViableSpecCategory.DesignSystem, SpecificationFormat.Markdown),
+    slot(ViableSpecCategory.Scaffold, SpecificationFormat.Json, {
+        revisioned: true, keepRevisions: VIABLE_DESIGN_REVISIONS_KEPT, schema: ScaffoldPlanSchema,
+    }),
+];
+/** A story's design — the payload the implementation stage consumes. */
+export const VIABLE_STORY_SLOTS = [
+    slot(ViableSpecCategory.Design, SpecificationFormat.Json, {
+        revisioned: true,
+        keepRevisions: VIABLE_DESIGN_REVISIONS_KEPT,
+        schema: StoryDesignSchema,
+        version: STORY_DESIGN_VERSION,
+    }),
+];
+const storyLink = (name) => ({ name, from: [VIABLE_STORY_TYPE], to: [VIABLE_STORY_TYPE], single: true });
+export const VIABLE_STORY_RELATIONSHIPS = [
+    storyLink(ViableRelationship.Follows),
+    storyLink(ViableRelationship.SharesWidget),
+    storyLink(ViableRelationship.SharesScreen),
+];
+export const VIABLE_PROJECT_TYPE_SCHEMA = {
+    type: VIABLE_PROJECT_TYPE,
+    kind: WorkcardKind.Project,
+    version: 1,
+    fields: ViableProjectFieldsSchema,
+    flows: [VIABLE_PROJECT_FLOW],
+    intrinsic: IntrinsicPolicy.Primary,
+    specifications: VIABLE_PROJECT_SLOTS,
+    code: VIABLE_PROJECT_CODE,
+    cardTypes: [VIABLE_STORY_TYPE],
+};
+export const VIABLE_STORY_TYPE_SCHEMA = {
+    type: VIABLE_STORY_TYPE,
+    kind: WorkcardKind.Card,
+    version: 1,
+    fields: ViableStoryFieldsSchema,
+    flows: [VIABLE_STORY_FLOW],
+    intrinsic: IntrinsicPolicy.Primary,
+    specifications: VIABLE_STORY_SLOTS,
+    relationships: VIABLE_STORY_RELATIONSHIPS,
+    code: VIABLE_STORY_CODE,
+};
+export const VIABLE_SPEC_TYPE_SCHEMA = {
+    type: VIABLE_SPEC_TYPE,
+    kind: WorkcardKind.Specification,
+    version: 1,
+    fields: ViableSpecFieldsSchema,
+    flows: [VIABLE_SPEC_FLOW],
+    specifications: [],
+};
+const reserved = (type, code) => ({
+    type,
+    kind: WorkcardKind.Card,
+    version: 1,
+    fields: ViableOpenFieldsSchema,
+    flows: [VIABLE_STORY_FLOW],
+    intrinsic: IntrinsicPolicy.Primary,
+    specifications: [],
+    code,
+});
+/** Registered so their prefixes and flow are decided once; not creatable under a project yet. */
+export const VIABLE_RESERVED_TYPE_SCHEMAS = [
+    reserved(VIABLE_BUG_TYPE, VIABLE_BUG_CODE),
+    reserved(VIABLE_IMPROVEMENT_TYPE, VIABLE_IMPROVEMENT_CODE),
+    reserved(VIABLE_REQUIREMENT_TYPE, VIABLE_REQUIREMENT_CODE),
+];
+/** Every Viable type — what a planning plugin registers. */
+export const VIABLE_TYPE_SCHEMAS = [
+    VIABLE_PROJECT_TYPE_SCHEMA,
+    VIABLE_STORY_TYPE_SCHEMA,
+    VIABLE_SPEC_TYPE_SCHEMA,
+    ...VIABLE_RESERVED_TYPE_SCHEMAS,
+];
+/** Every Viable flow — registered beside the types. */
+export const VIABLE_FLOW_SCHEMAS = [
+    VIABLE_PROJECT_FLOW_SCHEMA,
+    VIABLE_STORY_FLOW_SCHEMA,
+    VIABLE_SPEC_FLOW_SCHEMA,
+];
+//# sourceMappingURL=flows.js.map

package/build/planning/flows.js.map

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

package/build/planning/helpers.d.ts

@@ -0,0 +1,54 @@
+import type { Specification, Workcard } from '@owlmeans/planning';
+import type { StoryDraft } from '../areas/types.js';
+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. */
+export declare const isViableProject: (card?: Workcard | null) => card is ViableProjectCard;
+/** A `viable:user-story` card. */
+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. */
+export declare const isUserChannel: (channel?: string | null) => boolean;
+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.
+ */
+export declare const storyFieldsOf: (card: Workcard) => ViableStoryFields;
+/** The draft shape the analysis prompts and moderation take, from a card. */
+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.
+ */
+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`.
+ */
+export declare const currentSpecOf: (specs: readonly Specification[], category: string) => Specification | null;
+/** The body of a category's current document, `''` when there is none. */
+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".
+ */
+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.
+ */
+export declare const storyWriteInputOf: (card: Workcard, content: StoryWriteContent) => StoryWriteInput;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +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;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,SAAU,QAAQ,WAAW,iBAAiB,KAAG,eAa9E,CAAA"}