@constraint/cli 0.3.1 → 0.3.2

package/README.md

@@ -70,6 +70,7 @@ constraint setup --agent codex --dry-run
 ```bash
 constraint skills list
 constraint skills list --search research
+constraint skills domains
 constraint skills inspect account-research
 constraint skills inspect account-research --files
 ```
@@ -129,9 +130,14 @@ constraint skills update --all --global
 Create or edit a standard Agent Skill folder locally, then upload it:
 
 ```bash
+constraint skills domains
 constraint skills upload ./account-research --domain sales_pipeline
 ```
 
+`constraint skills domains --json` returns the exact domain slugs where the
+authenticated user can upload skills. Agents should discover the destination
+first and pass one returned `slug` to `--domain`.
+
 The folder must contain a root `SKILL.md` with `name` and `description` YAML
 frontmatter. Pass the owning domain with `--domain`; if it is omitted in an
 interactive terminal, the CLI asks which permitted domain owns the skill.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constraint/cli",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Install, publish, and report Agent Skills with Constraint",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -23,13 +23,14 @@ import {
   configuredAgents,
   installSkill,
   installedSkills,
+  manageableDomainRecords,
   manageableDomains,
   readTranscript,
   updateAll,
   uploadSkill,
 } from './skills.js';
 
-const VERSION = '0.3.1';
+const VERSION = '0.3.2';
 
 const HELP = `Constraint Skills CLI
 
@@ -39,6 +40,7 @@ Usage:
   constraint doctor [--agent codex|claude-code]...
   constraint skills list [--search <text>]
   constraint skills list --installed [--project|--global] [--agent <agent>]...
+  constraint skills domains
   constraint skills inspect <skill> [--version <version>] [--files]
   constraint skills install <skill> [--version <version>] [--agent <agent>]...
                             [--project|--global] [--copy] [--yes]
@@ -131,6 +133,39 @@ function printSkillList(items, options, out) {
   else out.line(`${presentation.title}\n${presentation.message}`);
 }
 
+export function domainListPresentation(domains) {
+  if (domains.length === 0) {
+    return {
+      title: 'No upload domains',
+      message: 'You do not have permission to upload skills to any domain.',
+    };
+  }
+  return {
+    title: `${domains.length} skill upload domain${domains.length === 1 ? '' : 's'}`,
+    message: domains.map((domain) => [
+      `${domain.name} (${domain.slug})`,
+      domain.description || 'No description.',
+    ].join('\n')).join('\n\n'),
+  };
+}
+
+async function listSkillDomains(args, config, out) {
+  rejectUnknown(args);
+  if (args.length) throw new Error('skills domains does not accept positional arguments');
+  const domains = (await manageableDomainRecords(config)).map(({ slug, name, description }) => ({
+    slug,
+    name,
+    description,
+  }));
+  if (out.json) {
+    out.data(domains);
+    return;
+  }
+  const presentation = domainListPresentation(domains);
+  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');
@@ -441,12 +476,13 @@ async function runCommand(args, config, out) {
 async function skillsCommand(args, config, out) {
   const command = args.shift();
   if (command === 'list') return listSkills(args, config, out);
+  if (command === 'domains') return listSkillDomains(args, config, out);
   if (command === 'inspect') return inspectSkill(args, config, out);
   if (command === 'install') return installCommand(args, config, out);
   if (command === 'update') return updateCommand(args, config, out);
   if (command === 'upload') return uploadCommand(args, config, out);
   if (command === 'run') return runCommand(args, config, out);
-  throw new Error('Expected skills list, inspect, install, update, upload, or run.');
+  throw new Error('Expected skills list, domains, inspect, install, update, upload, or run.');
 }
 
 export async function main(argv) {

package/src/skills.js

@@ -66,10 +66,12 @@ export async function uploadSkill(config, localPath, domain) {
 }
 
 export async function manageableDomains(config) {
+  return (await manageableDomainRecords(config)).map((domain) => domain.slug);
+}
+
+export async function manageableDomainRecords(config) {
   const domains = await apiRequest(config, '/domains');
-  return domains
-    .filter((domain) => domain.permissions.includes('domain:skill_manage'))
-    .map((domain) => domain.slug);
+  return domains.filter((domain) => domain.permissions.includes('domain:skill_manage'));
 }
 
 export async function configuredAgents() {