@constraint/cli 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constraint/cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Install, publish, and report Agent Skills with Constraint",
   "type": "module",
   "bin": { "constraint": "bin/constraint.js" },

package/src/cli.js

@@ -29,7 +29,7 @@ import {
   uploadSkill,
 } from './skills.js';
 
-const VERSION = '0.2.0';
+const VERSION = '0.2.1';
 
 const HELP = `Constraint Skills CLI
 
@@ -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');
@@ -182,12 +235,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) {