@elevasis/sdk 1.26.0 → 1.26.1

package/dist/cli.cjs

@@ -37181,15 +37181,55 @@ var ResourceMappingSchema = DisplayMetadataSchema.extend({
 
 // ../core/src/organization-model/domains/branding.ts
 var OrganizationModelBrandingSchema = external_exports.object({
+  /**
+   * @deprecated Prefer `identity.organizationName`; branding retains it for back-compat.
+   * Legacy tenants that have not set `identity.organizationName` fall back to this field.
+   */
   organizationName: LabelSchema,
+  /**
+   * @deprecated Prefer `identity.productName`; branding retains it for back-compat.
+   * Legacy tenants that have not set `identity.productName` fall back to this field.
+   */
   productName: LabelSchema,
+  /**
+   * @deprecated Prefer `identity.shortName`; branding retains it for back-compat.
+   * Legacy tenants that have not set `identity.shortName` fall back to this field.
+   */
   shortName: external_exports.string().trim().min(1).max(40),
+  /**
+   * @deprecated Prefer `identity.description`; branding retains it for back-compat.
+   * Legacy tenants that have not set `identity.description` fall back to this field.
+   */
   description: DescriptionSchema.optional(),
   logos: external_exports.object({
     light: external_exports.string().trim().min(1).max(2048).optional(),
     dark: external_exports.string().trim().min(1).max(2048).optional()
-  }).default({})
-});
+  }).default({}),
+  /**
+   * Brand voice — how the organization communicates. Plain-language description
+   * of tone, register, and personality (e.g. "Direct and human — no jargon").
+   * Max 280 characters.
+   */
+  voice: external_exports.string().trim().max(280).optional(),
+  /**
+   * Brand tagline or positioning statement — the memorable one-liner that
+   * captures the brand's promise or differentiator. Max 200 characters.
+   */
+  tagline: external_exports.string().trim().max(200).optional(),
+  /**
+   * Core brand values — an ordered list of principles the organization stands
+   * for (e.g. ["Transparency", "Craftsmanship", "Velocity"]). Each entry must
+   * be a non-empty trimmed string.
+   */
+  values: external_exports.array(external_exports.string().trim().min(1)).optional(),
+  /**
+   * ID of the active UI theme preset from the UI theme-presets registry.
+   * The UI layer resolves this to colors and typography via `usePresetsContext()`.
+   * Free-form string — validation and fallback state are handled at the UI layer.
+   * Min 1, max 64 characters.
+   */
+  themePresetId: external_exports.string().trim().min(1).max(64).optional()
+}).passthrough();
 var DEFAULT_ORGANIZATION_MODEL_BRANDING = {
   organizationName: "Default Organization",
   productName: "Organization OS",
@@ -37312,8 +37352,33 @@ var IdentityDomainSchema = external_exports.object({
    * background. Populated by /setup; surfaced to agents as organizational context.
    * Optional — many projects have no external client.
    */
-  clientBrief: external_exports.string().trim().default("")
-});
+  clientBrief: external_exports.string().trim().default(""),
+  /**
+   * Display name of the organization as shown to end users.
+   * Recommended placement for display naming — prefer this over the deprecated
+   * `branding.organizationName`. Falls back to `branding.organizationName` for
+   * legacy tenants that have not yet migrated.
+   */
+  organizationName: LabelSchema.optional(),
+  /**
+   * Display name of the primary product or platform.
+   * Recommended placement for display naming — prefer this over the deprecated
+   * `branding.productName`. Falls back to `branding.productName` for legacy tenants.
+   */
+  productName: LabelSchema.optional(),
+  /**
+   * Short abbreviated name used in space-constrained UI surfaces (max 40 chars).
+   * Recommended placement for display naming — prefer this over the deprecated
+   * `branding.shortName`. Falls back to `branding.shortName` for legacy tenants.
+   */
+  shortName: external_exports.string().trim().min(1).max(40).optional(),
+  /**
+   * Plain-language description of the organization for display and discovery.
+   * Recommended placement for display naming — prefer this over the deprecated
+   * `branding.description`. Falls back to `branding.description` for legacy tenants.
+   */
+  description: DescriptionSchema.optional()
+}).passthrough();
 var DEFAULT_ORGANIZATION_MODEL_IDENTITY = {
   mission: "",
   vision: "",
@@ -44059,7 +44124,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.26.0",
+  version: "1.26.1",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {

package/dist/index.d.ts

@@ -2884,6 +2884,51 @@ type Database = {
                     }
                 ];
             };
+            deployment_organization_models: {
+                Row: {
+                    created_at: string;
+                    deployment_id: string;
+                    model_hash: string | null;
+                    organization_id: string;
+                    organization_model: Json;
+                    schema_version: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    created_at?: string;
+                    deployment_id: string;
+                    model_hash?: string | null;
+                    organization_id: string;
+                    organization_model: Json;
+                    schema_version?: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    created_at?: string;
+                    deployment_id?: string;
+                    model_hash?: string | null;
+                    organization_id?: string;
+                    organization_model?: Json;
+                    schema_version?: string;
+                    updated_at?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "deployment_organization_models_deployment_id_fkey";
+                        columns: ["deployment_id"];
+                        isOneToOne: true;
+                        referencedRelation: "deployments";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "deployment_organization_models_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
             deployments: {
                 Row: {
                     created_at: string;
@@ -6897,7 +6942,11 @@ declare const OrganizationModelSchema$1: z.ZodObject<{
             light: z.ZodOptional<z.ZodString>;
             dark: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
-    }, z.core.$strip>>;
+        voice: z.ZodOptional<z.ZodString>;
+        tagline: z.ZodOptional<z.ZodString>;
+        values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        themePresetId: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
     navigation: z.ZodDefault<z.ZodObject<{
         sidebar: z.ZodDefault<z.ZodObject<{
             primary: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<SidebarNode, unknown, z.core.$ZodTypeInternals<SidebarNode, unknown>>>>;
@@ -6944,7 +6993,11 @@ declare const OrganizationModelSchema$1: z.ZodObject<{
             }, z.core.$strip>>;
         }, z.core.$strip>>;
         clientBrief: z.ZodDefault<z.ZodString>;
-    }, z.core.$strip>>;
+        organizationName: z.ZodOptional<z.ZodString>;
+        productName: z.ZodOptional<z.ZodString>;
+        shortName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
     customers: z.ZodDefault<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         order: z.ZodNumber;

package/dist/node/index.d.ts

@@ -1674,7 +1674,11 @@ declare const OrganizationModelSchema$1: z.ZodObject<{
             light: z.ZodOptional<z.ZodString>;
             dark: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
-    }, z.core.$strip>>;
+        voice: z.ZodOptional<z.ZodString>;
+        tagline: z.ZodOptional<z.ZodString>;
+        values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        themePresetId: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
     navigation: z.ZodDefault<z.ZodObject<{
         sidebar: z.ZodDefault<z.ZodObject<{
             primary: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<SidebarNode, unknown, z.core.$ZodTypeInternals<SidebarNode, unknown>>>>;
@@ -1721,7 +1725,11 @@ declare const OrganizationModelSchema$1: z.ZodObject<{
             }, z.core.$strip>>;
         }, z.core.$strip>>;
         clientBrief: z.ZodDefault<z.ZodString>;
-    }, z.core.$strip>>;
+        organizationName: z.ZodOptional<z.ZodString>;
+        productName: z.ZodOptional<z.ZodString>;
+        shortName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
     customers: z.ZodDefault<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         order: z.ZodNumber;

package/dist/test-utils/index.d.ts

@@ -2717,6 +2717,51 @@ type Database = {
                     }
                 ];
             };
+            deployment_organization_models: {
+                Row: {
+                    created_at: string;
+                    deployment_id: string;
+                    model_hash: string | null;
+                    organization_id: string;
+                    organization_model: Json;
+                    schema_version: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    created_at?: string;
+                    deployment_id: string;
+                    model_hash?: string | null;
+                    organization_id: string;
+                    organization_model: Json;
+                    schema_version?: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    created_at?: string;
+                    deployment_id?: string;
+                    model_hash?: string | null;
+                    organization_id?: string;
+                    organization_model?: Json;
+                    schema_version?: string;
+                    updated_at?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "deployment_organization_models_deployment_id_fkey";
+                        columns: ["deployment_id"];
+                        isOneToOne: true;
+                        referencedRelation: "deployments";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "deployment_organization_models_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
             deployments: {
                 Row: {
                     created_at: string;
@@ -6095,7 +6140,11 @@ declare const OrganizationModelSchema: z.ZodObject<{
             light: z.ZodOptional<z.ZodString>;
             dark: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
-    }, z.core.$strip>>;
+        voice: z.ZodOptional<z.ZodString>;
+        tagline: z.ZodOptional<z.ZodString>;
+        values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        themePresetId: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
     navigation: z.ZodDefault<z.ZodObject<{
         sidebar: z.ZodDefault<z.ZodObject<{
             primary: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<SidebarNode, unknown, z.core.$ZodTypeInternals<SidebarNode, unknown>>>>;
@@ -6142,7 +6191,11 @@ declare const OrganizationModelSchema: z.ZodObject<{
             }, z.core.$strip>>;
         }, z.core.$strip>>;
         clientBrief: z.ZodDefault<z.ZodString>;
-    }, z.core.$strip>>;
+        organizationName: z.ZodOptional<z.ZodString>;
+        productName: z.ZodOptional<z.ZodString>;
+        shortName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
     customers: z.ZodDefault<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         order: z.ZodNumber;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "1.26.0",
+  "version": "1.26.1",
   "description": "SDK for building Elevasis organization resources",
   "type": "module",
   "bin": {
@@ -58,7 +58,7 @@
     "tsup": "^8.0.0",
     "typescript": "5.9.2",
     "zod": "^4.1.0",
-    "@repo/core": "0.31.0",
+    "@repo/core": "0.32.0",
     "@repo/eslint-config": "0.0.0",
     "@repo/typescript-config": "0.0.0"
   },

package/reference/claude-config/skills/setup/SKILL.md

@@ -23,7 +23,7 @@ Before collecting any information or running any steps, determine which state th
 
 **State A — Virgin (placeholders present):** One or more of the above placeholder strings is found. Run the full bootstrap flow (Steps 1–7 below), then hand off to `/om`.
 
-**State B — Already bootstrapped, org-model at defaults:** No placeholders found, but `core/config/organization-model.ts` contains only the default branding override (just `branding.organizationName`, `branding.productName`, `branding.shortName` — no identity, customers, offerings, roles, goals, or techStack overrides). Print:
+**State B — Already bootstrapped, org-model at defaults:** No placeholders found, but `core/config/organization-model.ts` contains only the default display naming override (just `identity.organizationName`, `identity.productName`, `identity.shortName`, with legacy `branding.*` fallback values — no customers, offerings, roles, goals, or techStack overrides). Print:
 
 ```
 This project is already set up. The organization model has not been configured yet.
@@ -32,7 +32,7 @@ Running /om to set up your organization profile...
 
 Then execute `/om` (the full layered flow) and stop.
 
-**State C — Fully configured:** No placeholders found AND `core/config/organization-model.ts` has at least one non-branding domain populated (identity, customers, offerings, roles, goals, or techStack present). Print:
+**State C — Fully configured:** No placeholders found AND `core/config/organization-model.ts` has at least one non-default business domain populated (customers, offerings, roles, goals, techStack, or identity fields beyond display naming/client brief). Print:
 
 ```
 This project is already configured. To update your organization profile, run /om.

package/reference/claude-config/sync-notes/2026-05-23-branding-names-to-identity.md

@@ -0,0 +1,49 @@
+# Branding Names to Identity
+
+## Why this note exists
+
+The Organization Model now treats `identity.organizationName`, `identity.productName`,
+and `identity.shortName` as the preferred source for display naming. The older
+`branding.*` name fields remain valid for backward compatibility, but new template code
+reads identity first and falls back to branding only for legacy projects.
+
+Branding also now supports first-class expression fields such as `voice`, `tagline`,
+`values`, and `themePresetId`, while still accepting tenant-specific passthrough fields.
+
+## Applies to
+
+Template-derived projects that customize Organization Model branding or read
+`organizationModel.branding.organizationName`, `productName`, or `shortName` directly in
+UI or setup code.
+
+## Required actions
+
+1. Keep existing `branding.organizationName`, `branding.productName`, and
+   `branding.shortName` values in place for compatibility.
+2. Add matching values under `identity.organizationName`, `identity.productName`, and
+   `identity.shortName`.
+3. Update project UI code to read `identity.* ?? branding.*` for display naming.
+4. Move brand expression into the broadened `branding` fields: `voice`, `tagline`,
+   `values`, `themePresetId`, and project-owned passthrough fields as needed.
+
+## Verification
+
+Run the normal template-derived project gates after syncing:
+
+```powershell
+pnpm -C core test
+pnpm -C ui check-types
+pnpm -C ui build
+pnpm -C operations check-types
+pnpm -C operations check
+```
+
+Also open the app shell and Knowledge Base identity/branding views. Confirm display names
+render from identity and branding expression fields render under Branding.
+
+## Not handled by /git-sync
+
+`/git-sync` cannot choose real brand voice, tagline, values, logo assets, or custom
+passthrough fields for an individual tenant. It also cannot remove legacy
+`branding.*` name fields from project-specific code until maintainers confirm every
+consumer has migrated to the identity-first fallback.

package/reference/claude-config/sync-notes/2026-05-23-om-deployment-drift-detection.md

@@ -0,0 +1,42 @@
+# OM Deployment Drift Detection
+
+## Why this note exists
+
+The platform API now persists deployed Organization Model snapshots and validates tenant
+lead-gen and CRM catalogs against the requesting tenant's active deployed model. The
+template does not need source changes for this server-side fix, but template-derived
+projects should accept the `@elevasis/core` package baseline when this release train
+publishes it so generated database and shared type surfaces stay aligned.
+
+## Applies to
+
+Template-derived projects that use SDK deployments, lead-gen list creation, CRM stages,
+or CRM actions through the hosted Elevasis API.
+
+## Required actions
+
+1. Pull the package baseline update produced by this ship train.
+2. Redeploy or verify tenant operations resources if the project has recently changed its
+   Organization Model catalogs.
+3. After the API deployment stage completes, smoke lead-gen list creation with a
+   project-owned build template ID.
+
+## Verification
+
+Run the normal template-derived project gates after syncing:
+
+```powershell
+pnpm -C core test
+pnpm -C operations check-types
+pnpm -C operations check
+pnpm -C ui check-types
+pnpm -C ui build
+```
+
+For projects using lead-gen, also verify list creation against the hosted API with a
+tenant-owned build template ID.
+
+## Not handled by /git-sync
+
+`/git-sync` cannot apply the production database change or deploy the hosted API. It also
+does not create project-specific Organization Model catalogs or workflow resources.

package/reference/cli-management.mdx

@@ -149,9 +149,9 @@ For exact required flags and accepted enum values, see the command source under
 
 ## elevasis-sdk note:\*
 
-`elevasis-sdk note:*` is the agent-facing surface for pushing and reading personal user notes. Workflows and agents use it to surface information -- such as "deal X stalled" or "review run completed" -- directly into a user's Notes panel in the Command Center, without sending an email or notification.
+`elevasis-sdk note:*` is the agent-facing surface for pushing and reading user notes. Workflows and agents use it to surface information -- such as "deal X stalled" or "review run completed" -- directly into a user's Notes panel in the Command Center, without sending an email or notification.
 
-Notes are personal to the target user and scoped to the calling organization. The external API surface exposes `GET + POST` only; `note:update` and `note:delete` are not yet available via SDK CLI. Users edit and delete notes through the right-panel view in the Command Center.
+Agent-written notes are private to the target user and scoped to the calling organization. The authenticated Notes panel can also create and edit org-shared notes (`visibility: 'org'`), which are visible to active members of the same organization and show creator attribution. The external SDK CLI surface exposes `GET + POST` only; `note:update` and `note:delete` are not yet available via SDK CLI. Users edit, delete, and change visibility through the right-panel view.
 
 ### note:create
 
@@ -187,6 +187,7 @@ elevasis-sdk note:create --content <text>
 - Posts to `POST /api/external/user-notes`
 - When `--user` is omitted the note is created for the identity bound to the API key (the caller)
 - When `--user` is provided the platform resolves the email to a Supabase user UUID and verifies the resolved user is an active member of the calling organization before writing
+- External agent-created notes are always private; org-shared visibility is a signed-in UI capability, not a broadcast CLI mode
 - The `--source` flag is recorded as the `source` column in `user_notes`; agent runtimes should pass their resource ID here so users can see which workflow created the note
 - Priority `normal` produces no badge in the UI; `high` renders orange, `urgent` renders red, `low` renders dimmed gray
 
@@ -279,9 +280,9 @@ elevasis-sdk note:list --user ops@acme.com --priority high --pinned --pretty
 
 ### Command Boundary
 
-- `note:create` and `note:list` operate on the **personal notes** surface -- not project notes. For project-scoped notes use `project:note:*`.
+- `note:create` and `note:list` operate on the **user notes** surface -- not project notes. For project-scoped notes use `project:note:*`.
 - `note:update` and `note:delete` are not yet available via SDK CLI. Edit and delete notes using the Notes panel in the Command Center.
-- The Notes panel view (`NotesPanelView`) is registered in the right-panel registry alongside Overview, Recent Executions, and Notifications.
+- The shared Notes panel view (`NotesPanelView`) is exported from `@elevasis/ui/features/notes` and registered in the right-panel registry alongside Overview, Recent Executions, and Notifications.
 
 **Implementation:** `packages/sdk/src/cli/commands/notes.ts` -- delegates to `POST /api/external/user-notes` and `GET /api/external/user-notes`
 
@@ -289,7 +290,8 @@ elevasis-sdk note:list --user ops@acme.com --priority high --pinned --pretty
 
 The following invariants govern the Notes feature and are relevant when building agents or workflows that write notes:
 
-- **Scope:** Notes are user-scoped and organization-scoped by default. A user can optionally make a note global, but the default scope is the current org.
+- **Scope:** Notes are user-scoped and organization-scoped by default. A signed-in user can mark a note as org-shared; agent-created notes stay private to the target user.
+- **Org-shared visibility:** `visibility: 'org'` lets active org members see and edit the note. Only the creator can change the visibility value.
 - **Sort order:** Pinned first, then by priority (`urgent` > `high` > `normal` > `low`), then by most recently updated.
 - **Broadcast:** Out of scope. Agents create notes for one resolved user at a time. Broadcast is a notifications concern, not a notes concern.
 - **Retention:** Notes persist until the user explicitly deletes them. There is no TTL and no dismissed state.

package/reference/examples/organization-model.ts

@@ -7,13 +7,23 @@
 import { defineOrganizationModel, defineResources } from '@elevasis/core/organization-model'
 
 // ---------------------------------------------------------------------------
-// Branding override
+// Identity and branding override
 // ---------------------------------------------------------------------------
 export const brandingOverrideExample = defineOrganizationModel({
+  identity: {
+    organizationName: 'Northstar Studio',
+    productName: 'Northstar Ops',
+    shortName: 'Northstar'
+  },
   branding: {
-    organizationName: 'Acme Corp',
-    productName: 'Acme Command Center',
-    shortName: 'Acme'
+    logos: {
+      light: '/brand/northstar-logo-light.svg',
+      dark: '/brand/northstar-logo-dark.svg'
+    },
+    voice: 'Clear, practical, and calm.',
+    tagline: 'Operational clarity for growing teams.',
+    values: ['Clarity', 'Reliability', 'Momentum'],
+    themePresetId: 'northstar'
   }
 })