specweave 0.3.13 → 0.4.1

package/dist/utils/cost-reporter.js

@@ -0,0 +1,224 @@
+/**
+ * Cost Report Generation
+ *
+ * Generates human-readable cost reports with multiple export formats:
+ * - JSON (machine-readable)
+ * - CSV (spreadsheet import)
+ * - ASCII Dashboard (CLI display)
+ */
+import fs from 'fs-extra';
+export class CostReporter {
+    constructor(costTracker) {
+        this.costTracker = costTracker;
+    }
+    /**
+     * Generate cost report for a specific increment
+     *
+     * @param incrementId - Increment ID (e.g., '0003')
+     * @returns Aggregate cost report
+     */
+    generateIncrementReport(incrementId) {
+        return this.costTracker.getIncrementCost(incrementId);
+    }
+    /**
+     * Export report to JSON file
+     *
+     * @param incrementId - Increment ID
+     * @param outputPath - Output file path
+     */
+    async exportToJSON(incrementId, outputPath) {
+        const report = this.generateIncrementReport(incrementId);
+        await fs.writeJson(outputPath, report, { spaces: 2 });
+    }
+    /**
+     * Export report to CSV file
+     *
+     * @param incrementId - Increment ID
+     * @param outputPath - Output file path
+     */
+    async exportToCSV(incrementId, outputPath) {
+        const sessions = this.costTracker.getIncrementSessions(incrementId);
+        // CSV headers
+        const headers = [
+            'Session ID',
+            'Agent',
+            'Model',
+            'Command',
+            'Started At',
+            'Ended At',
+            'Input Tokens',
+            'Output Tokens',
+            'Total Tokens',
+            'Cost ($)',
+            'Savings ($)',
+        ];
+        // CSV rows
+        const rows = sessions.map((s) => [
+            s.sessionId,
+            s.agent,
+            s.model,
+            s.command || 'N/A',
+            s.startedAt,
+            s.endedAt || 'In Progress',
+            s.tokenUsage.inputTokens.toString(),
+            s.tokenUsage.outputTokens.toString(),
+            s.tokenUsage.totalTokens.toString(),
+            s.cost.toFixed(4),
+            s.savings.toFixed(4),
+        ]);
+        // Generate CSV (simple implementation, no external deps)
+        const csv = [headers.join(','), ...rows.map((row) => row.join(','))].join('\n');
+        await fs.writeFile(outputPath, csv, 'utf-8');
+    }
+    /**
+     * Generate ASCII dashboard for CLI display
+     *
+     * @param incrementId - Optional increment ID (defaults to all increments)
+     * @returns ASCII table with cost breakdown
+     */
+    generateDashboard(incrementId) {
+        if (incrementId) {
+            return this.generateIncrementDashboard(incrementId);
+        }
+        else {
+            return this.generateOverallDashboard();
+        }
+    }
+    /**
+     * Generate dashboard for a specific increment
+     */
+    generateIncrementDashboard(incrementId) {
+        const report = this.generateIncrementReport(incrementId);
+        const sessions = this.costTracker.getIncrementSessions(incrementId);
+        if (sessions.length === 0) {
+            return `No cost data for increment ${incrementId}`;
+        }
+        const lines = [];
+        // Header
+        lines.push('');
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push(`  Cost Report: Increment ${incrementId}`);
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push('');
+        // Summary
+        lines.push('SUMMARY');
+        lines.push('───────────────────────────────────────────────────────────────');
+        lines.push(`  Total Cost:       $${report.totalCost.toFixed(4).padStart(10)}`);
+        lines.push(`  Total Savings:    $${report.totalSavings.toFixed(4).padStart(10)}`);
+        const baselineCost = report.totalCost + report.totalSavings;
+        const savingsPercentage = baselineCost > 0 ? (report.totalSavings / baselineCost) * 100 : 0;
+        lines.push(`  Savings %:         ${savingsPercentage.toFixed(1).padStart(10)}%`);
+        lines.push(`  Total Tokens:      ${report.totalTokens.toLocaleString().padStart(10)}`);
+        lines.push(`  Sessions:          ${report.sessionCount.toString().padStart(10)}`);
+        lines.push('');
+        // Cost by Model
+        lines.push('COST BY MODEL');
+        lines.push('───────────────────────────────────────────────────────────────');
+        for (const [model, cost] of Object.entries(report.costByModel)) {
+            const percentage = (cost / report.totalCost) * 100;
+            lines.push(`  ${model.padEnd(15)} $${cost.toFixed(4).padStart(10)}  (${percentage.toFixed(1).padStart(5)}%)`);
+        }
+        lines.push('');
+        // Cost by Agent
+        lines.push('COST BY AGENT');
+        lines.push('───────────────────────────────────────────────────────────────');
+        const sortedAgents = Object.entries(report.costByAgent).sort(([, a], [, b]) => b - a);
+        for (const [agent, cost] of sortedAgents.slice(0, 10)) {
+            // Top 10
+            const percentage = (cost / report.totalCost) * 100;
+            lines.push(`  ${agent.padEnd(25)} $${cost.toFixed(4).padStart(8)}  (${percentage.toFixed(1).padStart(5)}%)`);
+        }
+        if (sortedAgents.length > 10) {
+            lines.push(`  ... and ${sortedAgents.length - 10} more agents`);
+        }
+        lines.push('');
+        // Recent Sessions (last 5)
+        lines.push('RECENT SESSIONS');
+        lines.push('───────────────────────────────────────────────────────────────');
+        const recentSessions = sessions
+            .sort((a, b) => {
+            const timeA = new Date(a.startedAt).getTime();
+            const timeB = new Date(b.startedAt).getTime();
+            return timeB - timeA;
+        })
+            .slice(0, 5);
+        for (const session of recentSessions) {
+            const time = new Date(session.startedAt).toLocaleString();
+            lines.push(`  ${time}`);
+            lines.push(`  Agent: ${session.agent.padEnd(20)} Model: ${session.model}`);
+            lines.push(`  Cost: $${session.cost.toFixed(4).padStart(8)}    Savings: $${session.savings.toFixed(4).padStart(8)}`);
+            lines.push('');
+        }
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push('');
+        return lines.join('\n');
+    }
+    /**
+     * Generate dashboard for all increments
+     */
+    generateOverallDashboard() {
+        const summary = this.costTracker.getSummary();
+        if (summary.totalSessions === 0) {
+            return 'No cost data available';
+        }
+        const lines = [];
+        // Header
+        lines.push('');
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push('  SpecWeave Cost Summary - All Increments');
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push('');
+        // Overall Summary
+        lines.push('OVERALL SUMMARY');
+        lines.push('───────────────────────────────────────────────────────────────');
+        lines.push(`  Total Cost:       $${summary.totalCost.toFixed(4).padStart(10)}`);
+        lines.push(`  Total Savings:    $${summary.totalSavings.toFixed(4).padStart(10)}`);
+        lines.push(`  Savings %:         ${summary.savingsPercentage.toFixed(1).padStart(10)}%`);
+        lines.push(`  Total Sessions:    ${summary.totalSessions.toString().padStart(10)}`);
+        lines.push('');
+        // Agent Stats
+        if (summary.mostExpensiveAgent) {
+            lines.push('AGENT STATS');
+            lines.push('───────────────────────────────────────────────────────────────');
+            lines.push(`  Most Expensive:    ${summary.mostExpensiveAgent}`);
+            if (summary.cheapestAgent !== summary.mostExpensiveAgent) {
+                lines.push(`  Least Expensive:   ${summary.cheapestAgent}`);
+            }
+            lines.push('');
+        }
+        // By Increment
+        const allSessions = this.costTracker.getAllSessions();
+        const incrementIds = [...new Set(allSessions.map((s) => s.increment).filter(Boolean))];
+        if (incrementIds.length > 0) {
+            lines.push('COST BY INCREMENT');
+            lines.push('───────────────────────────────────────────────────────────────');
+            for (const incrementId of incrementIds) {
+                const report = this.generateIncrementReport(incrementId);
+                lines.push(`  ${incrementId.padEnd(30)} $${report.totalCost.toFixed(4).padStart(8)}  (${report.sessionCount} sessions)`);
+            }
+            lines.push('');
+        }
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push('');
+        lines.push('💡 Tip: Use "/specweave.costs 0003" to see detailed report for increment 0003');
+        lines.push('');
+        return lines.join('\n');
+    }
+    /**
+     * Generate compact one-line summary
+     *
+     * @param incrementId - Optional increment ID
+     * @returns One-line summary string
+     */
+    generateSummaryLine(incrementId) {
+        if (incrementId) {
+            const report = this.generateIncrementReport(incrementId);
+            return `Increment ${incrementId}: $${report.totalCost.toFixed(4)} cost, $${report.totalSavings.toFixed(4)} saved (${((report.totalSavings / (report.totalCost + report.totalSavings)) * 100).toFixed(1)}%)`;
+        }
+        else {
+            const summary = this.costTracker.getSummary();
+            return `Total: $${summary.totalCost.toFixed(4)} cost, $${summary.totalSavings.toFixed(4)} saved (${summary.savingsPercentage.toFixed(1)}%) across ${summary.totalSessions} sessions`;
+        }
+    }
+}
+//# sourceMappingURL=cost-reporter.js.map

package/dist/utils/cost-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-reporter.js","sourceRoot":"","sources":["../../src/utils/cost-reporter.ts"],"names":[],"mappings":"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"}

package/dist/utils/pricing-constants.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Anthropic API Pricing Constants
+ *
+ * Pricing as of 2025-10-31 (verified against https://www.anthropic.com/pricing)
+ *
+ * Model Tier Mapping:
+ * - sonnet → claude-sonnet-4-5-20250929 (latest Sonnet 4.5)
+ * - haiku → claude-4-5-haiku-20250110 (latest Haiku 4.5)
+ * - opus → claude-opus-4-0-... (when released)
+ *
+ * Note: This file should be updated when Anthropic releases new models.
+ */
+/**
+ * Pricing per 1M tokens (input/output) in USD
+ */
+export declare const PRICING: {
+    readonly sonnet: {
+        readonly input: 0.000003;
+        readonly output: 0.000015;
+    };
+    readonly haiku: {
+        readonly input: 0.000001;
+        readonly output: 0.000005;
+    };
+    readonly opus: {
+        readonly input: 0.000015;
+        readonly output: 0.000075;
+    };
+};
+/**
+ * Calculate cost for a given model and token usage
+ *
+ * @param model - Model tier (sonnet, haiku, opus)
+ * @param inputTokens - Number of input tokens
+ * @param outputTokens - Number of output tokens
+ * @returns Total cost in USD
+ *
+ * @example
+ * ```typescript
+ * const cost = calculateCost('haiku', 1000, 500);
+ * // Returns: 0.0035 ($0.0035 = $0.001 input + $0.0025 output)
+ * ```
+ */
+export declare function calculateCost(model: 'sonnet' | 'haiku' | 'opus', inputTokens: number, outputTokens: number): number;
+/**
+ * Get pricing constants for a specific model
+ *
+ * @param model - Model tier
+ * @returns Pricing object with input/output costs
+ */
+export declare function getModelPricing(model: 'sonnet' | 'haiku' | 'opus'): {
+    readonly input: 0.000003;
+    readonly output: 0.000015;
+} | {
+    readonly input: 0.000001;
+    readonly output: 0.000005;
+} | {
+    readonly input: 0.000015;
+    readonly output: 0.000075;
+};
+/**
+ * Calculate cost savings vs baseline (all-Sonnet)
+ *
+ * @param actualModel - Model actually used
+ * @param inputTokens - Input tokens
+ * @param outputTokens - Output tokens
+ * @returns Savings amount in dollars (positive = saved money)
+ */
+export declare function calculateSavings(actualModel: 'sonnet' | 'haiku' | 'opus', inputTokens: number, outputTokens: number): number;
+//# sourceMappingURL=pricing-constants.d.ts.map

package/dist/utils/pricing-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing-constants.d.ts","sourceRoot":"","sources":["../../src/utils/pricing-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;CAaV,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,EAClC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAGR;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM;;;;;;;;;EAEjE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,EACxC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAMR"}

package/dist/utils/pricing-constants.js

@@ -0,0 +1,71 @@
+/**
+ * Anthropic API Pricing Constants
+ *
+ * Pricing as of 2025-10-31 (verified against https://www.anthropic.com/pricing)
+ *
+ * Model Tier Mapping:
+ * - sonnet → claude-sonnet-4-5-20250929 (latest Sonnet 4.5)
+ * - haiku → claude-4-5-haiku-20250110 (latest Haiku 4.5)
+ * - opus → claude-opus-4-0-... (when released)
+ *
+ * Note: This file should be updated when Anthropic releases new models.
+ */
+/**
+ * Pricing per 1M tokens (input/output) in USD
+ */
+export const PRICING = {
+    sonnet: {
+        input: 0.000003, // $3 per 1M input tokens
+        output: 0.000015, // $15 per 1M output tokens
+    },
+    haiku: {
+        input: 0.000001, // $1 per 1M input tokens
+        output: 0.000005, // $5 per 1M output tokens
+    },
+    opus: {
+        input: 0.000015, // $15 per 1M input tokens
+        output: 0.000075, // $75 per 1M output tokens
+    },
+};
+/**
+ * Calculate cost for a given model and token usage
+ *
+ * @param model - Model tier (sonnet, haiku, opus)
+ * @param inputTokens - Number of input tokens
+ * @param outputTokens - Number of output tokens
+ * @returns Total cost in USD
+ *
+ * @example
+ * ```typescript
+ * const cost = calculateCost('haiku', 1000, 500);
+ * // Returns: 0.0035 ($0.0035 = $0.001 input + $0.0025 output)
+ * ```
+ */
+export function calculateCost(model, inputTokens, outputTokens) {
+    const pricing = PRICING[model];
+    return (inputTokens * pricing.input) + (outputTokens * pricing.output);
+}
+/**
+ * Get pricing constants for a specific model
+ *
+ * @param model - Model tier
+ * @returns Pricing object with input/output costs
+ */
+export function getModelPricing(model) {
+    return PRICING[model];
+}
+/**
+ * Calculate cost savings vs baseline (all-Sonnet)
+ *
+ * @param actualModel - Model actually used
+ * @param inputTokens - Input tokens
+ * @param outputTokens - Output tokens
+ * @returns Savings amount in dollars (positive = saved money)
+ */
+export function calculateSavings(actualModel, inputTokens, outputTokens) {
+    const actualCost = calculateCost(actualModel, inputTokens, outputTokens);
+    const baselineCost = calculateCost('sonnet', inputTokens, outputTokens);
+    const savedAmount = baselineCost - actualCost;
+    return savedAmount;
+}
+//# sourceMappingURL=pricing-constants.js.map

package/dist/utils/pricing-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing-constants.js","sourceRoot":"","sources":["../../src/utils/pricing-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ,EAAI,yBAAyB;QAC5C,MAAM,EAAE,QAAQ,EAAG,2BAA2B;KAC/C;IACD,KAAK,EAAE;QACL,KAAK,EAAE,QAAQ,EAAI,yBAAyB;QAC5C,MAAM,EAAE,QAAQ,EAAG,0BAA0B;KAC9C;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,QAAQ,EAAI,0BAA0B;QAC7C,MAAM,EAAE,QAAQ,EAAG,2BAA2B;KAC/C;CACO,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAkC,EAClC,WAAmB,EACnB,YAAoB;IAEpB,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/B,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AACzE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAkC;IAChE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAwC,EACxC,WAAmB,EACnB,YAAoB;IAEpB,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IACzE,MAAM,YAAY,GAAG,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IACxE,MAAM,WAAW,GAAG,YAAY,GAAG,UAAU,CAAC;IAE9C,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.3.13",
+  "version": "0.4.1",
   "description": "Replace vibe coding with spec-driven development. Smart workflow: /specweave inc auto-closes previous, /specweave build auto-resumes, /specweave progress shows status. PM-led planning, 10 agents, 35+ skills. spec-weave.com",
   "type": "module",
   "main": "dist/index.js",
@@ -14,16 +14,19 @@
     "test": "jest",
     "test:smoke": "bash tests/smoke/e2e-smoke-test.sh",
     "test:e2e": "playwright test tests/e2e/specweave-smoke.spec.ts",
-    "test:integration": "npm run test:integration:ado && npm run test:integration:jira",
-    "test:integration:ado": "ts-node tests/integration/ado-sync/ado-sync.test.ts",
-    "test:integration:jira": "ts-node tests/integration/jira-sync/jira-sync.test.ts",
-    "test:sync:jira": "ts-node tests/integration/jira-sync/jira-bidirectional-sync.test.ts",
-    "test:incremental:jira": "ts-node tests/integration/jira-sync/jira-incremental-sync.test.ts",
-    "generate:tests": "ts-node scripts/generate-tests.ts",
-    "generate:tests:skill": "ts-node scripts/generate-tests.ts",
+    "test:integration": "npm run test:integration:ado && npm run test:integration:jira && npm run test:integration:ml",
+    "test:integration:ado": "npx tsx tests/integration/ado-sync/ado-sync.test.ts",
+    "test:integration:jira": "npx tsx tests/integration/jira-sync/jira-sync.test.ts",
+    "test:integration:ml": "npx tsx tests/integration/ml-pipeline-workflow/ml-pipeline-soccer-detection.test.ts",
+    "test:sync:jira": "npx tsx tests/integration/jira-sync/jira-bidirectional-sync.test.ts",
+    "test:incremental:jira": "npx tsx tests/integration/jira-sync/jira-incremental-sync.test.ts",
+    "test:ml:pipeline": "npx tsx tests/integration/ml-pipeline-workflow/ml-pipeline-soccer-detection.test.ts",
+    "test:ml:real": "npx tsx tests/integration/ml-pipeline-workflow/ml-pipeline-real-video.test.ts",
+    "generate:tests": "npx tsx scripts/generate-tests.ts",
+    "generate:tests:skill": "npx tsx scripts/generate-tests.ts",
     "test:all:generated": "bash scripts/run-all-tests.sh",
     "test:all": "npm test && npm run test:smoke && npm run test:integration",
-    "generate:skills-index": "ts-node src/utils/generate-skills-index.ts",
+    "generate:skills-index": "npx tsx src/utils/generate-skills-index.ts",
     "prepublishOnly": "npm run build",
     "install:agents": "bash bin/install-agents.sh",
     "install:skills": "bash bin/install-skills.sh",
@@ -77,6 +80,7 @@
     "LICENSE"
   ],
   "dependencies": {
+    "ajv": "^8.17.1",
     "chalk": "^5.3.0",
     "commander": "^11.1.0",
     "fs-extra": "^11.2.0",

package/src/adapters/adapter-base.ts

@@ -16,6 +16,7 @@ import {
   AutomationLevel
 } from './adapter-interface.js';
 import { getDirname } from '../utils/esm-helpers.js';
+import type { Plugin } from '../core/types/plugin.js';
 
 const __dirname = getDirname(import.meta.url);
 
@@ -146,4 +147,36 @@ export abstract class AdapterBase implements IAdapter {
 
     return content;
   }
+
+  /**
+   * Check if this adapter supports plugins
+   * Default: No plugin support (override in concrete adapters)
+   */
+  supportsPlugins(): boolean {
+    return false;
+  }
+
+  /**
+   * Compile and install a plugin
+   * Default: Throw error (override in concrete adapters that support plugins)
+   */
+  async compilePlugin(plugin: Plugin): Promise<void> {
+    throw new Error(`Plugin support not implemented for ${this.name} adapter`);
+  }
+
+  /**
+   * Unload a plugin
+   * Default: Throw error (override in concrete adapters that support plugins)
+   */
+  async unloadPlugin(pluginName: string): Promise<void> {
+    throw new Error(`Plugin support not implemented for ${this.name} adapter`);
+  }
+
+  /**
+   * Get installed plugins
+   * Default: Return empty array (override in concrete adapters that support plugins)
+   */
+  async getInstalledPlugins(): Promise<string[]> {
+    return [];
+  }
 }

package/src/adapters/adapter-interface.ts

@@ -5,6 +5,8 @@
  * Enables SpecWeave to work with ANY AI coding tool (Claude, Cursor, Copilot, etc.)
  */
 
+import type { Plugin } from '../core/types/plugin.js';
+
 export interface AdapterOptions {
   projectPath: string;
   projectName: string;
@@ -117,4 +119,48 @@ export interface IAdapter {
    * @returns string Markdown-formatted instructions
    */
   getInstructions(): string;
+
+  /**
+   * Check if this adapter supports plugins
+   *
+   * Returns true if the adapter can install and compile plugins
+   * (Claude native, Cursor AGENTS.md, Copilot instructions.md)
+   * Returns false for generic/manual adapters
+   *
+   * @returns boolean True if plugins are supported
+   */
+  supportsPlugins(): boolean;
+
+  /**
+   * Compile and install a plugin for this adapter
+   *
+   * Transforms plugin content (skills/agents/commands) to tool-specific format:
+   * - Claude: Copy to .claude/skills/, .claude/agents/, .claude/commands/
+   * - Cursor: Compile to AGENTS.md + team commands JSON
+   * - Copilot: Compile to .github/copilot/instructions.md
+   * - Generic: Generate manual copy-paste instructions
+   *
+   * @param plugin Plugin to compile and install
+   * @returns Promise<void>
+   */
+  compilePlugin(plugin: Plugin): Promise<void>;
+
+  /**
+   * Unload (disable) a plugin for this adapter
+   *
+   * Removes plugin-specific files and restores previous state
+   *
+   * @param pluginName Name of plugin to unload
+   * @returns Promise<void>
+   */
+  unloadPlugin(pluginName: string): Promise<void>;
+
+  /**
+   * Get plugin installation status
+   *
+   * Returns information about which plugins are currently installed
+   *
+   * @returns Promise<string[]> Array of installed plugin names
+   */
+  getInstalledPlugins(): Promise<string[]>;
 }