@elevasis/sdk 1.31.0 → 1.33.0

package/dist/cli.cjs

@@ -5765,7 +5765,7 @@ var require_buffer_list = __commonJS({
         }
       }, {
         key: "join",
-        value: function join13(s) {
+        value: function join15(s) {
           if (this.length === 0) return "";
           var p = this.head;
           var ret = "" + p.data;
@@ -23628,20 +23628,20 @@ var init_config = __esm({
 
 // src/cli/commands/om/project-layout.ts
 function assertSplitLayout(projectDir) {
-  const omDir = (0, import_node_path7.join)(projectDir, "core", "config", "organization-model");
-  const missing = REQUIRED_FILES.filter((f) => !(0, import_node_fs7.existsSync)((0, import_node_path7.join)(omDir, f)));
+  const omDir = (0, import_node_path9.join)(projectDir, "core", "config", "organization-model");
+  const missing = REQUIRED_FILES.filter((f) => !(0, import_node_fs8.existsSync)((0, import_node_path9.join)(omDir, f)));
   if (missing.length > 0) {
     throw new Error(
       "Legacy single-file OM layout detected. Split into `core/config/organization-model/{profile.ts, systems.ts, navigation.ts}` before scaffolding."
     );
   }
 }
-var import_node_fs7, import_node_path7, REQUIRED_FILES;
+var import_node_fs8, import_node_path9, REQUIRED_FILES;
 var init_project_layout = __esm({
   "src/cli/commands/om/project-layout.ts"() {
     "use strict";
-    import_node_fs7 = require("node:fs");
-    import_node_path7 = require("node:path");
+    import_node_fs8 = require("node:fs");
+    import_node_path9 = require("node:path");
     REQUIRED_FILES = ["profile.ts", "systems.ts", "navigation.ts"];
   }
 });
@@ -23742,7 +23742,7 @@ async function withSnapshotRollback(filePaths, op) {
   const snapshots = /* @__PURE__ */ new Map();
   for (const filePath of filePaths) {
     try {
-      snapshots.set(filePath, (0, import_node_fs8.readFileSync)(filePath, "utf8"));
+      snapshots.set(filePath, (0, import_node_fs9.readFileSync)(filePath, "utf8"));
     } catch {
       snapshots.set(filePath, null);
     }
@@ -23753,7 +23753,7 @@ async function withSnapshotRollback(filePaths, op) {
     for (const [filePath, snapshot] of snapshots) {
       if (snapshot !== null) {
         try {
-          (0, import_node_fs8.writeFileSync)(filePath, snapshot, "utf8");
+          (0, import_node_fs9.writeFileSync)(filePath, snapshot, "utf8");
         } catch {
         }
       }
@@ -23774,14 +23774,14 @@ function insertBeforeAnchorInContent(content, code, anchor) {
   return lines.join("\n");
 }
 async function appendBeforeAnchor(filePath, code, anchor) {
-  const content = (0, import_node_fs8.readFileSync)(filePath, "utf8");
+  const content = (0, import_node_fs9.readFileSync)(filePath, "utf8");
   const updated = insertBeforeAnchorInContent(content, code, anchor);
-  (0, import_node_fs8.writeFileSync)(filePath, updated, "utf8");
+  (0, import_node_fs9.writeFileSync)(filePath, updated, "utf8");
 }
 async function applyConstImport(systemsFilePath, importLine, fieldLine, importAnchor, fieldAnchor, newConstFilePath, newConstFileCode) {
-  (0, import_node_fs8.mkdirSync)((0, import_node_path8.dirname)(newConstFilePath), { recursive: true });
-  (0, import_node_fs8.writeFileSync)(newConstFilePath, newConstFileCode, "utf8");
-  const systemsContent = (0, import_node_fs8.readFileSync)(systemsFilePath, "utf8");
+  (0, import_node_fs9.mkdirSync)((0, import_node_path10.dirname)(newConstFilePath), { recursive: true });
+  (0, import_node_fs9.writeFileSync)(newConstFilePath, newConstFileCode, "utf8");
+  const systemsContent = (0, import_node_fs9.readFileSync)(systemsFilePath, "utf8");
   const afterImport = insertBeforeAnchorInContent(systemsContent, importLine + "\n", importAnchor);
   const lines = afterImport.split("\n");
   const fieldAnchorIndex = lines.findIndex((line) => fieldAnchor.test(line));
@@ -23791,14 +23791,14 @@ async function applyConstImport(systemsFilePath, importLine, fieldLine, importAn
     );
   }
   lines.splice(fieldAnchorIndex + 1, 0, fieldLine);
-  (0, import_node_fs8.writeFileSync)(systemsFilePath, lines.join("\n"), "utf8");
+  (0, import_node_fs9.writeFileSync)(systemsFilePath, lines.join("\n"), "utf8");
 }
-var import_node_fs8, import_node_path8;
+var import_node_fs9, import_node_path10;
 var init_splice = __esm({
   "src/cli/commands/om/splice.ts"() {
     "use strict";
-    import_node_fs8 = require("node:fs");
-    import_node_path8 = require("node:path");
+    import_node_fs9 = require("node:fs");
+    import_node_path10 = require("node:path");
   }
 });
 
@@ -23861,7 +23861,7 @@ async function scaffoldSystem(opts) {
     }
     return;
   }
-  const systemsFilePath = (0, import_node_path9.join)(projectDir, "core", "config", "organization-model", "systems.ts");
+  const systemsFilePath = (0, import_node_path11.join)(projectDir, "core", "config", "organization-model", "systems.ts");
   try {
     await withSnapshotRollback([systemsFilePath], async () => {
       await appendBeforeAnchor(systemsFilePath, code, anchor);
@@ -23882,11 +23882,11 @@ async function scaffoldSystem(opts) {
     );
   }
 }
-var import_node_path9, import_node_child_process2;
+var import_node_path11, import_node_child_process2;
 var init_scaffold_system = __esm({
   "src/cli/commands/om/scaffold-system.ts"() {
     "use strict";
-    import_node_path9 = require("node:path");
+    import_node_path11 = require("node:path");
     import_node_child_process2 = require("node:child_process");
     init_source();
     init_config();
@@ -23980,7 +23980,7 @@ async function scaffoldResource(opts) {
     console.log(code);
     return;
   }
-  const systemsFilePath = (0, import_node_path10.join)(projectDir, "core", "config", "organization-model", "systems.ts");
+  const systemsFilePath = (0, import_node_path12.join)(projectDir, "core", "config", "organization-model", "systems.ts");
   try {
     await withSnapshotRollback([systemsFilePath], async () => {
       await appendBeforeAnchor(systemsFilePath, code, anchor);
@@ -23998,11 +23998,11 @@ Resource \`${id}\` references system \`${systemPath}\` which is not in \`templat
   }
   console.log(source_default.green(`Resource \`${id}\` scaffolded in core/config/organization-model/systems.ts`));
 }
-var import_node_path10, import_node_child_process3;
+var import_node_path12, import_node_child_process3;
 var init_scaffold_resource = __esm({
   "src/cli/commands/om/scaffold-resource.ts"() {
     "use strict";
-    import_node_path10 = require("node:path");
+    import_node_path12 = require("node:path");
     import_node_child_process3 = require("node:child_process");
     init_source();
     init_config();
@@ -24073,7 +24073,7 @@ async function scaffoldRole(opts) {
     console.log(code);
     return;
   }
-  const profileFilePath = (0, import_node_path11.join)(projectDir, "core", "config", "organization-model", "profile.ts");
+  const profileFilePath = (0, import_node_path13.join)(projectDir, "core", "config", "organization-model", "profile.ts");
   try {
     await withSnapshotRollback([profileFilePath], async () => {
       await appendBeforeAnchor(profileFilePath, code, anchor);
@@ -24089,11 +24089,11 @@ async function scaffoldRole(opts) {
   }
   console.log(source_default.green(`Role \`${id}\` scaffolded in core/config/organization-model/profile.ts`));
 }
-var import_node_path11, import_node_child_process4;
+var import_node_path13, import_node_child_process4;
 var init_scaffold_role = __esm({
   "src/cli/commands/om/scaffold-role.ts"() {
     "use strict";
-    import_node_path11 = require("node:path");
+    import_node_path13 = require("node:path");
     import_node_child_process4 = require("node:child_process");
     init_source();
     init_config();
@@ -24168,25 +24168,25 @@ async function scaffoldKnowledge(opts) {
     console.log(source_default.yellow("Run `elevasis-sdk om:generate` to register this node."));
     return;
   }
-  const absoluteFilePath = (0, import_node_path12.join)(projectDir, relativeFilePath);
-  if ((0, import_node_fs9.existsSync)(absoluteFilePath)) {
+  const absoluteFilePath = (0, import_node_path14.join)(projectDir, relativeFilePath);
+  if ((0, import_node_fs10.existsSync)(absoluteFilePath)) {
     process.stderr.write(
       source_default.red(`Knowledge node file already exists at \`${relativeFilePath}\`. Choose a different id.
 `)
     );
     process.exit(1);
   }
-  (0, import_node_fs9.mkdirSync)((0, import_node_path12.join)(projectDir, "core", "config", "knowledge", "nodes"), { recursive: true });
-  (0, import_node_fs9.writeFileSync)(absoluteFilePath, content, "utf8");
+  (0, import_node_fs10.mkdirSync)((0, import_node_path14.join)(projectDir, "core", "config", "knowledge", "nodes"), { recursive: true });
+  (0, import_node_fs10.writeFileSync)(absoluteFilePath, content, "utf8");
   console.log(source_default.green(`Knowledge node \`${id}\` written to \`${relativeFilePath}\``));
   console.log(source_default.yellow("Run `elevasis-sdk om:generate` to register this node."));
 }
-var import_node_path12, import_node_fs9, VALID_KINDS;
+var import_node_path14, import_node_fs10, VALID_KINDS;
 var init_scaffold_knowledge = __esm({
   "src/cli/commands/om/scaffold-knowledge.ts"() {
     "use strict";
-    import_node_path12 = require("node:path");
-    import_node_fs9 = require("node:fs");
+    import_node_path14 = require("node:path");
+    import_node_fs10 = require("node:fs");
     init_source();
     init_config();
     init_project_layout();
@@ -24240,7 +24240,7 @@ __export(scaffold_fill_exports, {
   default: () => scaffoldFill
 });
 function conformanceGapTempPath(orgName) {
-  return (0, import_node_path13.join)(os2.tmpdir(), `elevasis-conformance-${orgName}-${Date.now()}.json`);
+  return (0, import_node_path15.join)(os2.tmpdir(), `elevasis-conformance-${orgName}-${Date.now()}.json`);
 }
 function runValidation4(projectDir) {
   for (const script of ["check-types", "check"]) {
@@ -24263,7 +24263,7 @@ async function scaffoldFill(opts) {
     process.stderr.write(source_default.red("Missing gaps file. Pass --gaps <path> pointing to a conformance gap JSON file.\n"));
     process.exit(1);
   }
-  if (!(0, import_node_fs10.existsSync)(options.gaps)) {
+  if (!(0, import_node_fs11.existsSync)(options.gaps)) {
     process.stderr.write(
       source_default.red(
         `Missing gaps file. Pass --gaps <path> pointing to a conformance gap JSON file.
@@ -24275,7 +24275,7 @@ async function scaffoldFill(opts) {
   }
   let payload;
   try {
-    const raw = (0, import_node_fs10.readFileSync)(options.gaps, "utf8");
+    const raw = (0, import_node_fs11.readFileSync)(options.gaps, "utf8");
     payload = JSON.parse(raw);
   } catch {
     process.stderr.write(
@@ -24300,7 +24300,7 @@ async function scaffoldFill(opts) {
   const systemPath = payload.systemPath;
   const skippedGaps = [];
   const appliedGaps = [];
-  const systemsFilePath = (0, import_node_path13.join)(projectDir, "core", "config", "organization-model", "systems.ts");
+  const systemsFilePath = (0, import_node_path15.join)(projectDir, "core", "config", "organization-model", "systems.ts");
   const touchedFiles = [systemsFilePath];
   const emitResults = [];
   for (const gap of payload.gaps) {
@@ -24317,7 +24317,7 @@ async function scaffoldFill(opts) {
         resourceIds,
         message: gap.reason
       });
-      const constFilePath = (0, import_node_path13.join)(
+      const constFilePath = (0, import_node_path15.join)(
         projectDir,
         "core",
         "config",
@@ -24365,7 +24365,7 @@ async function scaffoldFill(opts) {
       await withSnapshotRollback(touchedFiles, async () => {
         for (let i = 0; i < emitResults.length; i++) {
           const result = emitResults[i];
-          const constFilePath = (0, import_node_path13.join)(
+          const constFilePath = (0, import_node_path15.join)(
             projectDir,
             "core",
             "config",
@@ -24395,8 +24395,8 @@ async function scaffoldFill(opts) {
     }
   }
   if (skippedGaps.length > 0) {
-    const skippedPath = options.skipped ?? (0, import_node_path13.join)(os2.tmpdir(), `elevasis-fill-skipped-${systemPath}-${Date.now()}.json`);
-    (0, import_node_fs10.writeFileSync)(skippedPath, JSON.stringify({ systemPath, skipped: skippedGaps }, null, 2), "utf8");
+    const skippedPath = options.skipped ?? (0, import_node_path15.join)(os2.tmpdir(), `elevasis-fill-skipped-${systemPath}-${Date.now()}.json`);
+    (0, import_node_fs11.writeFileSync)(skippedPath, JSON.stringify({ systemPath, skipped: skippedGaps }, null, 2), "utf8");
     console.log(
       source_default.yellow(
         `Partial fill: ${appliedGaps.length} gap(s) applied, ${skippedGaps.length} skipped \u2014 see \`${skippedPath}\` for fields requiring manual input.`
@@ -24410,13 +24410,13 @@ async function scaffoldFill(opts) {
     )
   );
 }
-var import_node_path13, os2, import_node_fs10, import_node_child_process5;
+var import_node_path15, os2, import_node_fs11, import_node_child_process5;
 var init_scaffold_fill = __esm({
   "src/cli/commands/om/scaffold-fill.ts"() {
     "use strict";
-    import_node_path13 = require("node:path");
+    import_node_path15 = require("node:path");
     os2 = __toESM(require("node:os"), 1);
-    import_node_fs10 = require("node:fs");
+    import_node_fs11 = require("node:fs");
     import_node_child_process5 = require("node:child_process");
     init_source();
     init_config();
@@ -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,
@@ -39787,6 +39852,7 @@ var OrganizationModelSchemaBase = external_exports.object({
   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),
@@ -39819,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,
@@ -39985,6 +40052,7 @@ function getAllProjectStatuses(model, appliesTo) {
 var OrganizationGraphNodeKindSchema = external_exports.enum([
   "organization",
   "system",
+  "client",
   "role",
   "action",
   "entity",
@@ -40230,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);
@@ -45632,7 +45716,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.31.0",
+  version: "1.33.0",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {
@@ -45672,7 +45756,7 @@ var package_default = {
   ],
   scripts: {
     lint: "eslint src --max-warnings 0",
-    build: `node -e "require('fs').rmSync('dist',{recursive:true,force:true})" && tsc -p tsconfig.core-dts.json && tsc -p tsconfig.build.json && tsup && rollup -c rollup.dts.config.mjs && esbuild src/cli/index.ts --bundle --platform=node --outfile=dist/cli.cjs --format=cjs --external:esbuild --banner:js="#!/usr/bin/env node" && node scripts/copy-reference-docs.mjs && node ../../scripts/monorepo/generate-reference-artifacts.js`,
+    build: `node -e "require('fs').rmSync('dist',{recursive:true,force:true})" && tsc -p tsconfig.core-dts.json && tsc -p tsconfig.build.json && tsup && rollup -c rollup.dts.config.mjs && esbuild src/cli/index.ts --bundle --platform=node --outfile=dist/cli.cjs --format=cjs --external:esbuild --banner:js="#!/usr/bin/env node" && node scripts/verify-skill-coverage.mjs && node scripts/copy-reference-docs.mjs && node ../../scripts/monorepo/generate-reference-artifacts.js`,
     "type-check": "tsc --noEmit",
     "check-types": "pnpm type-check",
     test: "pnpm build && node ../../scripts/monorepo/validate-reference-artifacts.js && vitest run --config vitest.bundle.config.ts",
@@ -46152,10 +46236,221 @@ import { startWorker } from '@elevasis/sdk/worker'
 
 // src/cli/commands/check.ts
 init_config();
+
+// src/cli/commands/skill/skill-check-coverage.ts
+var import_node_path2 = require("node:path");
+init_source();
+
+// src/cli/commands/cli/catalog.ts
+function buildCliCatalogFromProgram(program3, options = {}) {
+  const commands = program3.commands.flatMap((command) => collectRuntimeCommands(command));
+  return groupCommands(commands, "registered Commander commands", options.domain);
+}
+function groupCommands(commands, sourceRoot, domain2) {
+  const filtered = domain2 ? commands.filter((command) => command.domain === domain2) : commands;
+  const sorted = filtered.sort((a, b) => a.domain.localeCompare(b.domain) || a.syntax.localeCompare(b.syntax));
+  const domainNames = [...new Set(sorted.map((command) => command.domain))];
+  return {
+    sourceRoot,
+    domains: domainNames.map((name) => ({
+      name,
+      commands: sorted.filter((command) => command.domain === name)
+    }))
+  };
+}
+function collectRuntimeCommands(command, parent) {
+  const commandName = command.name();
+  const argSuffix = formatRuntimeArguments(command.registeredArguments);
+  const syntaxSegment = argSuffix ? `${commandName} ${argSuffix}` : commandName;
+  const syntax = parent ? `${parent.syntax} ${syntaxSegment}` : syntaxSegment;
+  const domain2 = parent?.domain ?? domainFromCommand(commandName);
+  const current = {
+    command: commandName,
+    syntax,
+    domain: domain2
+  };
+  const aliases = command.aliases().map((alias) => parent ? `${parent.syntax} ${alias}` : alias);
+  return [
+    {
+      syntax,
+      command: commandName,
+      domain: domain2,
+      description: firstLine(command.description()),
+      aliases,
+      options: command.options.map((option) => ({
+        flags: option.flags,
+        description: option.description,
+        required: option.mandatory
+      })),
+      source: "runtime"
+    },
+    ...command.commands.flatMap((child) => collectRuntimeCommands(child, current))
+  ];
+}
+function formatRuntimeArguments(args) {
+  return args.map((arg) => {
+    const name = `${arg.name()}${arg.variadic ? "..." : ""}`;
+    return arg.required ? `<${name}>` : `[${name}]`;
+  }).join(" ");
+}
+function renderCliCatalogMarkdown(catalog) {
+  const lines = [
+    "# elevasis-sdk CLI Catalog",
+    "",
+    `Source: \`${catalog.sourceRoot}\``,
+    ""
+  ];
+  if (catalog.domains.length === 0) {
+    lines.push("No commands found.");
+    return lines.join("\n");
+  }
+  for (const domain2 of catalog.domains) {
+    lines.push(`## ${domain2.name}`, "");
+    lines.push("| Command | Description | Aliases | Options | Source |");
+    lines.push("| --- | --- | --- | --- | --- |");
+    for (const command of domain2.commands) {
+      const aliases = command.aliases.length > 0 ? command.aliases.map((alias) => `\`${alias}\``).join(", ") : "-";
+      const options = command.options.length > 0 ? command.options.map((option) => `${option.required ? "required " : ""}\`${option.flags}\``).join("<br>") : "-";
+      lines.push(
+        `| \`elevasis-sdk ${command.syntax}\` | ${escapeMarkdownTable(command.description || "-")} | ${aliases} | ${options} | \`${command.source}\` |`
+      );
+    }
+    lines.push("");
+  }
+  return lines.join("\n").trimEnd();
+}
+function renderCliCatalogJson(catalog) {
+  return JSON.stringify(catalog, null, 2);
+}
+function domainFromCommand(command) {
+  if (command.includes(":")) return command.split(":")[0];
+  return "platform";
+}
+function firstLine(value) {
+  return value.split("\n")[0]?.trim() ?? "";
+}
+function escapeMarkdownTable(value) {
+  return value.replace(/\|/g, "\\|").replace(/\r?\n/g, "<br>");
+}
+function knownDomains(catalog) {
+  return catalog.domains.map((domain2) => domain2.name);
+}
+
+// src/cli/commands/skill/skill-coverage.ts
+var import_node_fs = require("node:fs");
+var import_node_path = require("node:path");
+function loadSkillCoverage(projectRoot) {
+  const coveragePath = (0, import_node_path.join)(projectRoot, ".claude", "registries", "skill-coverage.json");
+  if (!(0, import_node_fs.existsSync)(coveragePath)) return null;
+  const raw = (0, import_node_fs.readFileSync)(coveragePath, "utf8");
+  return JSON.parse(raw);
+}
+function runCoverageGate(knownDomains2, coverage, presentSkills, coverageFilePath) {
+  const violations = [];
+  const domainSet = new Set(knownDomains2);
+  const ownedDomains = /* @__PURE__ */ new Set();
+  for (const entry of Object.values(coverage.skills)) {
+    for (const domain2 of entry.domains) {
+      ownedDomains.add(domain2);
+    }
+  }
+  const waivedDomains = new Set(Object.keys(coverage.waived));
+  for (const domain2 of knownDomains2) {
+    if (!ownedDomains.has(domain2) && !waivedDomains.has(domain2)) {
+      violations.push({
+        kind: "uncovered",
+        domain: domain2,
+        detail: `Domain "${domain2}" exists in the CLI but is neither skill-owned nor waived in ${coverageFilePath}. Add it to "skills" or "waived".`
+      });
+    }
+  }
+  for (const [skillName, entry] of Object.entries(coverage.skills)) {
+    for (const domain2 of entry.domains) {
+      if (!domainSet.has(domain2)) {
+        violations.push({
+          kind: "stale-owned",
+          domain: domain2,
+          detail: `Domain "${domain2}" is declared as owned by skill "${skillName}" in ${coverageFilePath} but no longer exists in the CLI catalog. Remove or update the entry.`
+        });
+      }
+    }
+  }
+  for (const domain2 of waivedDomains) {
+    if (!domainSet.has(domain2)) {
+      violations.push({
+        kind: "stale-waived",
+        domain: domain2,
+        detail: `Domain "${domain2}" is declared as waived in ${coverageFilePath} but no longer exists in the CLI catalog. Remove the waiver.`
+      });
+    }
+  }
+  return {
+    violations,
+    domainsChecked: knownDomains2,
+    coverageFile: coverageFilePath
+  };
+}
+
+// src/cli/commands/skill/skill-check-coverage.ts
+init_config();
+async function runSkillCoverageCheck(program3, options = {}) {
+  const projectRoot = tryFindProjectRoot(process.cwd());
+  if (projectRoot === null) {
+    return { passed: true, violationCount: 0 };
+  }
+  const coveragePath = (0, import_node_path2.join)(projectRoot, ".claude", "registries", "skill-coverage.json");
+  const coverage = loadSkillCoverage(projectRoot);
+  if (coverage === null) {
+    if (!options.silent) {
+      console.log(
+        source_default.yellow("  warn  skill-coverage.json not found \u2014 skipping coverage gate") + source_default.gray(`
+  Expected: ${coveragePath}`)
+      );
+    }
+    return { passed: true, violationCount: 0 };
+  }
+  const catalog = buildCliCatalogFromProgram(program3);
+  const domains = knownDomains(catalog);
+  const result = runCoverageGate(domains, coverage, /* @__PURE__ */ new Set(), coveragePath);
+  if (result.violations.length === 0) {
+    if (!options.silent) {
+      console.log(
+        source_default.green("  Skill coverage OK") + source_default.gray(` (${domains.length} domains checked, all covered or waived)`)
+      );
+    }
+    return { passed: true, violationCount: 0 };
+  }
+  for (const violation of result.violations) {
+    const prefix = violation.kind === "uncovered" ? source_default.red("  ERROR  coverage") : source_default.yellow("  WARN   coverage");
+    console.error(`${prefix}  ${violation.detail}`);
+  }
+  return { passed: false, violationCount: result.violations.length };
+}
+function registerSkillCheckCoverageCommand(program3) {
+  program3.command("skill:check-coverage").description(
+    "Verify CLI domains are covered by skills or waived in skill-coverage.json\n  Example: elevasis-sdk skill:check-coverage"
+  ).action(
+    wrapAction("skill:check-coverage", async () => {
+      const catalog = buildCliCatalogFromProgram(program3);
+      const domains = knownDomains(catalog);
+      console.log(source_default.cyan(`Checking skill coverage for ${domains.length} CLI domains...`));
+      const { passed, violationCount } = await runSkillCoverageCheck(program3);
+      if (!passed) {
+        console.error("");
+        console.error(
+          source_default.red(`Skill coverage check failed: ${violationCount} violation(s).`) + "\n" + source_default.gray('  Update .claude/registries/skill-coverage.json to add the domain to "skills" or "waived".')
+        );
+        process.exitCode = 1;
+      }
+    })
+  );
+}
+
+// src/cli/commands/check.ts
 function registerCheckCommand(program3) {
   program3.command("check").description(
     "Validate project resources against the ResourceRegistry\n  Example: elevasis-sdk check --entry ./src/index.ts"
-  ).option("--entry <path>", "Path to entry file (default: ./src/index.ts)").action(
+  ).option("--entry <path>", "Path to entry file (default: ./src/index.ts)").option("--skip-coverage", "Skip the skill coverage gate").action(
     wrapAction("check", async (options) => {
       const entryPath = options.entry ?? "./src/index.ts";
       const spinner = ora("Validating resources...").start();
@@ -46206,6 +46501,20 @@ function registerCheckCommand(program3) {
           }
           console.log(source_default.gray("  Schemas will be unavailable on the platform for these resources."));
         }
+        if (!options.skipCoverage) {
+          console.log("");
+          const coverageResult = await runSkillCoverageCheck(program3);
+          if (!coverageResult.passed) {
+            console.error("");
+            console.error(
+              source_default.red(`Skill coverage check failed: ${coverageResult.violationCount} violation(s).`) + "\n" + source_default.gray(
+                '  Update .claude/registries/skill-coverage.json to add the domain to "skills" or "waived".\n  Run with --skip-coverage to suppress this check.'
+              )
+            );
+            process.exitCode = 1;
+            return;
+          }
+        }
       } catch (error46) {
         if (error46 instanceof RegistryValidationError) {
           spinner.fail(source_default.red("Validation failed"));
@@ -46227,8 +46536,8 @@ function registerCheckCommand(program3) {
 }
 
 // src/cli/commands/exec.ts
-var import_node_fs = require("node:fs");
-var import_node_path = require("node:path");
+var import_node_fs2 = require("node:fs");
+var import_node_path3 = require("node:path");
 init_source();
 init_config();
 var POLL_INTERVAL_MS = 3e3;
@@ -46301,14 +46610,14 @@ function registerExecCommand(program3) {
       "exec",
       async (resourceId, options) => {
         const resolvedInputFile = options.inputFile ? resolveProjectRelative(options.inputFile) : void 0;
-        const input = resolvedInputFile ? JSON.parse((0, import_node_fs.readFileSync)(resolvedInputFile, "utf8")) : options.input ? JSON.parse(options.input) : {};
+        const input = resolvedInputFile ? JSON.parse((0, import_node_fs2.readFileSync)(resolvedInputFile, "utf8")) : options.input ? JSON.parse(options.input) : {};
         const apiUrl = resolveApiUrl(options.apiUrl);
         const maybeCleanupInput = () => {
           if (!options.cleanupInput || !resolvedInputFile) return;
-          const tmpDir = (0, import_node_path.join)(getProjectRoot(), "tmp");
+          const tmpDir = (0, import_node_path3.join)(getProjectRoot(), "tmp");
           if (resolvedInputFile.startsWith(tmpDir + "/") || resolvedInputFile.startsWith(tmpDir + "\\")) {
             try {
-              (0, import_node_fs.unlinkSync)(resolvedInputFile);
+              (0, import_node_fs2.unlinkSync)(resolvedInputFile);
             } catch {
             }
           } else {
@@ -48973,11 +49282,11 @@ function bullet(items) {
 function field(label, value) {
   return value === void 0 || value === null || value === "" ? "" : `${label}: ${value}`;
 }
-function join3(parts) {
+function join5(parts) {
   return parts.filter((p) => p.length > 0).join("\n\n");
 }
 function formatSystemDescribe(r) {
-  const header = join3([
+  const header = join5([
     `System: ${r.id}`,
     [
       field("Label", r.label),
@@ -49006,10 +49315,10 @@ ${resourceLines.join("\n")}`;
   const ontologyEntries = Object.entries(r.ontologyCountsByKind);
   const ontologySection = ontologyEntries.length ? `Ontology: ${ontologyEntries.map(([k, n]) => `${k}s: ${n}`).join(", ")}` : "";
   const childSection = section("Subsystems", bullet(r.childSystemPaths));
-  return join3([header, govSection, resourceSection, ontologySection, childSection]);
+  return join5([header, govSection, resourceSection, ontologySection, childSection]);
 }
 function formatResourceDescribe(r) {
-  const header = join3([
+  const header = join5([
     `Resource: ${r.id}`,
     [
       field("Kind", r.resourceKind),
@@ -49033,10 +49342,10 @@ function formatResourceDescribe(r) {
 ${ontologyLines.join("\n")}` : "";
   const codeRefsSection = r.codeRefPaths.length ? `Code refs:
 ${bullet(r.codeRefPaths)}` : "";
-  return join3([header, ontologySection, codeRefsSection]);
+  return join5([header, ontologySection, codeRefsSection]);
 }
 function formatKnowledgeDescribe(r) {
-  const header = join3([
+  const header = join5([
     `Knowledge: ${r.id}`,
     [field("Kind", r.knowledgeKind), field("Title", r.title), field("Updated", r.updatedAt)].filter((s) => s.length > 0).join("\n"),
     r.summary ? `Summary: ${r.summary}` : ""
@@ -49046,28 +49355,28 @@ ${bullet(r.ownerIds)}` : "";
   const govSection = section("Governs", bullet(r.governs));
   const bodySection = `Body excerpt (${r.bodyLineCount} lines total \u2014 use knowledge:cat for full):
 ${r.bodyExcerpt}`;
-  return join3([header, ownerSection, govSection, bodySection]);
+  return join5([header, ownerSection, govSection, bodySection]);
 }
 function formatOntologyDescribe(r) {
-  const header = join3([
+  const header = join5([
     `Ontology: ${r.id}`,
     [field("Kind", r.ontologyKind), field("Scope", r.scope), field("Local id", r.localId), field("Label", r.label)].filter((s) => s.length > 0).join("\n"),
     r.description ? `Description: ${r.description}` : ""
   ]);
   const govSection = section("Governed by knowledge", bullet(r.governingKnowledgeIds));
-  return join3([header, govSection]);
+  return join5([header, govSection]);
 }
 function formatRoleDescribe(r) {
-  const header = join3([
+  const header = join5([
     `Role: ${r.id}`,
     [field("Title", r.title), field("Reports to", r.reportsToId)].filter((s) => s.length > 0).join("\n")
   ]);
   const respSection = section("Responsibilities", bullet(r.responsibilities));
   const responsibleForSection = section("Responsible for systems", bullet(r.responsibleFor));
-  return join3([header, respSection, responsibleForSection]);
+  return join5([header, respSection, responsibleForSection]);
 }
 function formatPolicyDescribe(r) {
-  const header = join3([
+  const header = join5([
     `Policy: ${r.id}`,
     [field("Label", r.label), field("Trigger", r.triggerKind)].filter((s) => s.length > 0).join("\n"),
     r.description ? `Description: ${r.description}` : ""
@@ -49080,7 +49389,7 @@ function formatPolicyDescribe(r) {
   if (r.appliesToRoleIds.length) appliesLines.push(`  roles: ${r.appliesToRoleIds.join(", ")}`);
   const appliesSection = appliesLines.length ? `Applies to:
 ${appliesLines.join("\n")}` : "";
-  return join3([header, effectSection, appliesSection]);
+  return join5([header, effectSection, appliesSection]);
 }
 
 // src/cli/commands/knowledge/ls.ts
@@ -49480,12 +49789,12 @@ function registerKnowledgeSkills(program3) {
 }
 
 // src/cli/commands/knowledge/generate.ts
-var import_node_fs3 = require("node:fs");
-var import_node_path3 = require("node:path");
+var import_node_fs4 = require("node:fs");
+var import_node_path5 = require("node:path");
 
 // src/knowledge-codegen.ts
-var import_node_fs2 = require("node:fs");
-var import_node_path2 = require("node:path");
+var import_node_fs3 = require("node:fs");
+var import_node_path4 = require("node:path");
 function targetFromNodeId2(nodeId2) {
   const [kind, ...idParts] = nodeId2.split(":");
   return {
@@ -49503,10 +49812,10 @@ function canonicalizeKnowledgeNodeLinks(node) {
   };
 }
 function listMdxFiles(directory) {
-  return (0, import_node_fs2.readdirSync)(directory, { withFileTypes: true }).flatMap((entry) => {
-    const path3 = (0, import_node_path2.join)(directory, entry.name);
+  return (0, import_node_fs3.readdirSync)(directory, { withFileTypes: true }).flatMap((entry) => {
+    const path3 = (0, import_node_path4.join)(directory, entry.name);
     if (entry.isDirectory()) return listMdxFiles(path3);
-    return entry.isFile() && (0, import_node_path2.extname)(entry.name) === ".mdx" ? [path3] : [];
+    return entry.isFile() && (0, import_node_path4.extname)(entry.name) === ".mdx" ? [path3] : [];
   });
 }
 function parseScalar(value) {
@@ -49701,7 +50010,7 @@ function readCommandForNode(node, cliCommand = "elevasis") {
   ];
 }
 function readKnowledgeNodeMdx(filePath) {
-  const raw = (0, import_node_fs2.readFileSync)(filePath, "utf8");
+  const raw = (0, import_node_fs3.readFileSync)(filePath, "utf8");
   const { frontmatter, body } = parseFrontmatter(raw, filePath);
   return {
     id: assertString(frontmatter, "id", filePath),
@@ -49799,25 +50108,25 @@ function generateKnowledgeNodesTs(options) {
 }
 function generateKnowledgeNodes(options) {
   const files = listMdxFiles(options.sourceDir).sort(
-    (a, b) => (0, import_node_path2.relative)(options.sourceDir, a).localeCompare((0, import_node_path2.relative)(options.sourceDir, b))
+    (a, b) => (0, import_node_path4.relative)(options.sourceDir, a).localeCompare((0, import_node_path4.relative)(options.sourceDir, b))
   );
   const nodes = files.map((file2) => {
-    const relativePath = (0, import_node_path2.relative)(options.sourceDir, file2);
+    const relativePath = (0, import_node_path4.relative)(options.sourceDir, file2);
     return {
       ...readKnowledgeNodeMdx(file2),
       sourceFilePath: toSourceFilePath(options.sourceLabel, relativePath)
     };
   });
   const sourcePaths = Object.fromEntries(
-    files.map((file2, index) => [nodes[index].id, toRegistryPath((0, import_node_path2.relative)(options.sourceDir, file2))])
+    files.map((file2, index) => [nodes[index].id, toRegistryPath((0, import_node_path4.relative)(options.sourceDir, file2))])
   );
   const ids = /* @__PURE__ */ new Set();
   for (const node of nodes) {
     if (ids.has(node.id)) throw new Error(`[knowledge-node-codegen] Duplicate knowledge node id: ${node.id}`);
     ids.add(node.id);
   }
-  (0, import_node_fs2.mkdirSync)((0, import_node_path2.dirname)(options.outputPath), { recursive: true });
-  (0, import_node_fs2.writeFileSync)(
+  (0, import_node_fs3.mkdirSync)((0, import_node_path4.dirname)(options.outputPath), { recursive: true });
+  (0, import_node_fs3.writeFileSync)(
     options.outputPath,
     generateKnowledgeNodesTs({
       nodes,
@@ -49828,8 +50137,8 @@ function generateKnowledgeNodes(options) {
     "utf8"
   );
   if (options.knowledgeFlagsOutputPath) {
-    (0, import_node_fs2.mkdirSync)((0, import_node_path2.dirname)(options.knowledgeFlagsOutputPath), { recursive: true });
-    (0, import_node_fs2.writeFileSync)(
+    (0, import_node_fs3.mkdirSync)((0, import_node_path4.dirname)(options.knowledgeFlagsOutputPath), { recursive: true });
+    (0, import_node_fs3.writeFileSync)(
       options.knowledgeFlagsOutputPath,
       `${JSON.stringify(
         generateKnowledgeFlagRegistry(nodes, sourcePaths, {
@@ -49861,13 +50170,13 @@ function registerKnowledgeGenerate(program3) {
   ).action(
     wrapAction("knowledge:generate", async (options) => {
       const projectRoot = getProjectRoot();
-      const sourceDir = (0, import_node_path3.resolve)(projectRoot, options.source ?? "core/config/knowledge/nodes");
-      const outputPath = (0, import_node_path3.resolve)(projectRoot, options.output ?? "core/config/knowledge/_generated/nodes.ts");
-      const knowledgeFlagsOutputPath = (0, import_node_path3.resolve)(
+      const sourceDir = (0, import_node_path5.resolve)(projectRoot, options.source ?? "core/config/knowledge/nodes");
+      const outputPath = (0, import_node_path5.resolve)(projectRoot, options.output ?? "core/config/knowledge/_generated/nodes.ts");
+      const knowledgeFlagsOutputPath = (0, import_node_path5.resolve)(
         projectRoot,
         options.flagsOutput ?? ".claude/registries/knowledge-flags.json"
       );
-      if (!(0, import_node_fs3.existsSync)(sourceDir)) {
+      if (!(0, import_node_fs4.existsSync)(sourceDir)) {
         process.stderr.write(`knowledge:generate: source directory not found: ${sourceDir}
 `);
         process.exitCode = 1;
@@ -49979,8 +50288,8 @@ function registerKnowledgeCommands(program3) {
 }
 
 // src/cli/commands/request/request.ts
-var import_node_fs4 = require("node:fs");
-var import_node_path4 = require("node:path");
+var import_node_fs5 = require("node:fs");
+var import_node_path6 = require("node:path");
 init_source();
 init_config();
 
@@ -50044,7 +50353,7 @@ function registerRequestCommands(program3) {
         throw new Error("Provide --input <json> or --input-file <path>");
       }
       const resolvedInputFile = options.inputFile ? resolveProjectRelative(options.inputFile) : void 0;
-      const raw = resolvedInputFile ? JSON.parse((0, import_node_fs4.readFileSync)(resolvedInputFile, "utf8")) : JSON.parse(options.input);
+      const raw = resolvedInputFile ? JSON.parse((0, import_node_fs5.readFileSync)(resolvedInputFile, "utf8")) : JSON.parse(options.input);
       const parsed = CreateRequestInputSchema.safeParse(raw);
       if (!parsed.success) {
         const issues = parsed.error.issues.map((i) => `  - ${i.path.join(".") || "(root)"}: ${i.message}`).join("\n");
@@ -50065,10 +50374,10 @@ ${issues}`);
         console.log(JSON.stringify(result, null, 2));
       }
       if (options.cleanupInput && resolvedInputFile) {
-        const tmpDir = (0, import_node_path4.join)(getProjectRoot(), "tmp");
+        const tmpDir = (0, import_node_path6.join)(getProjectRoot(), "tmp");
         if (resolvedInputFile.startsWith(tmpDir + "/") || resolvedInputFile.startsWith(tmpDir + "\\")) {
           try {
-            (0, import_node_fs4.unlinkSync)(resolvedInputFile);
+            (0, import_node_fs5.unlinkSync)(resolvedInputFile);
           } catch {
           }
         } else {
@@ -50137,8 +50446,8 @@ ${rows.length} request${rows.length === 1 ? "" : "s"}`));
 
 // src/cli/commands/ui/ui-switcher.ts
 var import_node_child_process = require("node:child_process");
-var import_node_fs5 = __toESM(require("node:fs"), 1);
-var import_node_path5 = __toESM(require("node:path"), 1);
+var import_node_fs6 = __toESM(require("node:fs"), 1);
+var import_node_path7 = __toESM(require("node:path"), 1);
 init_config();
 function run(command, args, cwd) {
   (0, import_node_child_process.execFileSync)(command, args, {
@@ -50148,10 +50457,10 @@ function run(command, args, cwd) {
   });
 }
 function readJson(filePath) {
-  return JSON.parse(import_node_fs5.default.readFileSync(filePath, "utf8"));
+  return JSON.parse(import_node_fs6.default.readFileSync(filePath, "utf8"));
 }
 function writeJson(filePath, value) {
-  import_node_fs5.default.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}
+  import_node_fs6.default.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}
 `);
 }
 function requireDependencies(packageJson, filePath) {
@@ -50161,8 +50470,8 @@ function requireDependencies(packageJson, filePath) {
   return packageJson.dependencies;
 }
 function resolveExistingDir(label, dir) {
-  const resolved = import_node_path5.default.resolve(dir);
-  if (!import_node_fs5.default.existsSync(resolved) || !import_node_fs5.default.statSync(resolved).isDirectory()) {
+  const resolved = import_node_path7.default.resolve(dir);
+  if (!import_node_fs6.default.existsSync(resolved) || !import_node_fs6.default.statSync(resolved).isDirectory()) {
     throw new Error(`${label} not found: ${resolved}`);
   }
   return resolved;
@@ -50170,8 +50479,8 @@ function resolveExistingDir(label, dir) {
 function findRepoRootFromProject(projectRoot) {
   let dir = projectRoot;
   while (true) {
-    if (import_node_fs5.default.existsSync(import_node_path5.default.join(dir, "packages", "ui", "package.json"))) return dir;
-    const parent = import_node_path5.default.dirname(dir);
+    if (import_node_fs6.default.existsSync(import_node_path7.default.join(dir, "packages", "ui", "package.json"))) return dir;
+    const parent = import_node_path7.default.dirname(dir);
     if (parent === dir) return null;
     dir = parent;
   }
@@ -50184,13 +50493,13 @@ function resolveUiPackageRoot(projectRoot, explicitRoot) {
       "Could not find packages/ui from this Elevasis project. Pass --ui-package-root <path> from a monorepo checkout."
     );
   }
-  return import_node_path5.default.join(repoRoot, "packages", "ui");
+  return import_node_path7.default.join(repoRoot, "packages", "ui");
 }
 function removeLocalUiTarballs(templateTmpDir) {
-  if (!import_node_fs5.default.existsSync(templateTmpDir)) return;
-  for (const entry of import_node_fs5.default.readdirSync(templateTmpDir)) {
+  if (!import_node_fs6.default.existsSync(templateTmpDir)) return;
+  for (const entry of import_node_fs6.default.readdirSync(templateTmpDir)) {
     if (entry.startsWith("elevasis-ui-") && entry.endsWith(".tgz")) {
-      import_node_fs5.default.rmSync(import_node_path5.default.join(templateTmpDir, entry), { force: true });
+      import_node_fs6.default.rmSync(import_node_path7.default.join(templateTmpDir, entry), { force: true });
     }
   }
 }
@@ -50210,29 +50519,29 @@ function useLocalUi(options = {}) {
   const projectRoot = getProjectRoot();
   const repoRoot = findRepoRootFromProject(projectRoot);
   const uiPackageRoot = resolveUiPackageRoot(projectRoot, options.uiPackageRoot);
-  const commandRoot = repoRoot ?? import_node_path5.default.dirname(import_node_path5.default.dirname(uiPackageRoot));
-  const templateUiPackageJsonPath = import_node_path5.default.join(projectRoot, "ui", "package.json");
-  const templateTmpDir = import_node_path5.default.join(projectRoot, "tmp");
-  const uiPackageJsonPath = import_node_path5.default.join(uiPackageRoot, "package.json");
-  const uiPackageBackupPath = import_node_path5.default.join(uiPackageRoot, "package.json.local-pack.bak");
-  if (!import_node_fs5.default.existsSync(templateUiPackageJsonPath)) {
+  const commandRoot = repoRoot ?? import_node_path7.default.dirname(import_node_path7.default.dirname(uiPackageRoot));
+  const templateUiPackageJsonPath = import_node_path7.default.join(projectRoot, "ui", "package.json");
+  const templateTmpDir = import_node_path7.default.join(projectRoot, "tmp");
+  const uiPackageJsonPath = import_node_path7.default.join(uiPackageRoot, "package.json");
+  const uiPackageBackupPath = import_node_path7.default.join(uiPackageRoot, "package.json.local-pack.bak");
+  if (!import_node_fs6.default.existsSync(templateUiPackageJsonPath)) {
     throw new Error(`Template UI package.json not found: ${templateUiPackageJsonPath}`);
   }
-  import_node_fs5.default.mkdirSync(templateTmpDir, { recursive: true });
+  import_node_fs6.default.mkdirSync(templateTmpDir, { recursive: true });
   removeLocalUiTarballs(templateTmpDir);
   run("pnpm", ["--filter", "@repo/ui", "build:publish"], commandRoot);
   try {
-    const raw = import_node_fs5.default.readFileSync(uiPackageJsonPath, "utf8");
-    import_node_fs5.default.writeFileSync(uiPackageBackupPath, raw);
+    const raw = import_node_fs6.default.readFileSync(uiPackageJsonPath, "utf8");
+    import_node_fs6.default.writeFileSync(uiPackageBackupPath, raw);
     writeJson(uiPackageJsonPath, prepareUiPackageForPack(JSON.parse(raw)));
     run("pnpm", ["-C", uiPackageRoot, "pack", "--pack-destination", templateTmpDir], commandRoot);
   } finally {
-    if (import_node_fs5.default.existsSync(uiPackageBackupPath)) {
-      import_node_fs5.default.copyFileSync(uiPackageBackupPath, uiPackageJsonPath);
-      import_node_fs5.default.rmSync(uiPackageBackupPath, { force: true });
+    if (import_node_fs6.default.existsSync(uiPackageBackupPath)) {
+      import_node_fs6.default.copyFileSync(uiPackageBackupPath, uiPackageJsonPath);
+      import_node_fs6.default.rmSync(uiPackageBackupPath, { force: true });
     }
   }
-  const tarballName = import_node_fs5.default.readdirSync(templateTmpDir).find((entry) => entry.startsWith("elevasis-ui-") && entry.endsWith(".tgz"));
+  const tarballName = import_node_fs6.default.readdirSync(templateTmpDir).find((entry) => entry.startsWith("elevasis-ui-") && entry.endsWith(".tgz"));
   if (!tarballName) {
     throw new Error(`Failed to create local @elevasis/ui tarball in ${templateTmpDir}`);
   }
@@ -50240,20 +50549,20 @@ function useLocalUi(options = {}) {
   requireDependencies(templateUiPackageJson, templateUiPackageJsonPath)["@elevasis/ui"] = `file:../tmp/${tarballName}`;
   writeJson(templateUiPackageJsonPath, templateUiPackageJson);
   run("pnpm", ["-C", projectRoot, "install"], commandRoot);
-  console.log(`${import_node_path5.default.basename(projectRoot)}/ui now uses local @elevasis/ui tarball: ${tarballName}`);
+  console.log(`${import_node_path7.default.basename(projectRoot)}/ui now uses local @elevasis/ui tarball: ${tarballName}`);
 }
 function usePublishedUi(options = {}) {
   const projectRoot = getProjectRoot();
   const repoRoot = findRepoRootFromProject(projectRoot);
   const commandRoot = repoRoot ?? projectRoot;
-  const templateUiPackageJsonPath = import_node_path5.default.join(projectRoot, "ui", "package.json");
-  const templateTmpDir = import_node_path5.default.join(projectRoot, "tmp");
+  const templateUiPackageJsonPath = import_node_path7.default.join(projectRoot, "ui", "package.json");
+  const templateTmpDir = import_node_path7.default.join(projectRoot, "tmp");
   const uiPackageRoot = options.version ? void 0 : resolveUiPackageRoot(projectRoot, options.uiPackageRoot);
-  const uiVersion = options.version ?? readJson(import_node_path5.default.join(uiPackageRoot, "package.json")).version;
+  const uiVersion = options.version ?? readJson(import_node_path7.default.join(uiPackageRoot, "package.json")).version;
   if (!uiVersion) {
     throw new Error("Could not determine @elevasis/ui version. Pass --version <version>.");
   }
-  if (!import_node_fs5.default.existsSync(templateUiPackageJsonPath)) {
+  if (!import_node_fs6.default.existsSync(templateUiPackageJsonPath)) {
     throw new Error(`Template UI package.json not found: ${templateUiPackageJsonPath}`);
   }
   const templateUiPackageJson = readJson(templateUiPackageJsonPath);
@@ -50261,7 +50570,7 @@ function usePublishedUi(options = {}) {
   writeJson(templateUiPackageJsonPath, templateUiPackageJson);
   removeLocalUiTarballs(templateTmpDir);
   run("pnpm", ["-C", projectRoot, "install"], commandRoot);
-  console.log(`${import_node_path5.default.basename(projectRoot)}/ui restored to published @elevasis/ui ^${uiVersion}`);
+  console.log(`${import_node_path7.default.basename(projectRoot)}/ui restored to published @elevasis/ui ^${uiVersion}`);
 }
 
 // src/cli/commands/ui/ui.ts
@@ -50279,8 +50588,8 @@ function registerUiCommands(program3) {
 }
 
 // src/cli/commands/doctor.ts
-var import_node_fs6 = require("node:fs");
-var import_node_path6 = __toESM(require("node:path"), 1);
+var import_node_fs7 = require("node:fs");
+var import_node_path8 = __toESM(require("node:path"), 1);
 init_source();
 init_config();
 function ok(label, detail) {
@@ -50318,8 +50627,8 @@ function registerDoctorCommand(program3) {
       printSummary(failCount);
       process.exit(1);
     }
-    const envPath2 = import_node_path6.default.join(projectRoot, ".env");
-    const envExists = (0, import_node_fs6.existsSync)(envPath2);
+    const envPath2 = import_node_path8.default.join(projectRoot, ".env");
+    const envExists = (0, import_node_fs7.existsSync)(envPath2);
     if (!envExists) {
       fail(".env", `Not found at ${envPath2}. Create it from .env.example and fill in ELEVASIS_PLATFORM_KEY.`);
       if (isVerbose) verbose(`Checked: ${envPath2}`);
@@ -50406,101 +50715,6 @@ function printSummary(failCount) {
   }
 }
 
-// src/cli/commands/cli/catalog.ts
-function buildCliCatalogFromProgram(program3, options = {}) {
-  const commands = program3.commands.flatMap((command) => collectRuntimeCommands(command));
-  return groupCommands(commands, "registered Commander commands", options.domain);
-}
-function groupCommands(commands, sourceRoot, domain2) {
-  const filtered = domain2 ? commands.filter((command) => command.domain === domain2) : commands;
-  const sorted = filtered.sort((a, b) => a.domain.localeCompare(b.domain) || a.syntax.localeCompare(b.syntax));
-  const domainNames = [...new Set(sorted.map((command) => command.domain))];
-  return {
-    sourceRoot,
-    domains: domainNames.map((name) => ({
-      name,
-      commands: sorted.filter((command) => command.domain === name)
-    }))
-  };
-}
-function collectRuntimeCommands(command, parent) {
-  const commandName = command.name();
-  const argSuffix = formatRuntimeArguments(command.registeredArguments);
-  const syntaxSegment = argSuffix ? `${commandName} ${argSuffix}` : commandName;
-  const syntax = parent ? `${parent.syntax} ${syntaxSegment}` : syntaxSegment;
-  const domain2 = parent?.domain ?? domainFromCommand(commandName);
-  const current = {
-    command: commandName,
-    syntax,
-    domain: domain2
-  };
-  const aliases = command.aliases().map((alias) => parent ? `${parent.syntax} ${alias}` : alias);
-  return [
-    {
-      syntax,
-      command: commandName,
-      domain: domain2,
-      description: firstLine(command.description()),
-      aliases,
-      options: command.options.map((option) => ({
-        flags: option.flags,
-        description: option.description,
-        required: option.mandatory
-      })),
-      source: "runtime"
-    },
-    ...command.commands.flatMap((child) => collectRuntimeCommands(child, current))
-  ];
-}
-function formatRuntimeArguments(args) {
-  return args.map((arg) => {
-    const name = `${arg.name()}${arg.variadic ? "..." : ""}`;
-    return arg.required ? `<${name}>` : `[${name}]`;
-  }).join(" ");
-}
-function renderCliCatalogMarkdown(catalog) {
-  const lines = [
-    "# elevasis-sdk CLI Catalog",
-    "",
-    `Source: \`${catalog.sourceRoot}\``,
-    ""
-  ];
-  if (catalog.domains.length === 0) {
-    lines.push("No commands found.");
-    return lines.join("\n");
-  }
-  for (const domain2 of catalog.domains) {
-    lines.push(`## ${domain2.name}`, "");
-    lines.push("| Command | Description | Aliases | Options | Source |");
-    lines.push("| --- | --- | --- | --- | --- |");
-    for (const command of domain2.commands) {
-      const aliases = command.aliases.length > 0 ? command.aliases.map((alias) => `\`${alias}\``).join(", ") : "-";
-      const options = command.options.length > 0 ? command.options.map((option) => `${option.required ? "required " : ""}\`${option.flags}\``).join("<br>") : "-";
-      lines.push(
-        `| \`elevasis-sdk ${command.syntax}\` | ${escapeMarkdownTable(command.description || "-")} | ${aliases} | ${options} | \`${command.source}\` |`
-      );
-    }
-    lines.push("");
-  }
-  return lines.join("\n").trimEnd();
-}
-function renderCliCatalogJson(catalog) {
-  return JSON.stringify(catalog, null, 2);
-}
-function domainFromCommand(command) {
-  if (command.includes(":")) return command.split(":")[0];
-  return "platform";
-}
-function firstLine(value) {
-  return value.split("\n")[0]?.trim() ?? "";
-}
-function escapeMarkdownTable(value) {
-  return value.replace(/\|/g, "\\|").replace(/\r?\n/g, "<br>");
-}
-function knownDomains(catalog) {
-  return catalog.domains.map((domain2) => domain2.name);
-}
-
 // src/cli/commands/cli/cli.ts
 var FORMATS = /* @__PURE__ */ new Set(["markdown", "json"]);
 function registerCliCatalogCommand(program3) {
@@ -50755,13 +50969,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;
@@ -50781,7 +50996,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) => {
@@ -50816,6 +51031,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) {
@@ -50835,7 +51051,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"
           );
@@ -51552,10 +51768,93 @@ function registerOmScaffoldCommands(program3) {
   });
 }
 
+// src/cli/commands/skill/skill-scaffold.ts
+init_source();
+function buildSkillMd(domain2) {
+  const name = domain2.name;
+  const commandNames = domain2.commands.map((c) => c.command.replace(`${name}:`, ""));
+  const argumentHint = `[${commandNames.join(" | ")}] [args]`;
+  const descriptionText = `${name} domain operations \u2014 ${commandNames.join(", ")} \u2014 via the elevasis-sdk ${name}:* CLI.`;
+  const lines = [
+    "---",
+    `name: ${name}`,
+    `description: "${descriptionText}"`,
+    `argument-hint: "${argumentHint}"`,
+    `allowed-tools: Bash, Read, Write, Edit, Glob, Grep`,
+    "---",
+    "",
+    `# ${name.charAt(0).toUpperCase() + name.slice(1)} Skill`,
+    "",
+    `> **Generated stub.** Curate the prose below: add vibe integration, confirm ceremony,`,
+    `> and any operation-level detail. The usage table is pre-filled from the CLI catalog.`,
+    "",
+    "## Usage",
+    "",
+    "| Command | Description | Options |",
+    "| --- | --- | --- |"
+  ];
+  for (const cmd of domain2.commands) {
+    const syntax = `\`elevasis-sdk ${cmd.syntax}\``;
+    const description = cmd.description || "-";
+    const options = cmd.options.length > 0 ? cmd.options.map((o) => `${o.required ? "required " : ""}\`${o.flags}\``).join(", ") : "-";
+    lines.push(`| ${syntax} | ${description} | ${options} |`);
+  }
+  lines.push("");
+  const commandsWithAliases = domain2.commands.filter((c) => c.aliases.length > 0);
+  if (commandsWithAliases.length > 0) {
+    lines.push("## Aliases", "");
+    for (const cmd of commandsWithAliases) {
+      for (const alias of cmd.aliases) {
+        lines.push(`- \`elevasis-sdk ${alias}\` \u2192 \`elevasis-sdk ${cmd.syntax}\``);
+      }
+    }
+    lines.push("");
+  }
+  lines.push(
+    "## Connection",
+    "",
+    "```bash",
+    "# .env (project root)",
+    "ELEVASIS_PLATFORM_KEY=sk_...",
+    "```",
+    "",
+    "```bash",
+    `pnpm elevasis-sdk ${name}:<command> [args]`,
+    "```",
+    ""
+  );
+  return lines.join("\n");
+}
+function registerSkillScaffoldCommand(program3) {
+  program3.command("skill:scaffold <domain>").description(
+    "Emit a SKILL.md stub for a CLI domain from the catalog\n  Example: elevasis-sdk skill:scaffold client"
+  ).option("--output", "Write the stub to stdout only (default behavior)").action(
+    wrapAction("skill:scaffold", async (domain2) => {
+      const catalog = buildCliCatalogFromProgram(program3, { domain: domain2 });
+      if (catalog.domains.length === 0) {
+        const fullCatalog = buildCliCatalogFromProgram(program3);
+        const known = knownDomains(fullCatalog);
+        throw new Error(`No CLI domain "${domain2}" found. Known domains: ${known.join(", ")}`);
+      }
+      const domainEntry = catalog.domains[0];
+      const stub = buildSkillMd(domainEntry);
+      console.log(
+        source_default.gray(
+          `# SKILL.md stub for domain "${domain2}" (${domainEntry.commands.length} commands)
+# Copy this to: external/_template/.claude/skills/${domain2}/SKILL.md
+# Then curate: add vibe integration, confirm ceremony, and operation prose.
+`
+        )
+      );
+      console.log(stub);
+    })
+  );
+}
+
 // src/cli/index.ts
 init_config();
 var PREFLIGHT_SKIP_FLAGS = /* @__PURE__ */ new Set(["--help", "-h", "--version", "-V"]);
-var PREFLIGHT_SKIP_COMMANDS = /* @__PURE__ */ new Set(["cli"]);
+var PREFLIGHT_SKIP_COMMANDS = /* @__PURE__ */ new Set(["cli", "skill:scaffold"]);
 var LOCAL_PROJECT_COMMANDS = /* @__PURE__ */ new Set([
   "ui:use-local",
   "ui:use-published",
@@ -51685,6 +51984,8 @@ registerUiCommands(program2);
 registerDoctorCommand(program2);
 registerCliCatalogCommand(program2);
 registerOmScaffoldCommands(program2);
+registerSkillScaffoldCommand(program2);
+registerSkillCheckCoverageCommand(program2);
 program2.parse();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {