@elevasis/sdk 1.32.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();
@@ -45716,7 +45716,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.32.0",
+  version: "1.33.0",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {
@@ -45756,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",
@@ -46236,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();
@@ -46290,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"));
@@ -46311,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;
@@ -46385,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 {
@@ -49057,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),
@@ -49090,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),
@@ -49117,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}` : ""
@@ -49130,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}` : ""
@@ -49164,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
@@ -49564,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 {
@@ -49587,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) {
@@ -49785,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),
@@ -49883,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,
@@ -49912,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, {
@@ -49945,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;
@@ -50063,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();
 
@@ -50128,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");
@@ -50149,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 {
@@ -50221,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, {
@@ -50232,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) {
@@ -50245,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;
@@ -50254,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;
   }
@@ -50268,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 });
     }
   }
 }
@@ -50294,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}`);
   }
@@ -50324,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);
@@ -50345,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
@@ -50363,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) {
@@ -50402,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}`);
@@ -50490,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) {
@@ -51638,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",
@@ -51771,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 = {