@constraint/cli 0.2.0 → 0.3.0

package/README.md

@@ -129,13 +129,14 @@ constraint skills update --all --global
 Create or edit a standard Agent Skill folder locally, then upload it:
 
 ```bash
-constraint skills upload ./account-research
+constraint skills upload ./account-research --domain sales_pipeline
 ```
 
 The folder must contain a root `SKILL.md` with `name` and `description` YAML
-frontmatter. If the user can manage more than one Constraint domain, the CLI
-asks which domain owns the skill. Skill versions are immutable; uploading
-changed content creates the next version.
+frontmatter. Pass the owning domain with `--domain`; if it is omitted in an
+interactive terminal, the CLI asks which permitted domain owns the skill.
+Skill versions are immutable; uploading changed content creates the next
+version.
 
 ## Report skill runs
 

package/package.json

@@ -1,10 +1,16 @@
 {
   "name": "@constraint/cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Install, publish, and report Agent Skills with Constraint",
   "type": "module",
-  "bin": { "constraint": "bin/constraint.js" },
-  "files": ["bin", "src", "skills"],
+  "bin": {
+    "constraint": "bin/constraint.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "skills"
+  ],
   "scripts": {
     "check": "node --check bin/constraint.js && node --check src/cli.js",
     "test": "node --test"
@@ -13,7 +19,12 @@
     "@clack/prompts": "1.7.0",
     "picocolors": "1.1.1"
   },
-  "engines": { "node": ">=20" },
+  "engines": {
+    "node": ">=20"
+  },
   "license": "SEE LICENSE IN LICENSE",
-  "publishConfig": { "access": "public", "provenance": true }
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
 }

package/src/cli.js

@@ -29,7 +29,7 @@ import {
   uploadSkill,
 } from './skills.js';
 
-const VERSION = '0.2.0';
+const VERSION = '0.2.2';
 
 const HELP = `Constraint Skills CLI
 
@@ -45,7 +45,7 @@ Usage:
   constraint skills update <skill> [--agent <agent>]... [--project|--global]
                            [--copy] [--yes]
   constraint skills update --all [--agent <agent>]... [--project|--global] [--yes]
-  constraint skills upload <path>
+  constraint skills upload <path> --domain <domain>
   constraint skills run start <skill> --client <client> --session <session-id>
   constraint skills run complete <run-id> <transcript-path>
   constraint skills run list [--team <team>]... [--user <user>]... [--skill <skill>]...
@@ -78,6 +78,59 @@ function interactive(out) {
   return Boolean(process.stdin.isTTY && process.stdout.isTTY && !out.json && !out.quiet);
 }
 
+function humanize(value) {
+  return String(value || '').replaceAll('_', ' ').replace(/\b\w/g, (letter) => letter.toUpperCase());
+}
+
+export function skillListPresentation(items, { installed = false, search = null, scope = 'project' } = {}) {
+  if (items.length === 0) {
+    if (installed) {
+      return {
+        title: 'No installed skills',
+        message: `Nothing is installed in ${scope} scope yet.\n\nBrowse available skills:\nconstraint skills list`,
+      };
+    }
+    if (search) {
+      return {
+        title: 'No matching skills',
+        message: `Nothing matched “${search}”. Try a broader search.`,
+      };
+    }
+    return {
+      title: 'No skills yet',
+      message: 'Your organization has not published any skills.\n\nPublish the first one:\nconstraint skills upload <path>',
+    };
+  }
+
+  if (installed) {
+    return {
+      title: `${items.length} installed skill${items.length === 1 ? '' : 's'}`,
+      message: items.map((item) => [
+        `${item.slug} · v${item.version} · ${item.agent}`,
+        `${humanize(item.scope)} · ${humanize(item.mode)} · ${item.path}`,
+      ].join('\n')).join('\n\n'),
+    };
+  }
+
+  return {
+    title: `${items.length} available skill${items.length === 1 ? '' : 's'}`,
+    message: items.map((item) => [
+      `${item.name} (${item.slug}) · v${item.latest_version} · ${humanize(item.domain)}`,
+      item.description,
+    ].join('\n')).join('\n\n'),
+  };
+}
+
+function printSkillList(items, options, out) {
+  if (out.json) {
+    out.data(items);
+    return;
+  }
+  const presentation = skillListPresentation(items, options);
+  if (interactive(out)) note(presentation.message, presentation.title);
+  else out.line(`${presentation.title}\n${presentation.message}`);
+}
+
 function takeScope(args) {
   const project = takeFlag(args, '--project');
   const global = takeFlag(args, '--global');
@@ -111,6 +164,15 @@ async function chooseDomain(domains) {
   return selected;
 }
 
+export function resolveUploadDomain(value, domains) {
+  if (!value) return null;
+  const normalized = String(value).trim().toLowerCase().replaceAll('-', '_').replaceAll(' ', '_');
+  if (!domains.includes(normalized)) {
+    throw new Error(`You do not have permission to upload skills to ${normalized}. Available domains: ${domains.join(', ') || 'none'}.`);
+  }
+  return normalized;
+}
+
 async function authCommand(command, args, config, out) {
   rejectUnknown(args);
   if (args.length) throw new Error(`${command} does not accept positional arguments`);
@@ -182,12 +244,15 @@ async function listSkills(args, config, out) {
   if (args.length) throw new Error('skills list does not accept positional arguments');
   if (installed) {
     if (search) throw new Error('--search cannot be combined with --installed.');
-    out.data(await installedSkills({ scope: scopeFlag || 'project', agents }));
+    const scope = scopeFlag || 'project';
+    const skills = await installedSkills({ scope, agents });
+    printSkillList(skills, { installed: true, scope }, out);
     return;
   }
   if (scopeFlag || agents.length) throw new Error('--project, --global, and --agent require --installed.');
   const query = search ? `?search=${encodeURIComponent(search)}` : '';
-  out.data(await apiRequest(config, `/skills${query}`));
+  const skills = await apiRequest(config, `/skills${query}`);
+  printSkillList(skills, { search }, out);
 }
 
 async function inspectSkill(args, config, out) {
@@ -295,9 +360,11 @@ async function updateCommand(args, config, out) {
 }
 
 async function uploadCommand(args, config, out) {
+  const requestedDomain = takeOption(args, '--domain');
   rejectUnknown(args);
-  if (args.length !== 1) throw new Error('Usage: constraint skills upload <path>');
-  const domain = await chooseDomain(await manageableDomains(config));
+  if (args.length !== 1) throw new Error('Usage: constraint skills upload <path> --domain <domain>');
+  const domains = await manageableDomains(config);
+  const domain = resolveUploadDomain(requestedDomain, domains) || await chooseDomain(domains);
   const detail = await uploadSkill(config, args[0], domain);
   out.data({ skill_id: detail.skill_id, slug: detail.slug, domain: detail.domain, version: detail.version.version });
 }

package/src/skills.js

@@ -24,11 +24,6 @@ import {
   workspaceId,
 } from './paths.js';
 
-export const DOMAINS = [
-  'sales_pipeline', 'content_audience', 'marketing_demand', 'offers_monetization',
-  'operations_team', 'partnerships_bd',
-];
-
 function filesFromDetail(detail) {
   return detail.version.files.map((file) => ({
     path: file.path,
@@ -71,9 +66,10 @@ export async function uploadSkill(config, localPath, domain) {
 }
 
 export async function manageableDomains(config) {
-  const actor = await apiRequest(config, '/me');
-  if (actor.permissions.includes('org.manage')) return DOMAINS;
-  return DOMAINS.filter((domain) => actor.permissions.includes(`${domain}.skill.manage`));
+  const domains = await apiRequest(config, '/domains');
+  return domains
+    .filter((domain) => domain.permissions.includes('domain:skill_manage'))
+    .map((domain) => domain.slug);
 }
 
 export async function configuredAgents() {