skillshark 0.1.0 → 0.2.0

package/src/interactive.js

@@ -0,0 +1,189 @@
+// The interactive session: `skillshark` with no arguments (TTY only) drops
+// into a guided menu; bare `share`/`install`/`inspect`/`revoke` run their
+// wizard one-shot. Built on @clack/prompts — every flow ends in the same
+// audited pipelines as the flag-driven CLI; the wizard only collects answers.
+import { CliError } from './errors.js';
+import { discoverAll } from './discover.js';
+import { parseSource } from './source.js';
+import { runShare, runRevoke } from './share.js';
+import { runInstall, runInspect } from './install.js';
+import { loadConfig } from './config.js';
+import { displayPath } from './ui.js';
+import { AGENTS } from './agents.js';
+import { VERSION } from './version.js';
+
+const FIN = [
+  '     |\\',
+  '     | \\',
+  '  ~~~;~~\\~~~~',
+];
+
+async function ux() {
+  const clack = await import('@clack/prompts');
+  const pc = (await import('picocolors')).default;
+  return { clack, pc };
+}
+
+function bail(clack, value) {
+  return value === null || value === undefined || clack.isCancel(value);
+}
+
+// --- share wizard --------------------------------------------------------------
+
+async function wizardShare(deps, { clack, pc }) {
+  const found = await deps.ui.spin('Scanning for shareable artifacts', () => discoverAll(deps));
+  if (!found.length) {
+    clack.log.warn('Nothing shareable here or in your home directory. Create a skill first (e.g. .claude/skills/<name>/SKILL.md).');
+    return { status: 'cancelled' };
+  }
+  const pick = await clack.select({
+    message: `Share which artifact? ${pc.dim(`(${found.length} found)`)}`,
+    maxItems: 12,
+    options: found.map((a) => ({
+      value: a.root,
+      label: a.name,
+      hint: `${AGENTS[a.agent]?.label ?? a.agent} ${a.type} · ${a.scope === 'global' ? '~' : displayPath(a.root, deps)}`,
+    })),
+  });
+  if (bail(clack, pick)) return { status: 'cancelled' };
+
+  const expires = await clack.select({
+    message: 'Advisory expiry (installers refuse after this; the gist lives until you revoke):',
+    initialValue: '7d',
+    options: [
+      { value: '30m', label: '30 minutes' },
+      { value: '6h', label: '6 hours' },
+      { value: '24h', label: '24 hours' },
+      { value: '7d', label: '7 days', hint: 'default' },
+      { value: '30d', label: '30 days' },
+    ],
+  });
+  if (bail(clack, expires)) return { status: 'cancelled' };
+
+  return runShare(pick, { expires }, deps);
+}
+
+// --- install / inspect wizards ----------------------------------------------------
+
+async function askSource(deps, { clack }) {
+  for (;;) {
+    const source = await clack.text({
+      message: 'Paste the link (gist URL, bare id, or gh:owner/repo[/path][@ref]):',
+      placeholder: 'https://gist.github.com/…#fp=…',
+    });
+    if (bail(clack, source)) return null;
+    try {
+      parseSource(String(source).trim());
+      return String(source).trim();
+    } catch (err) {
+      if (err instanceof CliError) {
+        clack.log.error(err.message);
+        continue;
+      }
+      throw err;
+    }
+  }
+}
+
+async function wizardInstall(deps, u) {
+  const source = await askSource(deps, u);
+  if (source === null) return { status: 'cancelled' };
+  return runInstall(source, {}, deps);
+}
+
+async function wizardInspect(deps, u) {
+  const { clack } = u;
+  const source = await askSource(deps, u);
+  if (source === null) return { status: 'cancelled' };
+  await runInspect(source, {}, deps);
+  const next = await clack.select({
+    message: 'And now?',
+    options: [
+      { value: 'install', label: 'Install it' },
+      { value: 'done', label: 'Done' },
+    ],
+  });
+  if (!bail(clack, next) && next === 'install') {
+    return runInstall(source, {}, deps);
+  }
+  return { status: 'inspected' };
+}
+
+// --- revoke wizard -----------------------------------------------------------------
+
+async function wizardRevoke(deps, { clack, pc }) {
+  const cfg = await loadConfig(deps.configDir);
+  let idOrName = null;
+  if (cfg.shares.length) {
+    const pick = await clack.select({
+      message: 'Revoke which share?',
+      maxItems: 12,
+      options: [
+        ...cfg.shares.map((s) => ({
+          value: s.id,
+          label: s.name,
+          hint: `${s.id.slice(0, 12)}… · expires ${s.expiresAt ? s.expiresAt.slice(0, 10) : 'never'}`,
+        })),
+        { value: '__manual', label: 'Enter a gist id or name…' },
+      ],
+    });
+    if (bail(clack, pick)) return { status: 'cancelled' };
+    idOrName = pick === '__manual' ? null : pick;
+  }
+  if (idOrName === null) {
+    const entered = await clack.text({ message: 'Gist id (or share name):' });
+    if (bail(clack, entered) || !String(entered).trim()) return { status: 'cancelled' };
+    idOrName = String(entered).trim();
+  }
+  clack.log.warn(pc.yellow('Revoking deletes the gist — anyone holding the link loses access immediately.'));
+  return runRevoke(idOrName, {}, deps);
+}
+
+// --- the session --------------------------------------------------------------------
+
+const WIZARDS = {
+  share: wizardShare,
+  install: wizardInstall,
+  inspect: wizardInspect,
+  revoke: wizardRevoke,
+};
+
+// action: run a single wizard (bare `skillshark share` etc.); null: full menu.
+export async function runInteractive(deps, action = null) {
+  const u = await ux();
+  const { clack, pc } = u;
+
+  clack.intro(`${pc.cyan(FIN.join('\n   '))}\n   ${pc.bold('skillshark')} ${pc.dim(`v${VERSION} — share agent skills like files`)}`);
+
+  if (action) {
+    const result = await WIZARDS[action](deps, u);
+    clack.outro(result?.status === 'cancelled' ? 'Nothing happened. 🦈' : 'Done. 🦈');
+    return 0;
+  }
+
+  for (;;) {
+    const choice = await clack.select({
+      message: 'What are we doing?',
+      options: [
+        { value: 'share', label: 'Share', hint: 'package a local skill → unlisted link' },
+        { value: 'install', label: 'Install', hint: 'from a link or repo path' },
+        { value: 'inspect', label: 'Inspect', hint: 'look before you leap' },
+        { value: 'revoke', label: 'Revoke', hint: 'kill a link you shared' },
+        { value: 'quit', label: 'Quit' },
+      ],
+    });
+    if (bail(clack, choice) || choice === 'quit') break;
+    try {
+      await WIZARDS[choice](deps, u);
+    } catch (err) {
+      if (err instanceof CliError) {
+        clack.log.error(err.message);
+      } else {
+        throw err;
+      }
+    }
+    clack.log.message('');
+  }
+  clack.outro('Swim safe. 🦈');
+  return 0;
+}

package/src/share.js

@@ -153,13 +153,14 @@ export async function runShare(arg, opts, deps) {
     } catch { /* preview is optional */ }
   }
 
-  const { id, revision } = await createGist({
-    manifestJson,
-    primaryDoc,
-    tarballB64: b64,
-    description: gistDescription({ name: manifest.name, agent: manifest.agent, type: manifest.type, fp8: shortFp }),
-    ghApi: deps.ghApi,
-  });
+  const { id, revision } = await ui.spin('Uploading as a secret gist', () =>
+    createGist({
+      manifestJson,
+      primaryDoc,
+      tarballB64: b64,
+      description: gistDescription({ name: manifest.name, agent: manifest.agent, type: manifest.type, fp8: shortFp }),
+      ghApi: deps.ghApi,
+    }));
   const url = `https://gist.github.com/${id}#fp=${shortFp}`;
 
   await addShareRecord(deps.configDir, {

package/src/ui.js

@@ -37,9 +37,29 @@ export function makeUi({ stdout = process.stdout, stderr = process.stderr, color
     warn: (s) => write(stdout, `  ${c.yellow('⚠')} ${s}`),
     info: (s) => write(stdout, `  ${c.cyan('ⓘ')} ${s}`),
     fail: (s) => write(stderr, `  ${c.red('✗')} ${s}`),
+    // network-op wrapper; the TTY entrypoint swaps in a real spinner
+    spin: async (_label, fn) => fn(),
   };
 }
 
+// Replace ui.spin with an animated @clack spinner (TTY only).
+export async function attachSpinner(ui) {
+  const clack = await import('@clack/prompts');
+  ui.spin = async (label, fn) => {
+    const s = clack.spinner();
+    s.start(label);
+    try {
+      const result = await fn();
+      s.stop(`${label} — done`);
+      return result;
+    } catch (err) {
+      s.stop(`${label} — failed`, 1);
+      throw err;
+    }
+  };
+  return ui;
+}
+
 // The install/inspect preview, rendered only from verified bytes (§4.2 step 5).
 export function renderPreview(ui, { manifest, fingerprint, fpFromLink, externalRefs }) {
   const c = ui.colors;
@@ -99,5 +119,10 @@ export async function realPrompts() {
       if (clack.isCancel(value)) return null;
       return value;
     },
+    async text({ message, placeholder }) {
+      const value = await clack.text({ message, placeholder });
+      if (clack.isCancel(value)) return null;
+      return String(value ?? '').trim();
+    },
   };
 }

package/src/version.js

@@ -1,2 +1,2 @@
-export const VERSION = '0.1.0';
+export const VERSION = '0.2.0';
 export const USER_AGENT = `skillshark/${VERSION}`;