@laststance/claude-plugin-dashboard 0.3.0 → 0.3.2

package/dist/services/components/markdownService.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Markdown component detection and parsing service
+ * Handles commands/ and agents/ directory scanning
+ */
+import type { ComponentInfo, ComponentDetailedInfo } from '../../types/index.js';
+/**
+ * Count .md files in a specific directory
+ * @param installPath - Plugin install path
+ * @param subdir - Subdirectory name ('commands' or 'agents')
+ * @returns Number of .md files
+ */
+export declare function countMarkdownFiles(installPath: string, subdir: string): number;
+/**
+ * Get component details from .md files in a directory
+ * Uses filename (minus extension) as component name
+ * @param installPath - Plugin install path
+ * @param subdir - Subdirectory name ('commands' or 'agents')
+ * @param type - Component type
+ * @returns Array of ComponentInfo
+ */
+export declare function getMarkdownFileDetails(installPath: string, subdir: string, type: 'command' | 'agent'): ComponentInfo[];
+/**
+ * Get detailed info for a command or agent markdown file
+ * @param installPath - Plugin install path
+ * @param componentName - Name of the component (without .md)
+ * @param type - Component type ('command' or 'agent')
+ * @returns ComponentDetailedInfo with full content
+ */
+export declare function getMarkdownComponentDetailedInfo(installPath: string, componentName: string, type: 'command' | 'agent'): ComponentDetailedInfo | undefined;
+/**
+ * Parse first non-empty line of content as description
+ * Properly skips YAML frontmatter block and strips heading markers
+ * @param content - Markdown content string
+ * @returns First non-frontmatter, non-empty line or undefined
+ * @example
+ * parseFirstLineDescriptionFromContent("---\nname: test\n---\n# My Title\n")
+ * // => "My Title"
+ */
+export declare function parseFirstLineDescriptionFromContent(content: string): string | undefined;

package/dist/services/components/markdownService.js

@@ -0,0 +1,147 @@
+/**
+ * Markdown component detection and parsing service
+ * Handles commands/ and agents/ directory scanning
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { directoryExists, fileExists } from '../fileService.js';
+/**
+ * Count .md files in a specific directory
+ * @param installPath - Plugin install path
+ * @param subdir - Subdirectory name ('commands' or 'agents')
+ * @returns Number of .md files
+ */
+export function countMarkdownFiles(installPath, subdir) {
+    const dirPath = path.join(installPath, subdir);
+    if (!directoryExists(dirPath)) {
+        return 0;
+    }
+    try {
+        const files = fs.readdirSync(dirPath);
+        return files.filter((file) => file.endsWith('.md')).length;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Get component details from .md files in a directory
+ * Uses filename (minus extension) as component name
+ * @param installPath - Plugin install path
+ * @param subdir - Subdirectory name ('commands' or 'agents')
+ * @param type - Component type
+ * @returns Array of ComponentInfo
+ */
+export function getMarkdownFileDetails(installPath, subdir, type) {
+    const dirPath = path.join(installPath, subdir);
+    if (!directoryExists(dirPath)) {
+        return [];
+    }
+    try {
+        const files = fs.readdirSync(dirPath);
+        return files
+            .filter((file) => file.endsWith('.md'))
+            .map((file) => {
+            const name = file.replace(/\.md$/, '');
+            const filePath = path.join(dirPath, file);
+            const description = parseFirstLineDescription(filePath);
+            return {
+                name,
+                description,
+                type,
+            };
+        });
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get detailed info for a command or agent markdown file
+ * @param installPath - Plugin install path
+ * @param componentName - Name of the component (without .md)
+ * @param type - Component type ('command' or 'agent')
+ * @returns ComponentDetailedInfo with full content
+ */
+export function getMarkdownComponentDetailedInfo(installPath, componentName, type) {
+    const subdir = type === 'command' ? 'commands' : 'agents';
+    const filePath = path.join(installPath, subdir, `${componentName}.md`);
+    if (!fileExists(filePath)) {
+        return undefined;
+    }
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        // Reuse content instead of reading file twice
+        const description = parseFirstLineDescriptionFromContent(content);
+        return {
+            name: componentName,
+            type,
+            description,
+            fullDescription: content,
+            filePath,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Parse first non-empty line of content as description
+ * Properly skips YAML frontmatter block and strips heading markers
+ * @param content - Markdown content string
+ * @returns First non-frontmatter, non-empty line or undefined
+ * @example
+ * parseFirstLineDescriptionFromContent("---\nname: test\n---\n# My Title\n")
+ * // => "My Title"
+ */
+export function parseFirstLineDescriptionFromContent(content) {
+    const lines = content.split('\n');
+    let inFrontmatter = false;
+    let frontmatterClosed = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Detect frontmatter delimiter
+        if (trimmed === '---') {
+            if (!inFrontmatter && !frontmatterClosed) {
+                // Opening delimiter
+                inFrontmatter = true;
+                continue;
+            }
+            else if (inFrontmatter) {
+                // Closing delimiter
+                inFrontmatter = false;
+                frontmatterClosed = true;
+                continue;
+            }
+        }
+        // Skip lines inside frontmatter
+        if (inFrontmatter) {
+            continue;
+        }
+        // Skip empty lines
+        if (!trimmed) {
+            continue;
+        }
+        // Found first content line - remove heading markers and return
+        return trimmed.replace(/^#+\s*/, '');
+    }
+    return undefined;
+}
+/**
+ * Parse first non-empty line of a markdown file as description
+ * Properly skips YAML frontmatter block and strips heading markers
+ * @param filePath - Path to markdown file
+ * @returns First non-frontmatter, non-empty line or undefined
+ * @example
+ * // File: "---\nname: test\n---\n# My Title\n"
+ * parseFirstLineDescription(path) // => "My Title"
+ */
+function parseFirstLineDescription(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        return parseFirstLineDescriptionFromContent(content);
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/services/components/serverService.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Server component detection service
+ * Handles MCP and LSP server detection from configuration files
+ */
+/**
+ * Count MCP servers defined in plugin.json
+ * @param installPath - Plugin install path
+ * @returns Number of MCP server configurations
+ */
+export declare function countMcpServers(installPath: string): number;
+/**
+ * Get MCP server names from plugin.json
+ * @param installPath - Plugin install path
+ * @returns Array of MCP server names
+ */
+export declare function getMcpServerNames(installPath: string): string[];
+/**
+ * Count LSP servers defined in .lsp.json
+ * @param installPath - Plugin install path
+ * @returns Number of LSP server configurations
+ */
+export declare function countLspServers(installPath: string): number;
+/**
+ * Get LSP server language IDs from .lsp.json
+ * @param installPath - Plugin install path
+ * @returns Array of language IDs
+ */
+export declare function getLspServerNames(installPath: string): string[];

package/dist/services/components/serverService.js

@@ -0,0 +1,69 @@
+/**
+ * Server component detection service
+ * Handles MCP and LSP server detection from configuration files
+ */
+import * as path from 'node:path';
+import { readJsonFile } from '../fileService.js';
+/**
+ * Count MCP servers defined in plugin.json
+ * @param installPath - Plugin install path
+ * @returns Number of MCP server configurations
+ */
+export function countMcpServers(installPath) {
+    // Check both .claude-plugin/plugin.json and plugin.json at root
+    const pluginJsonPaths = [
+        path.join(installPath, '.claude-plugin', 'plugin.json'),
+        path.join(installPath, 'plugin.json'),
+    ];
+    for (const pluginJsonPath of pluginJsonPaths) {
+        const pluginJson = readJsonFile(pluginJsonPath);
+        if (pluginJson?.mcpServers) {
+            return Object.keys(pluginJson.mcpServers).length;
+        }
+    }
+    return 0;
+}
+/**
+ * Get MCP server names from plugin.json
+ * @param installPath - Plugin install path
+ * @returns Array of MCP server names
+ */
+export function getMcpServerNames(installPath) {
+    const pluginJsonPaths = [
+        path.join(installPath, '.claude-plugin', 'plugin.json'),
+        path.join(installPath, 'plugin.json'),
+    ];
+    for (const pluginJsonPath of pluginJsonPaths) {
+        const pluginJson = readJsonFile(pluginJsonPath);
+        if (pluginJson?.mcpServers) {
+            return Object.keys(pluginJson.mcpServers);
+        }
+    }
+    return [];
+}
+/**
+ * Count LSP servers defined in .lsp.json
+ * @param installPath - Plugin install path
+ * @returns Number of LSP server configurations
+ */
+export function countLspServers(installPath) {
+    const lspJsonPath = path.join(installPath, '.lsp.json');
+    const lspConfig = readJsonFile(lspJsonPath);
+    if (!lspConfig) {
+        return 0;
+    }
+    return Object.keys(lspConfig).length;
+}
+/**
+ * Get LSP server language IDs from .lsp.json
+ * @param installPath - Plugin install path
+ * @returns Array of language IDs
+ */
+export function getLspServerNames(installPath) {
+    const lspJsonPath = path.join(installPath, '.lsp.json');
+    const lspConfig = readJsonFile(lspJsonPath);
+    if (!lspConfig) {
+        return [];
+    }
+    return Object.keys(lspConfig);
+}

package/dist/services/components/skillService.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Skill component detection and parsing service
+ * Handles skills/ directory scanning and SKILL.md parsing
+ */
+import type { ComponentInfo, ComponentDetailedInfo } from '../../types/index.js';
+/**
+ * Result of parsing full SKILL.md content
+ */
+interface SkillMdFullResult {
+    description?: string;
+    allowedTools?: string[];
+    fullDescription?: string;
+}
+/**
+ * Count skill directories in the skills/ folder
+ * Skills are stored as subdirectories with SKILL.md files
+ * @param installPath - Plugin install path
+ * @returns Number of skill directories
+ */
+export declare function countSkills(installPath: string): number;
+/**
+ * Get skill details from skills/ directory
+ * Reads directory names and parses SKILL.md frontmatter for descriptions
+ * @param installPath - Plugin install path
+ * @returns Array of ComponentInfo for each skill
+ */
+export declare function getSkillDetails(installPath: string): ComponentInfo[];
+/**
+ * Parse full SKILL.md content including frontmatter and body
+ * Extracts description, allowed-tools, and full markdown body
+ * @param skillMdPath - Path to SKILL.md file
+ * @returns Parsed content or undefined if file doesn't exist
+ * @example
+ * parseSkillMdFull('/path/to/SKILL.md')
+ * // => { description: "...", allowedTools: ["Read", "Edit"], fullDescription: "..." }
+ */
+export declare function parseSkillMdFull(skillMdPath: string): SkillMdFullResult | undefined;
+/**
+ * Get detailed info for a specific skill component
+ * @param installPath - Plugin install path
+ * @param skillName - Name of the skill directory
+ * @returns ComponentDetailedInfo with full SKILL.md content
+ * @example
+ * getSkillDetailedInfo('/path/to/plugin', 'sentry-code-review')
+ * // => { name: 'sentry-code-review', type: 'skill', allowedTools: [...], ... }
+ */
+export declare function getSkillDetailedInfo(installPath: string, skillName: string): ComponentDetailedInfo | undefined;
+export {};

package/dist/services/components/skillService.js

@@ -0,0 +1,164 @@
+/**
+ * Skill component detection and parsing service
+ * Handles skills/ directory scanning and SKILL.md parsing
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { directoryExists, fileExists } from '../fileService.js';
+/**
+ * Count skill directories in the skills/ folder
+ * Skills are stored as subdirectories with SKILL.md files
+ * @param installPath - Plugin install path
+ * @returns Number of skill directories
+ */
+export function countSkills(installPath) {
+    const skillsPath = path.join(installPath, 'skills');
+    if (!directoryExists(skillsPath)) {
+        return 0;
+    }
+    try {
+        const entries = fs.readdirSync(skillsPath, { withFileTypes: true });
+        return entries.filter((entry) => entry.isDirectory()).length;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Get skill details from skills/ directory
+ * Reads directory names and parses SKILL.md frontmatter for descriptions
+ * @param installPath - Plugin install path
+ * @returns Array of ComponentInfo for each skill
+ */
+export function getSkillDetails(installPath) {
+    const skillsPath = path.join(installPath, 'skills');
+    if (!directoryExists(skillsPath)) {
+        return [];
+    }
+    try {
+        const entries = fs.readdirSync(skillsPath, { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => {
+            const skillMdPath = path.join(skillsPath, entry.name, 'SKILL.md');
+            const description = parseSkillMdDescription(skillMdPath);
+            return {
+                name: entry.name,
+                description,
+                type: 'skill',
+            };
+        });
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Parse SKILL.md frontmatter for description
+ * Looks for `description:` field in YAML frontmatter
+ * @param skillMdPath - Path to SKILL.md file
+ * @returns Description string or undefined
+ */
+function parseSkillMdDescription(skillMdPath) {
+    if (!fileExists(skillMdPath)) {
+        return undefined;
+    }
+    try {
+        const content = fs.readFileSync(skillMdPath, 'utf-8');
+        // Match YAML frontmatter description field
+        const match = content.match(/^---\n[\s\S]*?description:\s*["']?(.+?)["']?\s*\n[\s\S]*?---/m);
+        return match?.[1]?.trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Parse full SKILL.md content including frontmatter and body
+ * Extracts description, allowed-tools, and full markdown body
+ * @param skillMdPath - Path to SKILL.md file
+ * @returns Parsed content or undefined if file doesn't exist
+ * @example
+ * parseSkillMdFull('/path/to/SKILL.md')
+ * // => { description: "...", allowedTools: ["Read", "Edit"], fullDescription: "..." }
+ */
+export function parseSkillMdFull(skillMdPath) {
+    if (!fileExists(skillMdPath)) {
+        return undefined;
+    }
+    try {
+        const content = fs.readFileSync(skillMdPath, 'utf-8');
+        const result = {};
+        // Check for frontmatter
+        if (!content.startsWith('---')) {
+            // No frontmatter, entire content is the body
+            result.fullDescription = content.trim();
+            return result;
+        }
+        // Find closing frontmatter delimiter
+        const endIndex = content.indexOf('---', 3);
+        if (endIndex === -1) {
+            // Malformed frontmatter
+            result.fullDescription = content.trim();
+            return result;
+        }
+        const frontmatter = content.substring(3, endIndex);
+        const body = content.substring(endIndex + 3).trim();
+        // Parse description from frontmatter
+        const descMatch = frontmatter.match(/description:\s*["']?(.+?)["']?\s*$/m);
+        if (descMatch?.[1]) {
+            result.description = descMatch[1].trim();
+        }
+        // Parse allowed-tools from frontmatter (can be array or comma-separated)
+        const toolsMatch = frontmatter.match(/allowed-tools:\s*\[([^\]]+)\]/m);
+        if (toolsMatch?.[1]) {
+            // Array format: allowed-tools: [Read, Edit, Write]
+            result.allowedTools = toolsMatch[1]
+                .split(',')
+                .map((t) => t.trim().replace(/["']/g, ''))
+                .filter(Boolean);
+        }
+        else {
+            // Try single line format: allowed-tools: Read, Edit
+            const singleMatch = frontmatter.match(/allowed-tools:\s*(.+)$/m);
+            if (singleMatch?.[1]) {
+                result.allowedTools = singleMatch[1]
+                    .split(',')
+                    .map((t) => t.trim().replace(/["']/g, ''))
+                    .filter(Boolean);
+            }
+        }
+        // Body is the content after frontmatter
+        if (body) {
+            result.fullDescription = body;
+        }
+        return result;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Get detailed info for a specific skill component
+ * @param installPath - Plugin install path
+ * @param skillName - Name of the skill directory
+ * @returns ComponentDetailedInfo with full SKILL.md content
+ * @example
+ * getSkillDetailedInfo('/path/to/plugin', 'sentry-code-review')
+ * // => { name: 'sentry-code-review', type: 'skill', allowedTools: [...], ... }
+ */
+export function getSkillDetailedInfo(installPath, skillName) {
+    const skillMdPath = path.join(installPath, 'skills', skillName, 'SKILL.md');
+    if (!fileExists(skillMdPath)) {
+        return undefined;
+    }
+    const parsed = parseSkillMdFull(skillMdPath);
+    return {
+        name: skillName,
+        type: 'skill',
+        description: parsed?.description,
+        allowedTools: parsed?.allowedTools,
+        fullDescription: parsed?.fullDescription,
+        filePath: skillMdPath,
+    };
+}

package/dist/services/components/utils.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Utility functions for plugin component operations
+ * Helper functions for checking and counting components
+ */
+import type { PluginComponents } from '../../types/index.js';
+/**
+ * Check if a plugin has any components
+ * @param components - PluginComponents object
+ * @returns true if at least one component type is present
+ * @example
+ * hasAnyComponents({ skills: 2 }) // => true
+ * hasAnyComponents({}) // => false
+ * hasAnyComponents(undefined) // => false
+ */
+export declare function hasAnyComponents(components: PluginComponents | undefined): boolean;
+/**
+ * Get total component count for a plugin
+ * @param components - PluginComponents object
+ * @returns Total number of components (hooks count as 1)
+ * @example
+ * getTotalComponentCount({ skills: 3, commands: 2, hooks: true }) // => 6
+ */
+export declare function getTotalComponentCount(components: PluginComponents | undefined): number;

package/dist/services/components/utils.js

@@ -0,0 +1,42 @@
+/**
+ * Utility functions for plugin component operations
+ * Helper functions for checking and counting components
+ */
+/**
+ * Check if a plugin has any components
+ * @param components - PluginComponents object
+ * @returns true if at least one component type is present
+ * @example
+ * hasAnyComponents({ skills: 2 }) // => true
+ * hasAnyComponents({}) // => false
+ * hasAnyComponents(undefined) // => false
+ */
+export function hasAnyComponents(components) {
+    if (!components) {
+        return false;
+    }
+    return ((components.skills ?? 0) > 0 ||
+        (components.commands ?? 0) > 0 ||
+        (components.agents ?? 0) > 0 ||
+        components.hooks === true ||
+        (components.mcpServers ?? 0) > 0 ||
+        (components.lspServers ?? 0) > 0);
+}
+/**
+ * Get total component count for a plugin
+ * @param components - PluginComponents object
+ * @returns Total number of components (hooks count as 1)
+ * @example
+ * getTotalComponentCount({ skills: 3, commands: 2, hooks: true }) // => 6
+ */
+export function getTotalComponentCount(components) {
+    if (!components) {
+        return 0;
+    }
+    return ((components.skills ?? 0) +
+        (components.commands ?? 0) +
+        (components.agents ?? 0) +
+        (components.hooks ? 1 : 0) +
+        (components.mcpServers ?? 0) +
+        (components.lspServers ?? 0));
+}

package/dist/services/pluginActionsService.d.ts

@@ -1,6 +1,6 @@
 /**
- * Plugin actions service for install/uninstall operations
- * Executes `claude plugin install/uninstall` as subprocess
+ * Plugin actions service for install/uninstall/update operations
+ * Executes `claude plugin install/uninstall/update` as subprocess
  */
 export interface PluginActionResult {
     success: boolean;
@@ -19,3 +19,32 @@ export declare function installPlugin(pluginId: string): Promise<PluginActionRes
  * @returns Promise resolving to action result
  */
 export declare function uninstallPlugin(pluginId: string): Promise<PluginActionResult>;
+/**
+ * Update a plugin via Claude CLI
+ * @param pluginId - Plugin identifier
+ * @returns Promise resolving to action result
+ */
+export declare function updatePlugin(pluginId: string): Promise<PluginActionResult>;
+/**
+ * Result of a bulk update operation
+ */
+export interface UpdateAllResult {
+    total: number;
+    succeeded: number;
+    failed: number;
+    results: Array<{
+        pluginId: string;
+        result: PluginActionResult;
+    }>;
+}
+/**
+ * Update all plugins sequentially
+ * @param pluginIds - Array of plugin identifiers to update
+ * @param onProgress - Optional callback for progress reporting
+ * @returns Promise resolving to bulk update result
+ * @example
+ * const result = await updateAllPlugins(['ctx7@official', 'sup@official'], (cur, total, id) => {
+ *   console.log(`Updating (${cur}/${total}): ${id}...`)
+ * })
+ */
+export declare function updateAllPlugins(pluginIds: string[], onProgress?: (current: number, total: number, pluginId: string) => void): Promise<UpdateAllResult>;