@elevasis/core 0.7.1 → 0.8.0

package/src/organization-model/domains/offerings.ts

@@ -1,66 +1,66 @@
-import { z } from 'zod'
-
-// ---------------------------------------------------------------------------
-// Pricing model — the four canonical pricing structures used in B2B SaaS and
-// professional services. "custom" covers bespoke / negotiated pricing.
-// ---------------------------------------------------------------------------
-
-export const PricingModelSchema = z.enum(['one-time', 'subscription', 'usage-based', 'custom'])
-
-// ---------------------------------------------------------------------------
-// Product schema — one entry per distinct offering (product or service).
-// Modeled after Business Model Canvas "Value Propositions" and company profile
-// product/service catalog language. Fields use plain English throughout.
-// ---------------------------------------------------------------------------
-
-export const ProductSchema = z.object({
-  /** Stable unique identifier for the product (e.g. "product-starter-plan"). */
-  id: z.string().trim().min(1).max(100),
-  /** Human-readable name shown to agents and in UI (e.g. "Starter Plan"). */
-  name: z.string().trim().max(200).default(''),
-  /** One or two sentences describing what this product/service delivers. */
-  description: z.string().trim().max(2000).default(''),
-  /**
-   * How this product is priced:
-   * - "one-time" — single purchase (setup fee, project fee)
-   * - "subscription" — recurring (monthly/annual SaaS, retainer)
-   * - "usage-based" — metered by consumption (API calls, seats)
-   * - "custom" — negotiated or bespoke pricing
-   */
-  pricingModel: PricingModelSchema.default('custom'),
-  /** Base price amount (≥ 0). Currency unit defined by `currency`. */
-  price: z.number().min(0).default(0),
-  /**
-   * ISO 4217 currency code (e.g. "USD", "EUR", "GBP").
-   * Free-form string to accommodate any currency; defaults to "USD".
-   */
-  currency: z.string().trim().max(10).default('USD'),
-  /**
-   * IDs of customer segments this product targets.
-   * Each id must reference a declared `customers.segments[].id`.
-   * Cross-reference enforced in `OrganizationModelSchema.superRefine()`.
-   */
-  targetSegmentIds: z.array(z.string().trim().min(1)).default([]),
-  /**
-   * Optional: ID of the platform feature responsible for delivering this product.
-   * When present, must reference a declared `features[].id`.
-   * Cross-reference enforced in `OrganizationModelSchema.superRefine()`.
-   */
-  deliveryFeatureId: z.string().trim().min(1).optional()
-})
-
-// ---------------------------------------------------------------------------
-// Offerings domain schema — a collection of products and services.
-// ---------------------------------------------------------------------------
-
-export const OfferingsDomainSchema = z.object({
-  products: z.array(ProductSchema).default([])
-})
-
-// ---------------------------------------------------------------------------
-// Seed — empty by default; adapters populate with real product definitions.
-// ---------------------------------------------------------------------------
-
-export const DEFAULT_ORGANIZATION_MODEL_OFFERINGS: z.infer<typeof OfferingsDomainSchema> = {
-  products: []
-}
+import { z } from 'zod'
+
+// ---------------------------------------------------------------------------
+// Pricing model — the four canonical pricing structures used in B2B SaaS and
+// professional services. "custom" covers bespoke / negotiated pricing.
+// ---------------------------------------------------------------------------
+
+export const PricingModelSchema = z.enum(['one-time', 'subscription', 'usage-based', 'custom'])
+
+// ---------------------------------------------------------------------------
+// Product schema — one entry per distinct offering (product or service).
+// Modeled after Business Model Canvas "Value Propositions" and company profile
+// product/service catalog language. Fields use plain English throughout.
+// ---------------------------------------------------------------------------
+
+export const ProductSchema = z.object({
+  /** Stable unique identifier for the product (e.g. "product-starter-plan"). */
+  id: z.string().trim().min(1).max(100),
+  /** Human-readable name shown to agents and in UI (e.g. "Starter Plan"). */
+  name: z.string().trim().max(200).default(''),
+  /** One or two sentences describing what this product/service delivers. */
+  description: z.string().trim().max(2000).default(''),
+  /**
+   * How this product is priced:
+   * - "one-time" — single purchase (setup fee, project fee)
+   * - "subscription" — recurring (monthly/annual SaaS, retainer)
+   * - "usage-based" — metered by consumption (API calls, seats)
+   * - "custom" — negotiated or bespoke pricing
+   */
+  pricingModel: PricingModelSchema.default('custom'),
+  /** Base price amount (≥ 0). Currency unit defined by `currency`. */
+  price: z.number().min(0).default(0),
+  /**
+   * ISO 4217 currency code (e.g. "USD", "EUR", "GBP").
+   * Free-form string to accommodate any currency; defaults to "USD".
+   */
+  currency: z.string().trim().max(10).default('USD'),
+  /**
+   * IDs of customer segments this product targets.
+   * Each id must reference a declared `customers.segments[].id`.
+   * Cross-reference enforced in `OrganizationModelSchema.superRefine()`.
+   */
+  targetSegmentIds: z.array(z.string().trim().min(1)).default([]),
+  /**
+   * Optional: ID of the platform feature responsible for delivering this product.
+   * When present, must reference a declared `features[].id`.
+   * Cross-reference enforced in `OrganizationModelSchema.superRefine()`.
+   */
+  deliveryFeatureId: z.string().trim().min(1).optional()
+})
+
+// ---------------------------------------------------------------------------
+// Offerings domain schema — a collection of products and services.
+// ---------------------------------------------------------------------------
+
+export const OfferingsDomainSchema = z.object({
+  products: z.array(ProductSchema).default([])
+})
+
+// ---------------------------------------------------------------------------
+// Seed — empty by default; adapters populate with real product definitions.
+// ---------------------------------------------------------------------------
+
+export const DEFAULT_ORGANIZATION_MODEL_OFFERINGS: z.infer<typeof OfferingsDomainSchema> = {
+  products: []
+}

package/src/organization-model/domains/operations.ts

@@ -1,85 +1,85 @@
-import { z } from 'zod'
-
-// ---------------------------------------------------------------------------
-// Semantic class enum — one value per stateful runtime entity category.
-// Every operation entry declares which category it belongs to via semanticClass.
-// ---------------------------------------------------------------------------
-
-export const OperationSemanticClassSchema = z.enum(['queue', 'executions', 'sessions', 'notifications', 'schedules'])
-
-// ---------------------------------------------------------------------------
-// Operation entry schema
-// ---------------------------------------------------------------------------
-
-export const OperationEntrySchema = z.object({
-  id: z.string().trim().min(1).max(100),
-  label: z.string().trim().min(1).max(120),
-  semanticClass: OperationSemanticClassSchema,
-  /** Optional reference to the feature that owns this runtime entity. */
-  featureId: z.string().trim().min(1).max(100).optional(),
-  /**
-   * Optional pointer to the status semanticClass values that apply to this
-   * entity — ties operations back to the statuses domain for vibe rendering.
-   */
-  supportedStatusSemanticClass: z.array(z.string().trim().min(1).max(80)).optional()
-})
-
-// ---------------------------------------------------------------------------
-// Domain schema — a flat array of operation entries
-// ---------------------------------------------------------------------------
-
-export const OperationsDomainSchema = z.object({
-  entries: z.array(OperationEntrySchema).default([])
-})
-
-// ---------------------------------------------------------------------------
-// Seed — one entry per stateful runtime entity category.
-// Categories: queue (HITL), executions, sessions, notifications, schedules.
-// ---------------------------------------------------------------------------
-
-export const DEFAULT_ORGANIZATION_MODEL_OPERATIONS: z.infer<typeof OperationsDomainSchema> = {
-  entries: [
-    // --- queue (HITL command queue) ---
-    {
-      id: 'operations.queue',
-      label: 'HITL Queue',
-      semanticClass: 'queue',
-      featureId: 'operations',
-      supportedStatusSemanticClass: ['queue']
-    },
-
-    // --- executions (workflow / agent executions) ---
-    {
-      id: 'operations.executions',
-      label: 'Executions',
-      semanticClass: 'executions',
-      featureId: 'operations',
-      supportedStatusSemanticClass: ['execution']
-    },
-
-    // --- sessions (agent conversation sessions) ---
-    {
-      id: 'operations.sessions',
-      label: 'Sessions',
-      semanticClass: 'sessions',
-      featureId: 'operations'
-    },
-
-    // --- notifications (platform in-app notifications) ---
-    {
-      id: 'operations.notifications',
-      label: 'Notifications',
-      semanticClass: 'notifications',
-      featureId: 'monitoring'
-    },
-
-    // --- schedules (task scheduler) ---
-    {
-      id: 'operations.schedules',
-      label: 'Schedules',
-      semanticClass: 'schedules',
-      featureId: 'operations',
-      supportedStatusSemanticClass: ['schedule', 'schedule.run']
-    }
-  ]
-}
+import { z } from 'zod'
+
+// ---------------------------------------------------------------------------
+// Semantic class enum — one value per stateful runtime entity category.
+// Every operation entry declares which category it belongs to via semanticClass.
+// ---------------------------------------------------------------------------
+
+export const OperationSemanticClassSchema = z.enum(['queue', 'executions', 'sessions', 'notifications', 'schedules'])
+
+// ---------------------------------------------------------------------------
+// Operation entry schema
+// ---------------------------------------------------------------------------
+
+export const OperationEntrySchema = z.object({
+  id: z.string().trim().min(1).max(100),
+  label: z.string().trim().min(1).max(120),
+  semanticClass: OperationSemanticClassSchema,
+  /** Optional reference to the feature that owns this runtime entity. */
+  featureId: z.string().trim().min(1).max(100).optional(),
+  /**
+   * Optional pointer to the status semanticClass values that apply to this
+   * entity — ties operations back to the statuses domain for vibe rendering.
+   */
+  supportedStatusSemanticClass: z.array(z.string().trim().min(1).max(80)).optional()
+})
+
+// ---------------------------------------------------------------------------
+// Domain schema — a flat array of operation entries
+// ---------------------------------------------------------------------------
+
+export const OperationsDomainSchema = z.object({
+  entries: z.array(OperationEntrySchema).default([])
+})
+
+// ---------------------------------------------------------------------------
+// Seed — one entry per stateful runtime entity category.
+// Categories: queue (HITL), executions, sessions, notifications, schedules.
+// ---------------------------------------------------------------------------
+
+export const DEFAULT_ORGANIZATION_MODEL_OPERATIONS: z.infer<typeof OperationsDomainSchema> = {
+  entries: [
+    // --- queue (HITL command queue) ---
+    {
+      id: 'operations.queue',
+      label: 'HITL Queue',
+      semanticClass: 'queue',
+      featureId: 'operations',
+      supportedStatusSemanticClass: ['queue']
+    },
+
+    // --- executions (workflow / agent executions) ---
+    {
+      id: 'operations.executions',
+      label: 'Executions',
+      semanticClass: 'executions',
+      featureId: 'operations',
+      supportedStatusSemanticClass: ['execution']
+    },
+
+    // --- sessions (agent conversation sessions) ---
+    {
+      id: 'operations.sessions',
+      label: 'Sessions',
+      semanticClass: 'sessions',
+      featureId: 'operations'
+    },
+
+    // --- notifications (platform in-app notifications) ---
+    {
+      id: 'operations.notifications',
+      label: 'Notifications',
+      semanticClass: 'notifications',
+      featureId: 'monitoring'
+    },
+
+    // --- schedules (task scheduler) ---
+    {
+      id: 'operations.schedules',
+      label: 'Schedules',
+      semanticClass: 'schedules',
+      featureId: 'operations',
+      supportedStatusSemanticClass: ['schedule', 'schedule.run']
+    }
+  ]
+}

package/src/organization-model/domains/projects.ts

@@ -1,48 +1,48 @@
-import { z } from 'zod'
-import { DisplayMetadataSchema, ModelIdSchema } from './shared'
-
-export const ProjectsDomainStateSchema = DisplayMetadataSchema.extend({
-  id: ModelIdSchema,
-  order: z.number().int().min(0)
-})
-
-export const OrganizationModelProjectsSchema = z.object({
-  projectEntityId: ModelIdSchema,
-  milestoneEntityId: ModelIdSchema,
-  taskEntityId: ModelIdSchema,
-  projectStatuses: z.array(ProjectsDomainStateSchema).min(1),
-  milestoneStatuses: z.array(ProjectsDomainStateSchema).min(1),
-  taskStatuses: z.array(ProjectsDomainStateSchema).min(1)
-})
-
-export const DEFAULT_ORGANIZATION_MODEL_PROJECTS: z.infer<typeof OrganizationModelProjectsSchema> = {
-  projectEntityId: 'delivery.project',
-  milestoneEntityId: 'delivery.milestone',
-  taskEntityId: 'delivery.task',
-  projectStatuses: [
-    { id: 'active', label: 'Active', order: 1 },
-    { id: 'on_track', label: 'On Track', order: 2 },
-    { id: 'at_risk', label: 'At Risk', order: 3 },
-    { id: 'blocked', label: 'Blocked', order: 4 },
-    { id: 'paused', label: 'Paused', order: 5 },
-    { id: 'completed', label: 'Completed', order: 6 }
-  ],
-  milestoneStatuses: [
-    { id: 'upcoming', label: 'Upcoming', order: 1 },
-    { id: 'in_progress', label: 'In Progress', order: 2 },
-    { id: 'blocked', label: 'Blocked', order: 3 },
-    { id: 'overdue', label: 'Overdue', order: 4 },
-    { id: 'completed', label: 'Completed', order: 5 }
-  ],
-  taskStatuses: [
-    { id: 'planned', label: 'Planned', order: 1 },
-    { id: 'in_progress', label: 'In Progress', order: 2 },
-    { id: 'blocked', label: 'Blocked', order: 3 },
-    { id: 'submitted', label: 'Submitted', order: 4 },
-    { id: 'approved', label: 'Approved', order: 5 },
-    { id: 'revision_requested', label: 'Revision Requested', order: 6 },
-    { id: 'rejected', label: 'Rejected', order: 7 },
-    { id: 'cancelled', label: 'Cancelled', order: 8 },
-    { id: 'completed', label: 'Completed', order: 9 }
-  ]
-}
+import { z } from 'zod'
+import { DisplayMetadataSchema, ModelIdSchema } from './shared'
+
+export const ProjectsDomainStateSchema = DisplayMetadataSchema.extend({
+  id: ModelIdSchema,
+  order: z.number().int().min(0)
+})
+
+export const OrganizationModelProjectsSchema = z.object({
+  projectEntityId: ModelIdSchema,
+  milestoneEntityId: ModelIdSchema,
+  taskEntityId: ModelIdSchema,
+  projectStatuses: z.array(ProjectsDomainStateSchema).min(1),
+  milestoneStatuses: z.array(ProjectsDomainStateSchema).min(1),
+  taskStatuses: z.array(ProjectsDomainStateSchema).min(1)
+})
+
+export const DEFAULT_ORGANIZATION_MODEL_PROJECTS: z.infer<typeof OrganizationModelProjectsSchema> = {
+  projectEntityId: 'delivery.project',
+  milestoneEntityId: 'delivery.milestone',
+  taskEntityId: 'delivery.task',
+  projectStatuses: [
+    { id: 'active', label: 'Active', order: 1 },
+    { id: 'on_track', label: 'On Track', order: 2 },
+    { id: 'at_risk', label: 'At Risk', order: 3 },
+    { id: 'blocked', label: 'Blocked', order: 4 },
+    { id: 'paused', label: 'Paused', order: 5 },
+    { id: 'completed', label: 'Completed', order: 6 }
+  ],
+  milestoneStatuses: [
+    { id: 'upcoming', label: 'Upcoming', order: 1 },
+    { id: 'in_progress', label: 'In Progress', order: 2 },
+    { id: 'blocked', label: 'Blocked', order: 3 },
+    { id: 'overdue', label: 'Overdue', order: 4 },
+    { id: 'completed', label: 'Completed', order: 5 }
+  ],
+  taskStatuses: [
+    { id: 'planned', label: 'Planned', order: 1 },
+    { id: 'in_progress', label: 'In Progress', order: 2 },
+    { id: 'blocked', label: 'Blocked', order: 3 },
+    { id: 'submitted', label: 'Submitted', order: 4 },
+    { id: 'approved', label: 'Approved', order: 5 },
+    { id: 'revision_requested', label: 'Revision Requested', order: 6 },
+    { id: 'rejected', label: 'Rejected', order: 7 },
+    { id: 'cancelled', label: 'Cancelled', order: 8 },
+    { id: 'completed', label: 'Completed', order: 9 }
+  ]
+}

package/src/organization-model/domains/prospecting.ts

@@ -1,33 +1,33 @@
-import { z } from 'zod'
-import { DescriptionSchema, DisplayMetadataSchema, ModelIdSchema } from './shared'
-
-export const ProspectingLifecycleStageSchema = DisplayMetadataSchema.extend({
-  id: ModelIdSchema,
-  order: z.number().int().min(0)
-})
-
-export const OrganizationModelProspectingSchema = z.object({
-  listEntityId: ModelIdSchema,
-  companyEntityId: ModelIdSchema,
-  contactEntityId: ModelIdSchema,
-  description: DescriptionSchema.optional(),
-  companyStages: z.array(ProspectingLifecycleStageSchema).min(1),
-  contactStages: z.array(ProspectingLifecycleStageSchema).min(1)
-})
-
-export const DEFAULT_ORGANIZATION_MODEL_PROSPECTING: z.infer<typeof OrganizationModelProspectingSchema> = {
-  listEntityId: 'leadgen.list',
-  companyEntityId: 'leadgen.company',
-  contactEntityId: 'leadgen.contact',
-  companyStages: [
-    { id: 'populated', label: 'Populated', order: 1 },
-    { id: 'extracted', label: 'Extracted', order: 2 },
-    { id: 'qualified', label: 'Qualified', order: 3 }
-  ],
-  contactStages: [
-    { id: 'discovered', label: 'Discovered', order: 1 },
-    { id: 'verified', label: 'Verified', order: 2 },
-    { id: 'personalized', label: 'Personalized', order: 3 },
-    { id: 'uploaded', label: 'Uploaded', order: 4 }
-  ]
-}
+import { z } from 'zod'
+import { DescriptionSchema, DisplayMetadataSchema, ModelIdSchema } from './shared'
+
+export const ProspectingLifecycleStageSchema = DisplayMetadataSchema.extend({
+  id: ModelIdSchema,
+  order: z.number().int().min(0)
+})
+
+export const OrganizationModelProspectingSchema = z.object({
+  listEntityId: ModelIdSchema,
+  companyEntityId: ModelIdSchema,
+  contactEntityId: ModelIdSchema,
+  description: DescriptionSchema.optional(),
+  companyStages: z.array(ProspectingLifecycleStageSchema).min(1),
+  contactStages: z.array(ProspectingLifecycleStageSchema).min(1)
+})
+
+export const DEFAULT_ORGANIZATION_MODEL_PROSPECTING: z.infer<typeof OrganizationModelProspectingSchema> = {
+  listEntityId: 'leadgen.list',
+  companyEntityId: 'leadgen.company',
+  contactEntityId: 'leadgen.contact',
+  companyStages: [
+    { id: 'populated', label: 'Populated', order: 1 },
+    { id: 'extracted', label: 'Extracted', order: 2 },
+    { id: 'qualified', label: 'Qualified', order: 3 }
+  ],
+  contactStages: [
+    { id: 'discovered', label: 'Discovered', order: 1 },
+    { id: 'verified', label: 'Verified', order: 2 },
+    { id: 'personalized', label: 'Personalized', order: 3 },
+    { id: 'uploaded', label: 'Uploaded', order: 4 }
+  ]
+}

package/src/organization-model/domains/roles.ts

@@ -1,55 +1,55 @@
-import { z } from 'zod'
-
-// ---------------------------------------------------------------------------
-// Role schema — one entry per distinct role in the organization's chart.
-// Inspired by the EOS Accountability Chart but uses plain-language field names
-// throughout. No EOS jargon: "title" (not seatTitle), "responsibilities"
-// (not accountabilities), "reportsToId", "heldBy".
-//
-// Cross-reference: `reportsToId` (when present) must resolve to another
-// `roles[].id` in the same collection. Enforcement is via
-// `OrganizationModelSchema.superRefine()` — not at the individual schema level.
-// Cycle detection is NOT enforced (known limitation; document if needed).
-// ---------------------------------------------------------------------------
-
-export const RoleSchema = z.object({
-  /** Stable unique identifier for the role (e.g. "role-ceo", "role-head-of-sales"). */
-  id: z.string().trim().min(1).max(100),
-  /** Human-readable title shown to agents and in UI (e.g. "CEO", "Head of Sales"). */
-  title: z.string().trim().min(1).max(200),
-  /**
-   * List of responsibilities this role owns — plain-language descriptions of
-   * what the person in this role is accountable for delivering.
-   * Defaults to empty array so minimal role definitions stay concise.
-   */
-  responsibilities: z.array(z.string().trim().max(500)).default([]),
-  /**
-   * Optional: ID of another role this role reports to.
-   * When present, must reference another `roles[].id` in the same organization.
-   * Cross-reference enforced in `OrganizationModelSchema.superRefine()`.
-   * Absence indicates a top-level role (no reporting line).
-   */
-  reportsToId: z.string().trim().min(1).max(100).optional(),
-  /**
-   * Optional: name or email of the person currently holding this role.
-   * Free-form string — supports "Alice Johnson", "alice@example.com", or
-   * any human-readable identifier. Not validated against any user registry.
-   */
-  heldBy: z.string().trim().max(200).optional()
-})
-
-// ---------------------------------------------------------------------------
-// Roles domain schema — a collection of roles.
-// ---------------------------------------------------------------------------
-
-export const RolesDomainSchema = z.object({
-  roles: z.array(RoleSchema).default([])
-})
-
-// ---------------------------------------------------------------------------
-// Seed — empty by default; adapters populate with real role definitions.
-// ---------------------------------------------------------------------------
-
-export const DEFAULT_ORGANIZATION_MODEL_ROLES: z.infer<typeof RolesDomainSchema> = {
-  roles: []
-}
+import { z } from 'zod'
+
+// ---------------------------------------------------------------------------
+// Role schema — one entry per distinct role in the organization's chart.
+// Inspired by the EOS Accountability Chart but uses plain-language field names
+// throughout. No EOS jargon: "title" (not seatTitle), "responsibilities"
+// (not accountabilities), "reportsToId", "heldBy".
+//
+// Cross-reference: `reportsToId` (when present) must resolve to another
+// `roles[].id` in the same collection. Enforcement is via
+// `OrganizationModelSchema.superRefine()` — not at the individual schema level.
+// Cycle detection is NOT enforced (known limitation; document if needed).
+// ---------------------------------------------------------------------------
+
+export const RoleSchema = z.object({
+  /** Stable unique identifier for the role (e.g. "role-ceo", "role-head-of-sales"). */
+  id: z.string().trim().min(1).max(100),
+  /** Human-readable title shown to agents and in UI (e.g. "CEO", "Head of Sales"). */
+  title: z.string().trim().min(1).max(200),
+  /**
+   * List of responsibilities this role owns — plain-language descriptions of
+   * what the person in this role is accountable for delivering.
+   * Defaults to empty array so minimal role definitions stay concise.
+   */
+  responsibilities: z.array(z.string().trim().max(500)).default([]),
+  /**
+   * Optional: ID of another role this role reports to.
+   * When present, must reference another `roles[].id` in the same organization.
+   * Cross-reference enforced in `OrganizationModelSchema.superRefine()`.
+   * Absence indicates a top-level role (no reporting line).
+   */
+  reportsToId: z.string().trim().min(1).max(100).optional(),
+  /**
+   * Optional: name or email of the person currently holding this role.
+   * Free-form string — supports "Alice Johnson", "alice@example.com", or
+   * any human-readable identifier. Not validated against any user registry.
+   */
+  heldBy: z.string().trim().max(200).optional()
+})
+
+// ---------------------------------------------------------------------------
+// Roles domain schema — a collection of roles.
+// ---------------------------------------------------------------------------
+
+export const RolesDomainSchema = z.object({
+  roles: z.array(RoleSchema).default([])
+})
+
+// ---------------------------------------------------------------------------
+// Seed — empty by default; adapters populate with real role definitions.
+// ---------------------------------------------------------------------------
+
+export const DEFAULT_ORGANIZATION_MODEL_ROLES: z.infer<typeof RolesDomainSchema> = {
+  roles: []
+}