@owlmeans/viable-common 0.0.43 → 0.0.44

package/tests/connect-errors.spec.ts

@@ -1,6 +1,7 @@
 import { describe, expect, test } from 'bun:test'
 import { ResilientError } from '@owlmeans/error'
-import { ConnectConsentRequired, ConnectOutOfCredits } from '../src/connect/errors.js'
+import { ConnectConfirmationRequired, ConnectConsentRequired, ConnectOutOfCredits } from '../src/connect/errors.js'
+import type { ConnectConfirmation } from '../src/connect/types.js'
 
 describe('@owlmeans/viable-common — ConnectOutOfCredits', () => {
   test('carries its fields fresh, and survives a marshal/unmarshal round trip', () => {
@@ -50,3 +51,35 @@ describe('@owlmeans/viable-common — ConnectConsentRequired', () => {
     expect((ResilientError.ensure(fresh.marshal()) as ConnectConsentRequired).deadline).toBeUndefined()
   })
 })
+
+describe('@owlmeans/viable-common — ConnectConfirmationRequired', () => {
+  const fields: ConnectConfirmation = {
+    action: 'convert-proceed', cap: 1_000_000, spent: 420_000, estimate: 850_000, fromAllowance: 580_000,
+    fromCreditLimits: 150_000, moneyUsd: 2.4,
+  }
+
+  test('packs the action, the conversion limit and the stage split, and answers 428', () => {
+    const fresh = new ConnectConfirmationRequired(ConnectConfirmationRequired.encode(fields))
+
+    expect(fresh.message).toBe('viable-connect:confirmation-required:convert-proceed:1000000:420000:850000:580000:150000:2.4')
+    expect(fresh).toEqual(expect.objectContaining(fields))
+    expect((fresh.constructor as { httpStatus?: number }).httpStatus).toBe(428)
+  })
+
+  test('survives a marshal/unmarshal round trip — only type and message cross a hop', () => {
+    const restored = ResilientError.ensure(
+      new ConnectConfirmationRequired(ConnectConfirmationRequired.encode({ ...fields, action: 'convert-start' })).marshal()
+    )
+
+    expect(restored).toBeInstanceOf(ConnectConfirmationRequired)
+    expect(restored).toEqual(expect.objectContaining({ ...fields, action: 'convert-start' }))
+  })
+
+  test('decode is encode\'s inverse; an unreadable number reads back as 0, never NaN', () => {
+    expect(ConnectConfirmationRequired.decode(ConnectConfirmationRequired.encode(fields))).toEqual(fields)
+    expect(ConnectConfirmationRequired.encode({ ...fields, moneyUsd: Number.NaN })).toEndWith(':0')
+    expect(ConnectConfirmationRequired.decode('convert-start:x')).toEqual({
+      action: 'convert-start', cap: 0, spent: 0, estimate: 0, fromAllowance: 0, fromCreditLimits: 0, moneyUsd: 0,
+    })
+  })
+})

package/tests/convert.spec.ts

@@ -12,9 +12,8 @@ import {
   sizeClassOf, stageAfter, storyComplexity
 } from '../src/convert/helpers.js'
 import { HISTORY_FILE } from '../src/metadata/consts.js'
-import {
-  conversionStoryDoc, CONVERTED_ORIGIN_DIR, ConversionDecision
-} from '../src/convert/consts.js'
+import { CONVERTED_ORIGIN_DIR, ConversionDecision } from '../src/convert/consts.js'
+import { conversionStoryDoc } from '../src/convert/utils.js'
 
 /**
  * Every `*Schema` a module exports.

package/tests/error-status.spec.ts

@@ -19,6 +19,7 @@ const DECLARED: Record<string, number | undefined> = {
   ConnectOpRefused: 422,
   ConnectOutOfCredits: 402,
   ConnectConsentRequired: 428,
+  ConnectConfirmationRequired: 428,
   ConnectOpTimeout: undefined,
   ProjectResourceError: undefined,
   ProjectNotFound: 404,
@@ -41,7 +42,7 @@ describe('viable-common refusals — declared HTTP statuses', () => {
     expect(classes.map(([name]) => name).sort()).toEqual(Object.keys(DECLARED).sort())
   })
 
-  test('balance 402, an absent target 404, a conflicting state 409, refused content 422, a consent only a person gives 428; faults nothing', () => {
+  test('balance 402, an absent target 404, a conflicting state 409, refused content 422, a consent or a confirmation only a person gives 428; faults nothing', () => {
     for (const [name, Class] of classes) {
       expect([name, statusOf(new Class('x'))]).toEqual([name, DECLARED[name]])
     }
@@ -60,5 +61,10 @@ describe('viable-common refusals — declared HTTP statuses', () => {
       new connect.ConnectConsentRequired(connect.ConnectConsentRequired.encode('story', 'https://x.test/?consent=1')).marshal()
     )
     expect([statusOf(consent), (consent as connect.ConnectConsentRequired).consentUrl]).toEqual([428, 'https://x.test/?consent=1'])
+    const confirmation = ResilientError.ensure(new connect.ConnectConfirmationRequired(connect.ConnectConfirmationRequired.encode({
+      action: 'convert-proceed', cap: 1_000_000, spent: 420_000, estimate: 300_000, fromAllowance: 300_000,
+      fromCreditLimits: 0, moneyUsd: 0,
+    })).marshal())
+    expect([statusOf(confirmation), (confirmation as connect.ConnectConfirmationRequired).spent]).toEqual([428, 420_000])
   })
 })

package/tests/planning.spec.ts

@@ -2,32 +2,17 @@ import { describe, expect, test } from 'bun:test'
 import Ajv from 'ajv'
 import addFormats from 'ajv-formats'
 import { ResilientError } from '@owlmeans/error'
-import {
-  canTransit, CodeScope, CodeStyle, intrinsicOf, IntrinsicStatus, makeSchemaRegistry,
-  SpecificationFormat, TITLE_MAX, transitionsFrom, WorkcardKind,
-} from '@owlmeans/planning'
-import type { Specification } from '@owlmeans/planning'
+import { canTransit, CodeScope, CodeStyle, intrinsicOf, IntrinsicStatus, makeSchemaRegistry, SpecificationFormat, TITLE_MAX, transitionsFrom, WorkcardKind, type Specification } from '@owlmeans/planning'
 import { ProjectArea } from '../src/areas/consts.js'
 import { ConnectingStoryKind, SpecCategory, StoryKind } from '../src/ba/consts.js'
 import { mergeConnectingStories } from '../src/ba/helpers.js'
-import { STORY_DESIGN_VERSION } from '../src/design/consts.js'
+import { STORY_DESIGN_VERSION, StoryActor } from '../src/design/consts.js'
 import { emptyStoryDesign } from '../src/design/helpers.js'
-import { StoryActor } from '../src/design/runtime.js'
 import type { StoryDesign } from '../src/design/types.js'
 import {
   hasLandingSentence, LANDING_STORY_SENTENCE, withLandingSentence,
 } from '../src/index.js'
-import {
-  isUserChannel, isViableProject, isViableStory, ProjectAgentOccupied, ProjectNotFound,
-  ProjectStoryMissconfigured, projectBriefOf, storyDraftOf, storyWriteInputOf, userStoryOf,
-  VIABLE_FLOW_SCHEMAS, VIABLE_PROJECT_FLOW, VIABLE_PROJECT_FLOW_SCHEMA, VIABLE_PROJECT_TYPE,
-  VIABLE_PROJECT_TYPE_SCHEMA, VIABLE_RESERVED_TYPE_SCHEMAS, VIABLE_SPEC_TYPE, VIABLE_STORY_FLOW,
-  VIABLE_STORY_FLOW_SCHEMA,
-  VIABLE_STORY_TYPE, VIABLE_STORY_TYPE_SCHEMA, VIABLE_TYPE_SCHEMAS, ViableChannel,
-  ViableProjectFieldsSchema, ViableProjectStatus, ViableProjectTransition, ViableRelationship,
-  ViableSpecCategory, ViableStoryFieldsSchema, ViableStoryStatus, ViableStoryTransition,
-} from '../src/planning/index.js'
-import type { ViableProjectCard, ViableStoryCard } from '../src/planning/index.js'
+import { isUserChannel, isViableProject, isViableStory, ProjectAgentOccupied, ProjectNotFound, ProjectStoryMissconfigured, projectBriefOf, storyDraftOf, storyWriteInputOf, userStoryOf, VIABLE_FLOW_SCHEMAS, VIABLE_PROJECT_FLOW, VIABLE_PROJECT_FLOW_SCHEMA, VIABLE_PROJECT_TYPE, VIABLE_PROJECT_TYPE_SCHEMA, VIABLE_RESERVED_TYPE_SCHEMAS, VIABLE_SPEC_TYPE, VIABLE_STORY_FLOW, VIABLE_STORY_FLOW_SCHEMA, VIABLE_STORY_TYPE, VIABLE_STORY_TYPE_SCHEMA, VIABLE_TYPE_SCHEMAS, ViableChannel, ViableProjectFieldsSchema, ViableProjectStatus, ViableProjectTransition, ViableRelationship, ViableSpecCategory, ViableStoryFieldsSchema, ViableStoryStatus, ViableStoryTransition, type ViableProjectCard, type ViableStoryCard } from '../src/planning/index.js'
 
 const at = '2026-09-16T10:00:00.000Z'
 

package/tests/presentation.spec.ts

@@ -1,8 +1,6 @@
 import { describe, expect, test } from 'bun:test'
-import {
-  AgentCodeLanguage, AgentMarkdownKind, AgentMessageCategory, AgentMessageRole,
-  AgentStructuredKind, classifyAgentMessage, isAgentMessageHidden,
-} from '../src/agent/presentation.js'
+import { classifyAgentMessage, isAgentMessageHidden } from '../src/agent/presentation.js'
+import { AgentCodeLanguage, AgentMarkdownKind, AgentMessageCategory, AgentMessageRole, AgentStructuredKind } from '../src/agent/consts.js'
 
 describe('@owlmeans/viable-common — agent message presentation', () => {
   test('classifies source and unified diffs with their display language', () => {

package/build/planning/flows.d.ts

@@ -1,34 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,174 +0,0 @@
-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

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

package/src/planning/flows.ts

@@ -1,204 +0,0 @@
-import { IntrinsicPolicy, IntrinsicStatus, SpecificationFormat, WorkcardKind } from '@owlmeans/planning'
-import type {
-  AnyTypeSchema, ProjectTypeSchema, RelationshipType, SpecificationSlot, StatusFlowSchema,
-  WorkcardTypeSchema,
-} 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: StatusFlowSchema = {
-  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: StatusFlowSchema = {
-  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: StatusFlowSchema = {
-  id: VIABLE_SPEC_FLOW,
-  version: 1,
-  statuses: [
-    { key: ViableSpecStatus.Current, intrinsic: IntrinsicStatus.Closed, initial: true, tone: ViableTone.Neutral },
-  ],
-  transitions: [],
-}
-
-const slot = (
-  category: ViableSpecCategory, format: SpecificationFormat, extra: Partial<SpecificationSlot> = {},
-): SpecificationSlot => ({ 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: SpecificationSlot[] = [
-  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: SpecificationSlot[] = [
-  slot(ViableSpecCategory.Design, SpecificationFormat.Json, {
-    revisioned: true,
-    keepRevisions: VIABLE_DESIGN_REVISIONS_KEPT,
-    schema: StoryDesignSchema,
-    version: STORY_DESIGN_VERSION,
-  }),
-]
-
-const storyLink = (name: ViableRelationship): RelationshipType =>
-  ({ name, from: [VIABLE_STORY_TYPE], to: [VIABLE_STORY_TYPE], single: true })
-
-export const VIABLE_STORY_RELATIONSHIPS: RelationshipType[] = [
-  storyLink(ViableRelationship.Follows),
-  storyLink(ViableRelationship.SharesWidget),
-  storyLink(ViableRelationship.SharesScreen),
-]
-
-export const VIABLE_PROJECT_TYPE_SCHEMA: ProjectTypeSchema = {
-  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: WorkcardTypeSchema = {
-  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: WorkcardTypeSchema = {
-  type: VIABLE_SPEC_TYPE,
-  kind: WorkcardKind.Specification,
-  version: 1,
-  fields: ViableSpecFieldsSchema,
-  flows: [VIABLE_SPEC_FLOW],
-  specifications: [],
-}
-
-const reserved = (type: string, code: WorkcardTypeSchema['code']): WorkcardTypeSchema => ({
-  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: WorkcardTypeSchema[] = [
-  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: AnyTypeSchema[] = [
-  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: StatusFlowSchema[] = [
-  VIABLE_PROJECT_FLOW_SCHEMA,
-  VIABLE_STORY_FLOW_SCHEMA,
-  VIABLE_SPEC_FLOW_SCHEMA,
-]