@elevasis/core 0.7.0 → 0.8.0

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

@@ -1,80 +1,80 @@
-import { z } from 'zod'
-
-// ---------------------------------------------------------------------------
-// Measurable outcome schema — one trackable result that supports a goal.
-// The field name `keyResults` is used for compatibility with OKR tooling;
-// user-facing surfaces and documentation MUST say "measurable outcomes",
-// never "key results" or "OKR".
-// ---------------------------------------------------------------------------
-
-export const KeyResultSchema = z.object({
-  /** Stable unique identifier for the measurable outcome (e.g. "kr-revenue-q1"). */
-  id: z.string().trim().min(1).max(100),
-  /** Plain-language description of this measurable outcome (e.g. "Increase trial-to-paid conversion"). */
-  description: z.string().trim().min(1).max(500),
-  /**
-   * What is being measured — the metric name (e.g. "monthly revenue", "NPS score",
-   * "trial-to-paid conversion rate"). Free-form string.
-   */
-  targetMetric: z.string().trim().min(1).max(200),
-  /** Current measured value. Defaults to 0 when not yet tracked. */
-  currentValue: z.number().default(0),
-  /**
-   * Target value to reach for this measurable outcome to be considered achieved.
-   * Optional — omit if the outcome is directional (e.g. "reduce churn") without
-   * a hard numeric target.
-   */
-  targetValue: z.number().optional()
-})
-
-// ---------------------------------------------------------------------------
-// Objective schema — one goal the organization is working toward.
-// User-facing label is "goal"; this schema type is named Objective for
-// structural continuity with OKR tooling. Do NOT expose "OKR", "objective",
-// or "key result" in any user-facing label or documentation.
-//
-// Period fields use ISO 8601 date strings (YYYY-MM-DD). Cross-schema
-// validation (periodEnd > periodStart) is enforced in
-// `OrganizationModelSchema.superRefine()`.
-// ---------------------------------------------------------------------------
-
-const ISO_DATE_REGEX = /^\d{4}-\d{2}-\d{2}$/
-
-export const ObjectiveSchema = z.object({
-  /** Stable unique identifier for the goal (e.g. "goal-grow-arr-q1-2026"). */
-  id: z.string().trim().min(1).max(100),
-  /** Plain-language description of what the organization wants to achieve. */
-  description: z.string().trim().min(1).max(1000),
-  /**
-   * Start of the period this goal is active for — ISO 8601 date string (YYYY-MM-DD).
-   * Must be strictly before `periodEnd`.
-   */
-  periodStart: z.string().regex(ISO_DATE_REGEX, 'periodStart must be an ISO date string (YYYY-MM-DD)'),
-  /**
-   * End of the period this goal is active for — ISO 8601 date string (YYYY-MM-DD).
-   * Must be strictly after `periodStart`.
-   * Enforced via `OrganizationModelSchema.superRefine()`.
-   */
-  periodEnd: z.string().regex(ISO_DATE_REGEX, 'periodEnd must be an ISO date string (YYYY-MM-DD)'),
-  /**
-   * List of measurable outcomes that define success for this goal.
-   * Defaults to empty array so goals can be declared before outcomes are defined.
-   */
-  keyResults: z.array(KeyResultSchema).default([])
-})
-
-// ---------------------------------------------------------------------------
-// Goals domain schema — a collection of goals the organization is pursuing.
-// ---------------------------------------------------------------------------
-
-export const GoalsDomainSchema = z.object({
-  objectives: z.array(ObjectiveSchema).default([])
-})
-
-// ---------------------------------------------------------------------------
-// Seed — empty by default; adapters populate with real goal definitions.
-// ---------------------------------------------------------------------------
-
-export const DEFAULT_ORGANIZATION_MODEL_GOALS: z.infer<typeof GoalsDomainSchema> = {
-  objectives: []
-}
+import { z } from 'zod'
+
+// ---------------------------------------------------------------------------
+// Measurable outcome schema — one trackable result that supports a goal.
+// The field name `keyResults` is used for compatibility with OKR tooling;
+// user-facing surfaces and documentation MUST say "measurable outcomes",
+// never "key results" or "OKR".
+// ---------------------------------------------------------------------------
+
+export const KeyResultSchema = z.object({
+  /** Stable unique identifier for the measurable outcome (e.g. "kr-revenue-q1"). */
+  id: z.string().trim().min(1).max(100),
+  /** Plain-language description of this measurable outcome (e.g. "Increase trial-to-paid conversion"). */
+  description: z.string().trim().min(1).max(500),
+  /**
+   * What is being measured — the metric name (e.g. "monthly revenue", "NPS score",
+   * "trial-to-paid conversion rate"). Free-form string.
+   */
+  targetMetric: z.string().trim().min(1).max(200),
+  /** Current measured value. Defaults to 0 when not yet tracked. */
+  currentValue: z.number().default(0),
+  /**
+   * Target value to reach for this measurable outcome to be considered achieved.
+   * Optional — omit if the outcome is directional (e.g. "reduce churn") without
+   * a hard numeric target.
+   */
+  targetValue: z.number().optional()
+})
+
+// ---------------------------------------------------------------------------
+// Objective schema — one goal the organization is working toward.
+// User-facing label is "goal"; this schema type is named Objective for
+// structural continuity with OKR tooling. Do NOT expose "OKR", "objective",
+// or "key result" in any user-facing label or documentation.
+//
+// Period fields use ISO 8601 date strings (YYYY-MM-DD). Cross-schema
+// validation (periodEnd > periodStart) is enforced in
+// `OrganizationModelSchema.superRefine()`.
+// ---------------------------------------------------------------------------
+
+const ISO_DATE_REGEX = /^\d{4}-\d{2}-\d{2}$/
+
+export const ObjectiveSchema = z.object({
+  /** Stable unique identifier for the goal (e.g. "goal-grow-arr-q1-2026"). */
+  id: z.string().trim().min(1).max(100),
+  /** Plain-language description of what the organization wants to achieve. */
+  description: z.string().trim().min(1).max(1000),
+  /**
+   * Start of the period this goal is active for — ISO 8601 date string (YYYY-MM-DD).
+   * Must be strictly before `periodEnd`.
+   */
+  periodStart: z.string().regex(ISO_DATE_REGEX, 'periodStart must be an ISO date string (YYYY-MM-DD)'),
+  /**
+   * End of the period this goal is active for — ISO 8601 date string (YYYY-MM-DD).
+   * Must be strictly after `periodStart`.
+   * Enforced via `OrganizationModelSchema.superRefine()`.
+   */
+  periodEnd: z.string().regex(ISO_DATE_REGEX, 'periodEnd must be an ISO date string (YYYY-MM-DD)'),
+  /**
+   * List of measurable outcomes that define success for this goal.
+   * Defaults to empty array so goals can be declared before outcomes are defined.
+   */
+  keyResults: z.array(KeyResultSchema).default([])
+})
+
+// ---------------------------------------------------------------------------
+// Goals domain schema — a collection of goals the organization is pursuing.
+// ---------------------------------------------------------------------------
+
+export const GoalsDomainSchema = z.object({
+  objectives: z.array(ObjectiveSchema).default([])
+})
+
+// ---------------------------------------------------------------------------
+// Seed — empty by default; adapters populate with real goal definitions.
+// ---------------------------------------------------------------------------
+
+export const DEFAULT_ORGANIZATION_MODEL_GOALS: z.infer<typeof GoalsDomainSchema> = {
+  objectives: []
+}

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

@@ -1,94 +1,94 @@
-import { z } from 'zod'
-
-// ---------------------------------------------------------------------------
-// Business hours — simplest shape that captures weekday ranges.
-// Each day of the week is optional; when present it holds open/close times
-// in "HH:MM" 24-hour format. An empty object (default) means "not configured".
-// ---------------------------------------------------------------------------
-
-export const BusinessHoursDaySchema = z.object({
-  open: z
-    .string()
-    .trim()
-    .regex(/^\d{2}:\d{2}$/, 'Expected HH:MM format'),
-  close: z
-    .string()
-    .trim()
-    .regex(/^\d{2}:\d{2}$/, 'Expected HH:MM format')
-})
-
-export const BusinessHoursSchema = z
-  .object({
-    monday: BusinessHoursDaySchema.optional(),
-    tuesday: BusinessHoursDaySchema.optional(),
-    wednesday: BusinessHoursDaySchema.optional(),
-    thursday: BusinessHoursDaySchema.optional(),
-    friday: BusinessHoursDaySchema.optional(),
-    saturday: BusinessHoursDaySchema.optional(),
-    sunday: BusinessHoursDaySchema.optional()
-  })
-  .default({})
-
-// ---------------------------------------------------------------------------
-// Identity domain schema — legal identity, mission/vision, industry anchors,
-// and temporal/geographic context. Distinct from branding (display identity).
-// ---------------------------------------------------------------------------
-
-export const IdentityDomainSchema = z.object({
-  /** Why the organization exists — one or two plain-language sentences. */
-  mission: z.string().trim().max(1000).default(''),
-  /** Long-term direction the organization is moving toward. */
-  vision: z.string().trim().max(1000).default(''),
-  /** Legal registered name of the entity. */
-  legalName: z.string().trim().max(200).default(''),
-  /**
-   * Type of legal entity (e.g. "LLC", "Corporation", "Sole Proprietor",
-   * "Non-profit"). Free-form string so it covers any jurisdiction.
-   */
-  entityType: z.string().trim().max(100).default(''),
-  /**
-   * Primary jurisdiction of registration or operation
-   * (e.g. "United States – Delaware", "Canada – Ontario").
-   */
-  jurisdiction: z.string().trim().max(200).default(''),
-  /**
-   * Industry category — broad classification (e.g. "Marketing Agency",
-   * "Software / SaaS", "Professional Services").
-   */
-  industryCategory: z.string().trim().max(200).default(''),
-  /**
-   * Geographic focus — where the organization primarily operates or serves
-   * (e.g. "North America", "Global", "Southeast Asia").
-   */
-  geographicFocus: z.string().trim().max(200).default(''),
-  /**
-   * IANA timezone identifier for the organization's primary operating timezone
-   * (e.g. "America/Los_Angeles", "Europe/London", "UTC").
-   */
-  timeZone: z.string().trim().max(100).default('UTC'),
-  /** Typical operating hours per day of week. Empty object means not configured. */
-  businessHours: BusinessHoursSchema,
-  /**
-   * Long-form markdown capturing client context, problem narrative, and domain
-   * background. Populated by /setup; surfaced to agents as organizational context.
-   * Optional — many projects have no external client.
-   */
-  clientBrief: z.string().trim().default('')
-})
-
-// ---------------------------------------------------------------------------
-// Seed — placeholder defaults; external adapters override per organization.
-// ---------------------------------------------------------------------------
-
-export const DEFAULT_ORGANIZATION_MODEL_IDENTITY: z.infer<typeof IdentityDomainSchema> = {
-  mission: '',
-  vision: '',
-  legalName: '',
-  entityType: '',
-  jurisdiction: '',
-  industryCategory: '',
-  geographicFocus: '',
-  timeZone: 'UTC',
-  businessHours: {},
-  clientBrief: ''
-}
+import { z } from 'zod'
+
+// ---------------------------------------------------------------------------
+// Business hours — simplest shape that captures weekday ranges.
+// Each day of the week is optional; when present it holds open/close times
+// in "HH:MM" 24-hour format. An empty object (default) means "not configured".
+// ---------------------------------------------------------------------------
+
+export const BusinessHoursDaySchema = z.object({
+  open: z
+    .string()
+    .trim()
+    .regex(/^\d{2}:\d{2}$/, 'Expected HH:MM format'),
+  close: z
+    .string()
+    .trim()
+    .regex(/^\d{2}:\d{2}$/, 'Expected HH:MM format')
+})
+
+export const BusinessHoursSchema = z
+  .object({
+    monday: BusinessHoursDaySchema.optional(),
+    tuesday: BusinessHoursDaySchema.optional(),
+    wednesday: BusinessHoursDaySchema.optional(),
+    thursday: BusinessHoursDaySchema.optional(),
+    friday: BusinessHoursDaySchema.optional(),
+    saturday: BusinessHoursDaySchema.optional(),
+    sunday: BusinessHoursDaySchema.optional()
+  })
+  .default({})
+
+// ---------------------------------------------------------------------------
+// Identity domain schema — legal identity, mission/vision, industry anchors,
+// and temporal/geographic context. Distinct from branding (display identity).
+// ---------------------------------------------------------------------------
+
+export const IdentityDomainSchema = z.object({
+  /** Why the organization exists — one or two plain-language sentences. */
+  mission: z.string().trim().max(1000).default(''),
+  /** Long-term direction the organization is moving toward. */
+  vision: z.string().trim().max(1000).default(''),
+  /** Legal registered name of the entity. */
+  legalName: z.string().trim().max(200).default(''),
+  /**
+   * Type of legal entity (e.g. "LLC", "Corporation", "Sole Proprietor",
+   * "Non-profit"). Free-form string so it covers any jurisdiction.
+   */
+  entityType: z.string().trim().max(100).default(''),
+  /**
+   * Primary jurisdiction of registration or operation
+   * (e.g. "United States – Delaware", "Canada – Ontario").
+   */
+  jurisdiction: z.string().trim().max(200).default(''),
+  /**
+   * Industry category — broad classification (e.g. "Marketing Agency",
+   * "Software / SaaS", "Professional Services").
+   */
+  industryCategory: z.string().trim().max(200).default(''),
+  /**
+   * Geographic focus — where the organization primarily operates or serves
+   * (e.g. "North America", "Global", "Southeast Asia").
+   */
+  geographicFocus: z.string().trim().max(200).default(''),
+  /**
+   * IANA timezone identifier for the organization's primary operating timezone
+   * (e.g. "America/Los_Angeles", "Europe/London", "UTC").
+   */
+  timeZone: z.string().trim().max(100).default('UTC'),
+  /** Typical operating hours per day of week. Empty object means not configured. */
+  businessHours: BusinessHoursSchema,
+  /**
+   * Long-form markdown capturing client context, problem narrative, and domain
+   * background. Populated by /setup; surfaced to agents as organizational context.
+   * Optional — many projects have no external client.
+   */
+  clientBrief: z.string().trim().default('')
+})
+
+// ---------------------------------------------------------------------------
+// Seed — placeholder defaults; external adapters override per organization.
+// ---------------------------------------------------------------------------
+
+export const DEFAULT_ORGANIZATION_MODEL_IDENTITY: z.infer<typeof IdentityDomainSchema> = {
+  mission: '',
+  vision: '',
+  legalName: '',
+  entityType: '',
+  jurisdiction: '',
+  industryCategory: '',
+  geographicFocus: '',
+  timeZone: 'UTC',
+  businessHours: {},
+  clientBrief: ''
+}