@lgtm-hq/ai-skills 0.6.0 → 0.7.0

package/lib/install.js

@@ -8,10 +8,10 @@ import { createClackUi, KNOWN_AGENTS } from "./ui.js";
 /**
  * Fill unset install selections through the terminal picker.
  *
- * Happy path asks for catalog source (+ vendor skill) and agents. Scope defaults
- * to global, installs symlink (not copy), and uses overwrite for the gateway
- * fail-closed `--on-conflict` API without prompting — upstream `skills` does
- * not implement conflict policies yet.
+ * Happy path asks for catalog source, skills (grouped multi-select for first-party),
+ * and agents. Scope defaults to global, installs symlink (not copy), and uses
+ * overwrite for the gateway fail-closed `--on-conflict` API without prompting —
+ * upstream `skills` does not implement conflict policies yet.
  *
  * @param {{agents: string[], bundle: string | null, copy: boolean, global: boolean, onConflict: string | null, project: boolean, skills: string[], vendor: string | null, yes: boolean}} options - Initial install options.
  * @param {ReturnType<typeof createClackUi>} [ui] - Injectable interactive UI.
@@ -22,14 +22,15 @@ export async function completeInteractively(options, ui = createClackUi()) {
 
   const bundles = await loadBundles();
   const vendors = await loadVendors();
+  const packageVersion = getPackageVersion();
   const sourceChoices = [
-    ...Object.entries(bundles.groups).map(([id, bundle]) => ({
-      value: `bundle:${id}`,
-      label: `${bundle.name} — ${bundle.description}`,
-    })),
+    {
+      value: "first-party",
+      label: `lgtm-hq/ai-skills @ v${packageVersion}`,
+    },
     ...vendors.vendors.map((vendor) => ({
       value: `vendor:${vendor.id}`,
-      label: `${vendor.repo} @ ${vendor.sha.slice(0, 12)}`,
+      label: vendor.repo,
     })),
   ];
 
@@ -40,26 +41,32 @@ export async function completeInteractively(options, ui = createClackUi()) {
       options: sourceChoices,
     }),
   );
-  const [sourceKind, sourceId] = splitSourceValue(sourceValue);
 
-  if (sourceKind === "bundle") {
-    const bundle = bundles.groups[sourceId];
-    options.bundle = sourceId;
-    options.skills = bundle.skills;
+  if (sourceValue === "first-party") {
+    const skillGroups = buildFirstPartySkillGroups(bundles);
+    options.skills = await cancelable(
+      ui,
+      ui.groupMultiselect({
+        message: "Select skills to install",
+        options: skillGroups,
+        required: true,
+      }),
+    );
   } else {
-    const index = await loadVendorIndex(sourceId);
-    const skillName = await cancelable(
+    const vendorId = parseVendorSourceValue(sourceValue);
+    const index = await loadVendorIndex(vendorId);
+    options.vendor = vendorId;
+    options.skills = await cancelable(
       ui,
-      ui.select({
-        message: `Skill from ${index.vendor.repo}`,
+      ui.multiselect({
+        message: `Select skills from ${index.vendor.repo}`,
         options: index.skills.map((skill) => ({
           value: skill.name,
           label: skill.name,
         })),
+        required: true,
       }),
     );
-    options.vendor = sourceId;
-    options.skills = [skillName];
   }
 
   if (options.agents.length === 0) {
@@ -136,14 +143,36 @@ export async function completeInteractively(options, ui = createClackUi()) {
 }
 
 /**
- * Split a `kind:id` catalog selection value.
+ * Build grouped skill options for first-party interactive install.
  *
- * @param {string} value - Combined select value.
- * @returns {[string, string]} Kind and id.
+ * @param {{groups: Record<string, {name: string, skills: string[]}>, ungrouped: string[]}} bundles - Loaded bundle catalog.
+ * @returns {Record<string, {value: string, label: string}[]>} Clack groupMultiselect options.
  */
-function splitSourceValue(value) {
-  const separator = value.indexOf(":");
-  return [value.slice(0, separator), value.slice(separator + 1)];
+function buildFirstPartySkillGroups(bundles) {
+  const groups = Object.fromEntries(
+    Object.values(bundles.groups).map((bundle) => [
+      bundle.name,
+      bundle.skills.map((skill) => ({ value: skill, label: skill })),
+    ]),
+  );
+  if (bundles.ungrouped.length > 0) {
+    groups.Other = bundles.ungrouped.map((skill) => ({ value: skill, label: skill }));
+  }
+  return groups;
+}
+
+/**
+ * Parse a vendor catalog selection value.
+ *
+ * @param {string} value - Combined select value (`vendor:<id>`).
+ * @returns {string} Vendor id.
+ */
+function parseVendorSourceValue(value) {
+  const prefix = "vendor:";
+  if (!value.startsWith(prefix)) {
+    throw new Error(`Unknown catalog selection: ${value}`);
+  }
+  return value.slice(prefix.length);
 }
 
 /**

package/lib/ui.js

@@ -20,6 +20,7 @@ export const KNOWN_AGENTS = [
  *   note: (message: string, title?: string) => void,
  *   select: (options: {message: string, options: {value: string, label: string}[], initialValue?: string}) => Promise<string | symbol>,
  *   multiselect: (options: {message: string, options: {value: string, label: string}[], initialValues?: string[], required?: boolean}) => Promise<string[] | symbol>,
+ *   groupMultiselect: (options: {message: string, options: Record<string, {value: string, label: string}[]>, initialValues?: string[], required?: boolean}) => Promise<string[] | symbol>,
  *   confirm: (options: {message: string, initialValue?: boolean}) => Promise<boolean | symbol>,
  *   isCancel: (value: unknown) => boolean,
  * }} Interactive UI adapter.
@@ -31,6 +32,7 @@ export function createClackUi() {
     note: clack.note,
     select: clack.select,
     multiselect: clack.multiselect,
+    groupMultiselect: clack.groupMultiselect,
     confirm: clack.confirm,
     isCancel: clack.isCancel,
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lgtm-hq/ai-skills",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Pinned installer gateway for first-party and vendor AI skills.",
   "license": "MIT",
   "homepage": "https://github.com/lgtm-hq/ai-skills#readme",