feat(skills): add refresh summary for discovery health

src/cli/skills.test.ts

@@ -7,6 +7,8 @@ import {
   toSkillListRows,
   renderSkillsTable,
   renderSkillInfo,
+  summarizeSkillsRefresh,
+  renderSkillsRefreshSummary,
   installSkillFromDirectory,
   uninstallSkillByName,
 } from './skills.js';
@@ -102,6 +104,31 @@ describe('skills CLI helpers', () => {
     expect(output).toContain('Unavailable reasons: Required binary not found');
   });
 
+  it('summarizes refresh counts across status and tiers', () => {
+    const summary = summarizeSkillsRefresh([
+      buildSkill({ manifest: { name: 'a', description: 'a', version: '1.0.0', tier: 'bundled' } }),
+      buildSkill({ manifest: { name: 'b', description: 'b', version: '1.0.0', tier: 'managed' } }),
+      buildSkill({ available: false, manifest: { name: 'c', description: 'c', version: '1.0.0', tier: 'workspace' } }),
+    ]);
+
+    expect(summary.total).toBe(3);
+    expect(summary.available).toBe(2);
+    expect(summary.unavailable).toBe(1);
+    expect(summary.tiers).toEqual({ bundled: 1, managed: 1, workspace: 1 });
+  });
+
+  it('renders refresh summary text', () => {
+    const output = renderSkillsRefreshSummary({
+      total: 4,
+      available: 3,
+      unavailable: 1,
+      tiers: { bundled: 2, managed: 1, workspace: 1 },
+    });
+
+    expect(output).toContain('Refreshed 4 skills');
+    expect(output).toContain('By tier: bundled=2, managed=1, workspace=1');
+  });
+
   it('installs a local skill directory', () => {
     const root = mkdtempSync(join(tmpdir(), 'flynn-skills-cli-'));
     const sourceDir = join(root, 'source-skill');

src/cli/skills.ts

@@ -12,6 +12,13 @@ export interface SkillListRow {
   reason?: string;
 }
 
+export interface SkillRefreshSummary {
+  total: number;
+  available: number;
+  unavailable: number;
+  tiers: Record<Skill['manifest']['tier'], number>;
+}
+
 export function toSkillListRows(skills: Skill[]): SkillListRow[] {
   return skills
     .map((skill) => ({
@@ -71,6 +78,37 @@ export function renderSkillInfo(skill: Skill): string {
   return lines.join('\n');
 }
 
+export function summarizeSkillsRefresh(skills: Skill[]): SkillRefreshSummary {
+  const summary: SkillRefreshSummary = {
+    total: skills.length,
+    available: 0,
+    unavailable: 0,
+    tiers: {
+      bundled: 0,
+      managed: 0,
+      workspace: 0,
+    },
+  };
+
+  for (const skill of skills) {
+    if (skill.available) {
+      summary.available += 1;
+    } else {
+      summary.unavailable += 1;
+    }
+    summary.tiers[skill.manifest.tier] += 1;
+  }
+
+  return summary;
+}
+
+export function renderSkillsRefreshSummary(summary: SkillRefreshSummary): string {
+  return [
+    `Refreshed ${summary.total} skills (${summary.available} available, ${summary.unavailable} unavailable).`,
+    `By tier: bundled=${summary.tiers.bundled}, managed=${summary.tiers.managed}, workspace=${summary.tiers.workspace}`,
+  ].join('\n');
+}
+
 function loadSkillsFromConfig(configPath?: string): { skills?: Skill[]; error?: string } {
   const loaded = loadConfigSafe(configPath);
   if (loaded.error || !loaded.config) {
@@ -242,4 +280,26 @@ export function registerSkillsCommand(program: Command): void {
 
       console.log(`Uninstalled skill '${name}'.`);
     });
+
+  skills
+    .command('refresh')
+    .description('Refresh skill discovery and print summary')
+    .option('--json', 'Output as JSON')
+    .option('-c, --config <path>', 'Config file path')
+    .action((opts: { json?: boolean; config?: string }) => {
+      const loaded = loadSkillsFromConfig(opts.config);
+      if (loaded.error || !loaded.skills) {
+        console.error(loaded.error ?? 'Failed to load skills');
+        process.exitCode = 1;
+        return;
+      }
+
+      const summary = summarizeSkillsRefresh(loaded.skills);
+      if (opts.json) {
+        console.log(JSON.stringify(summary, null, 2));
+        return;
+      }
+
+      console.log(renderSkillsRefreshSummary(summary));
+    });
 }