@elevasis/sdk 1.30.2 → 1.32.0

package/dist/cli.cjs

@@ -37935,6 +37935,7 @@ function buildOmCrossRefIndex(model) {
     systemsById.set(system.id, system);
   }
   const resourceIds = new Set(Object.keys(model.resources ?? {}));
+  const clientIds = new Set(Object.keys(model.clients ?? {}));
   const knowledgeIds = new Set(Object.keys(model.knowledge ?? {}));
   const roleIds = new Set(Object.keys(model.roles ?? {}));
   const goalIds = new Set(Object.keys(model.goals ?? {}));
@@ -37968,6 +37969,7 @@ function buildOmCrossRefIndex(model) {
   return {
     systemsById,
     resourceIds,
+    clientIds,
     knowledgeIds,
     roleIds,
     goalIds,
@@ -37981,6 +37983,7 @@ function buildOmCrossRefIndex(model) {
 }
 function knowledgeTargetExists(index, kind, id) {
   if (kind === "system") return index.systemsById.has(id);
+  if (kind === "client") return index.clientIds.has(id);
   if (kind === "resource") return index.resourceIds.has(id);
   if (kind === "knowledge") return index.knowledgeIds.has(id);
   if (kind === "stage") return index.stageIds.has(id);
@@ -38924,6 +38927,7 @@ var DEFAULT_ORGANIZATION_MODEL_GOALS = {};
 // ../core/src/organization-model/domains/knowledge.ts
 var KnowledgeTargetKindSchema = external_exports.enum([
   "system",
+  "client",
   "resource",
   "knowledge",
   "stage",
@@ -39185,10 +39189,10 @@ function asRoleHolderArray(heldBy) {
 function isKnowledgeKindCompatibleWithTarget(knowledgeKind, targetKind) {
   if (knowledgeKind === "reference") return true;
   if (knowledgeKind === "playbook") {
-    return ["system", "resource", "stage", "action", "ontology"].includes(targetKind);
+    return ["system", "client", "resource", "stage", "action", "ontology"].includes(targetKind);
   }
   if (knowledgeKind === "strategy") {
-    return ["system", "goal", "offering", "customer-segment", "ontology"].includes(targetKind);
+    return ["system", "client", "goal", "offering", "customer-segment", "ontology"].includes(targetKind);
   }
   return false;
 }
@@ -39717,9 +39721,68 @@ function refineOrganizationModel(model, ctx) {
 }
 
 // ../core/src/organization-model/schema.ts
+var ClientProfileIdSchema = external_exports.string().uuid();
+var ClientProfileStatusSchema = external_exports.enum(["active", "onboarding", "paused", "completed", "churned"]);
+var ClientProfileSourceSchema = external_exports.string().trim().min(1).max(64).regex(/^[a-z][a-z0-9_]*$/, "Source must use lowercase letters, numbers, and underscores");
+var ClientProfileIdentitySchema = external_exports.object({
+  organizationName: LabelSchema.optional(),
+  shortName: external_exports.string().trim().min(1).max(40).optional(),
+  clientBrief: external_exports.string().trim().max(4e3).default(""),
+  geographicFocus: external_exports.array(external_exports.string().trim().min(1).max(200)).default([]),
+  timeZone: external_exports.string().trim().min(1).max(100).default("UTC")
+}).passthrough().default({
+  clientBrief: "",
+  geographicFocus: [],
+  timeZone: "UTC"
+});
+var ClientProfileBrandingSchema = external_exports.object({
+  voice: external_exports.string().trim().max(280).optional(),
+  tagline: external_exports.string().trim().max(200).optional(),
+  values: external_exports.array(external_exports.string().trim().min(1).max(100)).default([])
+}).passthrough().default({
+  values: []
+});
+var ClientProfileWorkspaceSchema = external_exports.object({
+  kind: external_exports.enum(["external-project", "internal-project", "none"]).optional(),
+  owner: external_exports.enum(["developer", "client", "platform"]).optional(),
+  projectId: external_exports.string().trim().min(1).max(200).optional(),
+  workspacePath: external_exports.string().trim().min(1).max(500).optional()
+}).passthrough().default({});
+var ClientProfileLinksSchema = external_exports.object({
+  projectIds: external_exports.array(external_exports.string().uuid()).default([]),
+  primaryCompanyId: external_exports.string().uuid().optional(),
+  primaryContactId: external_exports.string().uuid().optional(),
+  sourceDealId: external_exports.string().uuid().optional()
+}).default({
+  projectIds: []
+});
+var ClientProfilePromptsSchema = external_exports.object({
+  defaultContext: external_exports.string().trim().max(8e3).default("")
+}).passthrough().default({
+  defaultContext: ""
+});
+var ClientProfileSchema = external_exports.object({
+  id: ClientProfileIdSchema,
+  slug: ModelIdSchema,
+  name: LabelSchema,
+  status: ClientProfileStatusSchema.default("onboarding"),
+  source: ClientProfileSourceSchema.optional(),
+  identity: ClientProfileIdentitySchema,
+  branding: ClientProfileBrandingSchema,
+  workspace: ClientProfileWorkspaceSchema,
+  links: ClientProfileLinksSchema,
+  prompts: ClientProfilePromptsSchema,
+  config: external_exports.record(external_exports.string().trim().min(1).max(200), JsonValueSchema).default({}),
+  customValues: external_exports.record(external_exports.string().trim().min(1).max(200), JsonValueSchema).default({})
+}).strict();
+var ClientProfilesDomainSchema = external_exports.record(ClientProfileIdSchema, ClientProfileSchema).refine((record2) => Object.entries(record2).every(([key, entry]) => entry.id === key), {
+  message: "Each client profile id must match its map key"
+}).default({});
+var DEFAULT_ORGANIZATION_MODEL_CLIENTS = {};
 var OrganizationModelDomainKeySchema = external_exports.enum([
   "branding",
   "identity",
+  "clients",
   "customers",
   "offerings",
   "roles",
@@ -39740,6 +39803,7 @@ var OrganizationModelDomainMetadataSchema = external_exports.object({
 var DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA = {
   branding: { version: 1, lastModified: "2026-05-10" },
   identity: { version: 1, lastModified: "2026-05-10" },
+  clients: { version: 1, lastModified: "2026-05-30" },
   customers: { version: 1, lastModified: "2026-05-10" },
   offerings: { version: 1, lastModified: "2026-05-10" },
   roles: { version: 1, lastModified: "2026-05-10" },
@@ -39756,6 +39820,7 @@ var DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA = {
 var OrganizationModelDomainMetadataByDomainSchema = external_exports.object({
   branding: OrganizationModelDomainMetadataSchema,
   identity: OrganizationModelDomainMetadataSchema,
+  clients: OrganizationModelDomainMetadataSchema,
   customers: OrganizationModelDomainMetadataSchema,
   offerings: OrganizationModelDomainMetadataSchema,
   roles: OrganizationModelDomainMetadataSchema,
@@ -39771,10 +39836,23 @@ var OrganizationModelDomainMetadataByDomainSchema = external_exports.object({
 }).partial().default(DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA).transform((metadata) => ({ ...DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA, ...metadata }));
 var OrganizationModelSchemaBase = external_exports.object({
   version: external_exports.literal(1).default(1),
+  /**
+   * Deterministic SHA-256 hex hash of the full resolved model, excluding this
+   * field itself and volatile domainMetadata.lastModified values.
+   *
+   * Stamped at deploy time by the platform OM assembly and persisted alongside
+   * the snapshot in the DB. Compared at API boot to detect stale deployed
+   * snapshots (primary gate: deploy; secondary backstop: boot).
+   *
+   * Optional — absent on models that predate Step 2 versioning or that have
+   * not been stamped (e.g. tenant partial overrides before re-deploy).
+   */
+  snapshotHash: external_exports.string().optional(),
   domainMetadata: OrganizationModelDomainMetadataByDomainSchema,
   branding: OrganizationModelBrandingSchema.default(DEFAULT_ORGANIZATION_MODEL_BRANDING),
   navigation: OrganizationModelNavigationSchema,
   identity: IdentityDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_IDENTITY),
+  clients: ClientProfilesDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_CLIENTS),
   customers: CustomersDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_CUSTOMERS),
   offerings: OfferingsDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_OFFERINGS),
   roles: RolesDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_ROLES),
@@ -39807,6 +39885,7 @@ var DEFAULT_ORGANIZATION_MODEL = {
   branding: DEFAULT_ORGANIZATION_MODEL_BRANDING,
   navigation: DEFAULT_ORGANIZATION_MODEL_NAVIGATION,
   identity: DEFAULT_ORGANIZATION_MODEL_IDENTITY,
+  clients: DEFAULT_ORGANIZATION_MODEL_CLIENTS,
   customers: DEFAULT_ORGANIZATION_MODEL_CUSTOMERS,
   offerings: DEFAULT_ORGANIZATION_MODEL_OFFERINGS,
   roles: DEFAULT_ORGANIZATION_MODEL_ROLES,
@@ -39973,6 +40052,7 @@ function getAllProjectStatuses(model, appliesTo) {
 var OrganizationGraphNodeKindSchema = external_exports.enum([
   "organization",
   "system",
+  "client",
   "role",
   "action",
   "entity",
@@ -40218,6 +40298,22 @@ function buildOrganizationGraph(input) {
   }
   const validSystemRefs = new Set(systemPathByRef.keys());
   const systemNodeId = (systemRef) => nodeId("system", systemPathByRef.get(systemRef) ?? systemRef);
+  for (const client of Object.values(organizationModel.clients).sort((a, b) => a.slug.localeCompare(b.slug))) {
+    const id = nodeId("client", client.id);
+    pushUniqueNode(nodes, nodeIds, {
+      id,
+      kind: "client",
+      label: client.name,
+      sourceId: client.id,
+      description: client.identity.clientBrief || void 0
+    });
+    pushUniqueEdge(edges, edgeIds, {
+      id: edgeId("contains", organizationNode.id, id),
+      kind: "contains",
+      sourceId: organizationNode.id,
+      targetId: id
+    });
+  }
   function topologyNodeId(ref) {
     if (ref.kind === "system") return systemNodeId(ref.id);
     if (ref.kind === "resource") return nodeId("resource", ref.id);
@@ -41585,7 +41681,13 @@ function computeInterfaceReadiness(model, request) {
       `System "${request.systemPath}" is missing.`,
       { ref: request.systemPath }
     );
-    return { ready: false, systemPath: request.systemPath, interfaceKey: request.interfaceKey, scopedResourceIds, issues };
+    return {
+      ready: false,
+      systemPath: request.systemPath,
+      interfaceKey: request.interfaceKey,
+      scopedResourceIds,
+      issues
+    };
   }
   if (systemInterface === void 0) {
     addReadinessIssue(
@@ -41595,7 +41697,13 @@ function computeInterfaceReadiness(model, request) {
       `System "${request.systemPath}" does not declare interface "${request.interfaceKey}".`,
       { path: readinessMarkerPath(request) }
     );
-    return { ready: false, systemPath: request.systemPath, interfaceKey: request.interfaceKey, scopedResourceIds, issues };
+    return {
+      ready: false,
+      systemPath: request.systemPath,
+      interfaceKey: request.interfaceKey,
+      scopedResourceIds,
+      issues
+    };
   }
   if (systemInterface.lifecycle !== "active") {
     addReadinessIssue(
@@ -45608,7 +45716,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.30.2",
+  version: "1.32.0",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {
@@ -48381,6 +48489,15 @@ function governedBy(graph, nodeId2) {
   }
   return results;
 }
+function listAllSystemsFlat(model) {
+  return listAllSystems(model);
+}
+function listAllResources(model) {
+  return Object.values(model.resources ?? {}).sort((a, b) => a.id.localeCompare(b.id));
+}
+function listAllRoles(model) {
+  return Object.values(model.roles ?? {}).sort((a, b) => a.id.localeCompare(b.id));
+}
 function parsePath(pathString) {
   if (!pathString || typeof pathString !== "string") {
     throw new Error("parsePath: path must be a non-empty string");
@@ -48431,11 +48548,20 @@ function parsePath(pathString) {
     }
     return { mount: "graph", args: [graphNodeId, verb] };
   }
+  if (first === "all-systems" && rest.length === 0) {
+    return { mount: "all-systems", args: [] };
+  }
+  if (first === "all-resources" && rest.length === 0) {
+    return { mount: "all-resources", args: [] };
+  }
+  if (first === "all-roles" && rest.length === 0) {
+    return { mount: "all-roles", args: [] };
+  }
   if (segments.length === 1) {
     return { mount: "node", args: [first] };
   }
   throw new Error(
-    `parsePath: unrecognized path pattern "${pathString}". Supported: /by-system/<id>, /by-kind/<kind>, /by-owner/<id>, /graph/<nodeId>/governs, /graph/<nodeId>/governed-by, /<nodeId>`
+    `parsePath: unrecognized path pattern "${pathString}". Supported: /by-system/<id>, /by-kind/<kind>, /by-owner/<id>, /graph/<nodeId>/governs, /graph/<nodeId>/governed-by, /<nodeId>, /all-systems, /all-resources, /all-roles`
   );
 }
 function omSearch(model, query, options = {}) {
@@ -49099,9 +49225,37 @@ async function loadOrgModel(projectRoot) {
 }
 
 // src/cli/commands/knowledge/ls.ts
+function formatAllSystems(entries) {
+  if (entries.length === 0) return "(no results)";
+  const pathWidth = Math.max(...entries.map((e) => e.path.length), 4);
+  const header = `${"PATH".padEnd(pathWidth)}  LABEL`;
+  const divider = "-".repeat(header.length + 20);
+  const rows = entries.map((e) => {
+    const label = e.system.label ?? e.system.title ?? e.path;
+    return `${e.path.padEnd(pathWidth)}  ${label}`;
+  });
+  return [header, divider, ...rows].join("\n");
+}
+function formatAllResources(resources) {
+  if (resources.length === 0) return "(no results)";
+  const idWidth = Math.max(...resources.map((r) => r.id.length), 4);
+  const kindWidth = Math.max(...resources.map((r) => r.kind.length), 4);
+  const header = `${"ID".padEnd(idWidth)}  ${"KIND".padEnd(kindWidth)}  TITLE`;
+  const divider = "-".repeat(header.length + 20);
+  const rows = resources.map((r) => `${r.id.padEnd(idWidth)}  ${r.kind.padEnd(kindWidth)}  ${r.title}`);
+  return [header, divider, ...rows].join("\n");
+}
+function formatAllRoles(roles) {
+  if (roles.length === 0) return "(no results)";
+  const idWidth = Math.max(...roles.map((r) => r.id.length), 4);
+  const header = `${"ID".padEnd(idWidth)}  TITLE`;
+  const divider = "-".repeat(header.length + 20);
+  const rows = roles.map((r) => `${r.id.padEnd(idWidth)}  ${r.title}`);
+  return [header, divider, ...rows].join("\n");
+}
 function registerKnowledgeLs(program3) {
   program3.command("knowledge:ls <path>").alias("om:ls").description(
-    "List knowledge nodes for a Knowledge Map path\n  Examples:\n    elevasis-sdk om:ls /by-kind/playbook\n    elevasis-sdk om:ls /by-system/sales.crm\n    elevasis-sdk om:ls /by-ontology/sales.crm:object/deal\n    elevasis-sdk om:ls /by-owner/role.ops-lead\n    elevasis-sdk om:ls /graph/knowledge.outreach-playbook/governs\n    elevasis-sdk om:ls /graph/system:sales.crm/governed-by"
+    "List knowledge nodes for a Knowledge Map path\n  Examples:\n    elevasis-sdk om:ls /by-kind/playbook\n    elevasis-sdk om:ls /by-system/sales.crm\n    elevasis-sdk om:ls /by-ontology/sales.crm:object/deal\n    elevasis-sdk om:ls /by-owner/role.ops-lead\n    elevasis-sdk om:ls /graph/knowledge.outreach-playbook/governs\n    elevasis-sdk om:ls /graph/system:sales.crm/governed-by\n    elevasis-sdk om:ls /all-systems\n    elevasis-sdk om:ls /all-resources\n    elevasis-sdk om:ls /all-roles"
   ).option("--json", "Print wrapped JSON envelope { path, mount, args, results }").option("--ids-only", "Print one ID per line (for piping)").action(
     wrapAction("knowledge:ls", async (pathArg, options) => {
       let parsed;
@@ -49114,6 +49268,42 @@ function registerKnowledgeLs(program3) {
       }
       const projectRoot = getProjectRoot();
       const model = await loadOrgModel(projectRoot);
+      if (parsed.mount === "all-systems") {
+        const entries = listAllSystemsFlat(model);
+        if (options.json) {
+          process.stdout.write(formatJson({ path: pathArg, parsed, results: entries.map((e) => e.path) }) + "\n");
+        } else if (options.idsOnly) {
+          const out = entries.map((e) => e.path).join("\n");
+          if (out) process.stdout.write(out + "\n");
+        } else {
+          process.stdout.write(formatAllSystems(entries) + "\n");
+        }
+        return;
+      }
+      if (parsed.mount === "all-resources") {
+        const resources = listAllResources(model);
+        if (options.json) {
+          process.stdout.write(formatJson({ path: pathArg, parsed, results: resources.map((r) => r.id) }) + "\n");
+        } else if (options.idsOnly) {
+          const out = resources.map((r) => r.id).join("\n");
+          if (out) process.stdout.write(out + "\n");
+        } else {
+          process.stdout.write(formatAllResources(resources) + "\n");
+        }
+        return;
+      }
+      if (parsed.mount === "all-roles") {
+        const roles = listAllRoles(model);
+        if (options.json) {
+          process.stdout.write(formatJson({ path: pathArg, parsed, results: roles.map((r) => r.id) }) + "\n");
+        } else if (options.idsOnly) {
+          const out = roles.map((r) => r.id).join("\n");
+          if (out) process.stdout.write(out + "\n");
+        } else {
+          process.stdout.write(formatAllRoles(roles) + "\n");
+        }
+        return;
+      }
       const graph = buildOrganizationGraph({ organizationModel: model });
       const knowledgeNodes = Object.values(model.knowledge);
       let results;
@@ -50649,13 +50839,14 @@ function registerAcquisitionCommands(program3) {
 init_source();
 init_config();
 function registerClientCreate(program3) {
-  program3.command("client:create").description('Create a new client\n  Example: elevasis-sdk client:create --name "Acme Corp"').requiredOption("--name <name>", "Client name").option("--status <status>", "Client status: active | onboarding | paused | completed | churned").option("--source-deal-id <uuid>", "UUID of the source deal").option("--primary-company-id <uuid>", "UUID of the primary company").option("--primary-contact-id <uuid>", "UUID of the primary contact").option("--metadata <json>", "Arbitrary metadata (JSON string)").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  program3.command("client:create").description('Create a new client\n  Example: elevasis-sdk client:create --name "Acme Corp"').requiredOption("--name <name>", "Client name").option("--status <status>", "Client status: active | onboarding | paused | completed | churned").option("--source <source>", "Client source (for example: acquisition | word_of_mouth)").option("--source-deal-id <uuid>", "UUID of the source deal").option("--primary-company-id <uuid>", "UUID of the primary company").option("--primary-contact-id <uuid>", "UUID of the primary contact").option("--metadata <json>", "Arbitrary metadata (JSON string)").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
     wrapAction(
       "client:create",
       async (options) => {
         const apiUrl = resolveApiUrl(options.apiUrl);
         const body = { name: options.name };
         if (options.status !== void 0) body.status = options.status;
+        if (options.source !== void 0) body.source = options.source;
         if (options.sourceDealId !== void 0) body.sourceDealId = options.sourceDealId;
         if (options.primaryCompanyId !== void 0) body.primaryCompanyId = options.primaryCompanyId;
         if (options.primaryContactId !== void 0) body.primaryContactId = options.primaryContactId;
@@ -50675,7 +50866,7 @@ Client created: ${result.name}`));
   );
 }
 function registerClientUpdate(program3) {
-  program3.command("client:update <id>").description("Update a client\n  Example: elevasis-sdk client:update <uuid> --status active").option("--name <name>", "New client name").option("--status <status>", "New status: active | onboarding | paused | completed | churned").option("--source-deal-id <uuid>", "Set source deal (UUID)").option("--clear-source-deal", "Remove the source deal link (sets sourceDealId to null)").option("--primary-company-id <uuid>", "Set primary company (UUID)").option("--clear-primary-company", "Remove the primary company link (sets primaryCompanyId to null)").option("--primary-contact-id <uuid>", "Set primary contact (UUID)").option("--clear-primary-contact", "Remove the primary contact link (sets primaryContactId to null)").option("--metadata <json>", "Arbitrary metadata (JSON string)").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  program3.command("client:update <id>").description("Update a client\n  Example: elevasis-sdk client:update <uuid> --status active").option("--name <name>", "New client name").option("--status <status>", "New status: active | onboarding | paused | completed | churned").option("--source <source>", "Set client source (for example: acquisition | word_of_mouth)").option("--source-deal-id <uuid>", "Set source deal (UUID)").option("--clear-source-deal", "Remove the source deal link (sets sourceDealId to null)").option("--primary-company-id <uuid>", "Set primary company (UUID)").option("--clear-primary-company", "Remove the primary company link (sets primaryCompanyId to null)").option("--primary-contact-id <uuid>", "Set primary contact (UUID)").option("--clear-primary-contact", "Remove the primary contact link (sets primaryContactId to null)").option("--metadata <json>", "Arbitrary metadata (JSON string)").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
     wrapAction(
       "client:update",
       async (id, options) => {
@@ -50710,6 +50901,7 @@ function registerClientUpdate(program3) {
         const body = {};
         if (options.name !== void 0) body.name = options.name;
         if (options.status !== void 0) body.status = options.status;
+        if (options.source !== void 0) body.source = options.source;
         if (options.clearSourceDeal) {
           body.sourceDealId = null;
         } else if (options.sourceDealId !== void 0) {
@@ -50729,7 +50921,7 @@ function registerClientUpdate(program3) {
         if (Object.keys(body).length === 0) {
           process.stderr.write(
             JSON.stringify({
-              error: "At least one field must be provided (--name, --status, --source-deal-id, --clear-source-deal, --primary-company-id, --clear-primary-company, --primary-contact-id, --clear-primary-contact, --metadata)",
+              error: "At least one field must be provided (--name, --status, --source, --source-deal-id, --clear-source-deal, --primary-company-id, --clear-primary-company, --primary-contact-id, --clear-primary-contact, --metadata)",
               code: "MISSING_FIELDS"
             }) + "\n"
           );