@skillsmith/mcp-server 0.3.0 → 0.3.1

package/dist/src/middleware/quota.js

@@ -1,309 +0,0 @@
-// SPDX-License-Identifier: Elastic-2.0
-// Copyright 2024-2025 Smith Horn Group Ltd
-import { buildQuotaExceededResponse } from './errorFormatter.js';
-// ============================================================================
-// Configuration
-// ============================================================================
-/**
- * Tier quota limits (API calls per month)
- * -1 represents unlimited
- */
-const TIER_QUOTAS = {
-    community: 1_000,
-    individual: 10_000,
-    team: 100_000,
-    enterprise: -1, // Unlimited
-};
-/**
- * Configuration for the upgrade URL
- */
-const UPGRADE_URL = 'https://skillsmith.app/upgrade';
-// ============================================================================
-// In-Memory Storage (Default)
-// ============================================================================
-/**
- * Simple in-memory storage for quota tracking
- * Note: This resets on server restart. Use a database-backed storage
- * in production via the storage option.
- */
-class InMemoryQuotaStorage {
-    usage = new Map();
-    async getUsage(customerId) {
-        const now = new Date();
-        const existing = this.usage.get(customerId);
-        // If we have existing data and it's still in the current period, return it
-        if (existing && existing.periodEnd > now) {
-            return existing;
-        }
-        // Otherwise, create a new period
-        const periodStart = this.getMonthStart(now);
-        const periodEnd = this.getMonthEnd(now);
-        const newUsage = { used: 0, periodStart, periodEnd };
-        this.usage.set(customerId, newUsage);
-        return newUsage;
-    }
-    async incrementUsage(customerId, cost) {
-        const usage = await this.getUsage(customerId);
-        usage.used += cost;
-    }
-    async initializePeriod(customerId, _limit) {
-        const now = new Date();
-        this.usage.set(customerId, {
-            used: 0,
-            periodStart: this.getMonthStart(now),
-            periodEnd: this.getMonthEnd(now),
-        });
-    }
-    getMonthStart(date) {
-        return new Date(date.getFullYear(), date.getMonth(), 1);
-    }
-    getMonthEnd(date) {
-        return new Date(date.getFullYear(), date.getMonth() + 1, 1);
-    }
-}
-// ============================================================================
-// Helper Functions
-// ============================================================================
-/**
- * Get the warning level based on percentage used
- */
-function getWarningLevel(percentUsed) {
-    if (percentUsed >= 100)
-        return 100;
-    if (percentUsed >= 90)
-        return 90;
-    if (percentUsed >= 80)
-        return 80;
-    return 0;
-}
-/**
- * Get warning message based on level and current usage
- */
-function getWarningMessage(warningLevel, used, limit, _tier) {
-    if (warningLevel === 0)
-        return undefined;
-    const remaining = Math.max(0, limit - used);
-    switch (warningLevel) {
-        case 100:
-            return `API quota exceeded (${used.toLocaleString()}/${limit.toLocaleString()} calls). Upgrade to continue.`;
-        case 90:
-            return `Warning: 90% of API quota used (${remaining.toLocaleString()} calls remaining). Consider upgrading.`;
-        case 80:
-            return `Notice: 80% of API quota used (${remaining.toLocaleString()} calls remaining).`;
-        default:
-            return undefined;
-    }
-}
-/**
- * Generate a customer ID from license info
- * Falls back to 'anonymous' for community users without an organization ID
- */
-function getCustomerId(licenseInfo, providedId) {
-    if (providedId)
-        return providedId;
-    if (licenseInfo?.organizationId)
-        return licenseInfo.organizationId;
-    return 'anonymous';
-}
-// ============================================================================
-// Quota Middleware Factory
-// ============================================================================
-/**
- * Create a quota enforcement middleware
- *
- * @param options - Configuration options
- * @returns Quota middleware instance
- *
- * @example
- * ```typescript
- * import { createQuotaMiddleware } from './middleware/quota.js';
- * import { createLicenseMiddleware } from './middleware/license.js';
- *
- * const licenseMiddleware = createLicenseMiddleware();
- * const quotaMiddleware = createQuotaMiddleware();
- *
- * // In tool handler:
- * async function handleTool(toolName: string, params: unknown) {
- *   const licenseInfo = await licenseMiddleware.getLicenseInfo();
- *   const quotaResult = await quotaMiddleware.checkAndTrack(toolName, licenseInfo);
- *
- *   if (!quotaResult.allowed) {
- *     return quotaMiddleware.buildExceededResponse(quotaResult);
- *   }
- *
- *   // Execute tool...
- *   const result = await executeTool(toolName, params);
- *
- *   // Add quota metadata to response
- *   return {
- *     ...result,
- *     _meta: {
- *       ...result._meta,
- *       quota: quotaMiddleware.buildMetadata(quotaResult),
- *     },
- *   };
- * }
- * ```
- */
-export function createQuotaMiddleware(options = {}) {
-    const { defaultCost = 1, trackUnlimited = false, storage = new InMemoryQuotaStorage() } = options;
-    async function checkAndTrack(toolName, licenseInfo, customerId) {
-        const tier = licenseInfo?.tier ?? 'community';
-        const limit = TIER_QUOTAS[tier];
-        const effectiveCustomerId = getCustomerId(licenseInfo, customerId);
-        // Enterprise tier has unlimited quota
-        if (limit === -1) {
-            if (trackUnlimited) {
-                await storage.incrementUsage(effectiveCustomerId, defaultCost);
-            }
-            return {
-                allowed: true,
-                remaining: -1,
-                limit: -1,
-                percentUsed: 0,
-                warningLevel: 0,
-                resetAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000), // 30 days from now
-            };
-        }
-        // Get current usage
-        const usage = await storage.getUsage(effectiveCustomerId);
-        const currentUsed = usage.used;
-        const newUsed = currentUsed + defaultCost;
-        // Check if quota would be exceeded
-        if (newUsed > limit) {
-            const percentUsed = (currentUsed / limit) * 100;
-            return {
-                allowed: false,
-                remaining: Math.max(0, limit - currentUsed),
-                limit,
-                percentUsed,
-                warningLevel: 100,
-                resetAt: usage.periodEnd,
-                message: getWarningMessage(100, currentUsed, limit, tier),
-                upgradeUrl: `${UPGRADE_URL}?reason=quota_exceeded&tier=${tier}`,
-            };
-        }
-        // Increment usage
-        await storage.incrementUsage(effectiveCustomerId, defaultCost);
-        // Calculate warning level
-        const percentUsed = (newUsed / limit) * 100;
-        const warningLevel = getWarningLevel(percentUsed);
-        return {
-            allowed: true,
-            remaining: limit - newUsed,
-            limit,
-            percentUsed,
-            warningLevel,
-            resetAt: usage.periodEnd,
-            message: getWarningMessage(warningLevel, newUsed, limit, tier),
-            upgradeUrl: warningLevel >= 90 ? `${UPGRADE_URL}?reason=quota_warning&tier=${tier}` : undefined,
-        };
-    }
-    async function getStatus(licenseInfo, customerId) {
-        const tier = licenseInfo?.tier ?? 'community';
-        const limit = TIER_QUOTAS[tier];
-        const effectiveCustomerId = getCustomerId(licenseInfo, customerId);
-        // Enterprise tier has unlimited quota
-        if (limit === -1) {
-            return {
-                allowed: true,
-                remaining: -1,
-                limit: -1,
-                percentUsed: 0,
-                warningLevel: 0,
-                resetAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000),
-            };
-        }
-        // Get current usage without incrementing
-        const usage = await storage.getUsage(effectiveCustomerId);
-        const percentUsed = (usage.used / limit) * 100;
-        const warningLevel = getWarningLevel(percentUsed);
-        return {
-            allowed: usage.used < limit,
-            remaining: Math.max(0, limit - usage.used),
-            limit,
-            percentUsed,
-            warningLevel,
-            resetAt: usage.periodEnd,
-            message: getWarningMessage(warningLevel, usage.used, limit, tier),
-            upgradeUrl: warningLevel >= 90 ? `${UPGRADE_URL}?reason=quota_warning&tier=${tier}` : undefined,
-        };
-    }
-    function buildMetadata(result) {
-        return {
-            remaining: result.remaining,
-            limit: result.limit,
-            resetAt: result.resetAt.toISOString(),
-            warning: result.message,
-        };
-    }
-    function buildExceededResponse(result) {
-        const used = result.limit - result.remaining;
-        return buildQuotaExceededResponse('API calls', used, result.limit);
-    }
-    return {
-        checkAndTrack,
-        getStatus,
-        buildMetadata,
-        buildExceededResponse,
-    };
-}
-// ============================================================================
-// Higher-Order Function for Tool Wrapping
-// ============================================================================
-/**
- * Wrap a tool handler with quota enforcement
- *
- * @param handler - The original tool handler
- * @param licenseMiddleware - License middleware instance
- * @param quotaMiddleware - Quota middleware instance
- * @returns Wrapped handler with quota enforcement
- *
- * @example
- * ```typescript
- * const searchHandler = withQuotaEnforcement(
- *   originalSearchHandler,
- *   licenseMiddleware,
- *   quotaMiddleware
- * );
- * ```
- */
-export function withQuotaEnforcement(handler, licenseMiddleware, quotaMiddleware) {
-    return async (toolName, params) => {
-        const licenseInfo = await licenseMiddleware.getLicenseInfo();
-        const quotaResult = await quotaMiddleware.checkAndTrack(toolName, licenseInfo);
-        if (!quotaResult.allowed) {
-            return quotaMiddleware.buildExceededResponse(quotaResult);
-        }
-        // Execute the original handler
-        const result = await handler(params);
-        // Note: In a real implementation, you would add quota metadata to the result
-        // This requires knowing the result structure, which varies by tool
-        return result;
-    };
-}
-// ============================================================================
-// Utility Functions
-// ============================================================================
-/**
- * Check if a tier has unlimited quota
- */
-export function isUnlimitedTier(tier) {
-    return TIER_QUOTAS[tier] === -1;
-}
-/**
- * Get the quota limit for a tier
- */
-export function getQuotaLimit(tier) {
-    return TIER_QUOTAS[tier];
-}
-/**
- * Format quota remaining for display
- */
-export function formatQuotaRemaining(remaining, limit) {
-    if (limit === -1) {
-        return 'Unlimited';
-    }
-    return `${remaining.toLocaleString()} / ${limit.toLocaleString()}`;
-}
-//# sourceMappingURL=quota.js.map

package/dist/src/middleware/quota.js.map

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

package/dist/src/middleware/toolFeatureMapping.d.ts

@@ -1,36 +0,0 @@
-/**
- * Tool-to-Feature mapping for license validation
- *
- * Maps MCP tool names to their required feature flags.
- * null = community feature (no license required)
- * string = feature flag that must be enabled in the license
- *
- * @see SMI-1055: Add license middleware to MCP server
- * @see SMI-1091: Unified tier feature definitions across packages
- */
-/**
- * Feature flags for enterprise licensing
- *
- * This type mirrors the canonical FeatureFlag from @skillsmith/enterprise.
- * We define it locally because @skillsmith/enterprise is an optional peer
- * dependency that may not be installed for community users.
- *
- * @see packages/enterprise/src/license/FeatureFlags.ts for canonical definition
- */
-export type FeatureFlag = 'basic_analytics' | 'email_support' | 'private_skills' | 'team_workspaces' | 'usage_analytics' | 'priority_support' | 'sso_saml' | 'rbac' | 'audit_logging' | 'siem_export' | 'compliance_reports' | 'private_registry' | 'custom_integrations' | 'advanced_analytics';
-/**
- * Mapping of tool names to their required feature flags
- *
- * null = community tool (no license required)
- * FeatureFlag = requires that feature to be enabled in license
- */
-export declare const TOOL_FEATURES: Record<string, FeatureFlag | null>;
-/**
- * Human-readable names for feature flags
- */
-export declare const FEATURE_DISPLAY_NAMES: Record<FeatureFlag, string>;
-/**
- * Tier information for upgrade messaging
- */
-export declare const FEATURE_TIERS: Record<FeatureFlag, 'individual' | 'team' | 'enterprise'>;
-//# sourceMappingURL=toolFeatureMapping.d.ts.map

package/dist/src/middleware/toolFeatureMapping.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"toolFeatureMapping.d.ts","sourceRoot":"","sources":["../../../src/middleware/toolFeatureMapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAEnB,iBAAiB,GACjB,eAAe,GAEf,gBAAgB,GAChB,iBAAiB,GACjB,iBAAiB,GACjB,kBAAkB,GAElB,UAAU,GACV,MAAM,GACN,eAAe,GACf,aAAa,GACb,oBAAoB,GACpB,kBAAkB,GAElB,qBAAqB,GACrB,oBAAoB,CAAA;AAExB;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAoC5D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAmB7D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,YAAY,GAAG,MAAM,GAAG,YAAY,CAmBnF,CAAA"}

package/dist/src/middleware/toolFeatureMapping.js

@@ -1,96 +0,0 @@
-/**
- * Tool-to-Feature mapping for license validation
- *
- * Maps MCP tool names to their required feature flags.
- * null = community feature (no license required)
- * string = feature flag that must be enabled in the license
- *
- * @see SMI-1055: Add license middleware to MCP server
- * @see SMI-1091: Unified tier feature definitions across packages
- */
-/**
- * Mapping of tool names to their required feature flags
- *
- * null = community tool (no license required)
- * FeatureFlag = requires that feature to be enabled in license
- */
-export const TOOL_FEATURES = {
-    // Core tools - no feature required (null = community)
-    search: null,
-    get_skill: null,
-    install_skill: null,
-    uninstall_skill: null,
-    skill_recommend: null,
-    skill_validate: null,
-    skill_compare: null,
-    skill_suggest: null,
-    // Team tools - require team features
-    publish_private: 'private_skills',
-    team_workspace: 'team_workspaces',
-    share_skill: 'team_workspaces',
-    // Enterprise tools - require enterprise features
-    configure_sso: 'sso_saml',
-    sso_settings: 'sso_saml',
-    audit_export: 'audit_logging',
-    audit_query: 'audit_logging',
-    rbac_manage: 'rbac',
-    rbac_assign_role: 'rbac',
-    rbac_create_policy: 'rbac',
-    siem_export: 'siem_export',
-    compliance_report: 'compliance_reports',
-    private_registry_publish: 'private_registry',
-    private_registry_manage: 'private_registry',
-    // Analytics tools
-    analytics_dashboard: 'advanced_analytics',
-    usage_report: 'advanced_analytics',
-    // Integration tools
-    webhook_configure: 'custom_integrations',
-    api_key_manage: 'custom_integrations',
-};
-/**
- * Human-readable names for feature flags
- */
-export const FEATURE_DISPLAY_NAMES = {
-    // Individual tier features
-    basic_analytics: 'Basic Analytics',
-    email_support: 'Email Support',
-    // Team tier features
-    private_skills: 'Private Skills',
-    team_workspaces: 'Team Workspaces',
-    usage_analytics: 'Usage Analytics',
-    priority_support: 'Priority Support',
-    // Enterprise tier features
-    sso_saml: 'SSO/SAML Integration',
-    rbac: 'Role-Based Access Control',
-    audit_logging: 'Audit Logging',
-    siem_export: 'SIEM Export',
-    compliance_reports: 'Compliance Reports',
-    private_registry: 'Private Registry',
-    // Additional features
-    custom_integrations: 'Custom Integrations',
-    advanced_analytics: 'Advanced Analytics',
-};
-/**
- * Tier information for upgrade messaging
- */
-export const FEATURE_TIERS = {
-    // Individual tier features
-    basic_analytics: 'individual',
-    email_support: 'individual',
-    // Team tier features
-    private_skills: 'team',
-    team_workspaces: 'team',
-    usage_analytics: 'team',
-    priority_support: 'team',
-    // Enterprise tier features
-    sso_saml: 'enterprise',
-    rbac: 'enterprise',
-    audit_logging: 'enterprise',
-    siem_export: 'enterprise',
-    compliance_reports: 'enterprise',
-    private_registry: 'enterprise',
-    // Additional features
-    custom_integrations: 'enterprise',
-    advanced_analytics: 'enterprise',
-};
-//# sourceMappingURL=toolFeatureMapping.js.map

package/dist/src/middleware/toolFeatureMapping.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"toolFeatureMapping.js","sourceRoot":"","sources":["../../../src/middleware/toolFeatureMapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA+BH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAuC;IAC/D,sDAAsD;IACtD,MAAM,EAAE,IAAI;IACZ,SAAS,EAAE,IAAI;IACf,aAAa,EAAE,IAAI;IACnB,eAAe,EAAE,IAAI;IACrB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,IAAI;IAEnB,qCAAqC;IACrC,eAAe,EAAE,gBAAgB;IACjC,cAAc,EAAE,iBAAiB;IACjC,WAAW,EAAE,iBAAiB;IAE9B,iDAAiD;IACjD,aAAa,EAAE,UAAU;IACzB,YAAY,EAAE,UAAU;IACxB,YAAY,EAAE,eAAe;IAC7B,WAAW,EAAE,eAAe;IAC5B,WAAW,EAAE,MAAM;IACnB,gBAAgB,EAAE,MAAM;IACxB,kBAAkB,EAAE,MAAM;IAC1B,WAAW,EAAE,aAAa;IAC1B,iBAAiB,EAAE,oBAAoB;IACvC,wBAAwB,EAAE,kBAAkB;IAC5C,uBAAuB,EAAE,kBAAkB;IAE3C,kBAAkB;IAClB,mBAAmB,EAAE,oBAAoB;IACzC,YAAY,EAAE,oBAAoB;IAElC,oBAAoB;IACpB,iBAAiB,EAAE,qBAAqB;IACxC,cAAc,EAAE,qBAAqB;CACtC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAgC;IAChE,2BAA2B;IAC3B,eAAe,EAAE,iBAAiB;IAClC,aAAa,EAAE,eAAe;IAC9B,qBAAqB;IACrB,cAAc,EAAE,gBAAgB;IAChC,eAAe,EAAE,iBAAiB;IAClC,eAAe,EAAE,iBAAiB;IAClC,gBAAgB,EAAE,kBAAkB;IACpC,2BAA2B;IAC3B,QAAQ,EAAE,sBAAsB;IAChC,IAAI,EAAE,2BAA2B;IACjC,aAAa,EAAE,eAAe;IAC9B,WAAW,EAAE,aAAa;IAC1B,kBAAkB,EAAE,oBAAoB;IACxC,gBAAgB,EAAE,kBAAkB;IACpC,sBAAsB;IACtB,mBAAmB,EAAE,qBAAqB;IAC1C,kBAAkB,EAAE,oBAAoB;CACzC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAA8D;IACtF,2BAA2B;IAC3B,eAAe,EAAE,YAAY;IAC7B,aAAa,EAAE,YAAY;IAC3B,qBAAqB;IACrB,cAAc,EAAE,MAAM;IACtB,eAAe,EAAE,MAAM;IACvB,eAAe,EAAE,MAAM;IACvB,gBAAgB,EAAE,MAAM;IACxB,2BAA2B;IAC3B,QAAQ,EAAE,YAAY;IACtB,IAAI,EAAE,YAAY;IAClB,aAAa,EAAE,YAAY;IAC3B,WAAW,EAAE,YAAY;IACzB,kBAAkB,EAAE,YAAY;IAChC,gBAAgB,EAAE,YAAY;IAC9B,sBAAsB;IACtB,mBAAmB,EAAE,YAAY;IACjC,kBAAkB,EAAE,YAAY;CACjC,CAAA"}

package/dist/src/onboarding/first-run.d.ts

@@ -1,65 +0,0 @@
-/**
- * SMI-911: First Run Detection and Tier 1 Skill Auto-Installation
- *
- * Detects first run of Skillsmith MCP server and provides:
- * - First run detection via marker file
- * - Tier 1 skills list for auto-installation
- * - Welcome message formatting
- *
- * Tier 1 skills (from research doc):
- * - varlock (score: 95) - Security foundation
- * - commit (score: 92) - Git workflow
- * - governance (score: 88) - Code quality
- * - skill-builder (score: 90) - Custom skill creation
- */
-/**
- * Skillsmith configuration directory
- */
-export declare const SKILLSMITH_DIR: string;
-/**
- * Marker file indicating first run is complete
- */
-export declare const FIRST_RUN_MARKER: string;
-/**
- * Tier 1 skill definition
- */
-export interface Tier1Skill {
-    /** Full skill ID (e.g., 'anthropic/varlock') */
-    id: string;
-    /** Short name for display */
-    name: string;
-    /** Quality score from research (0-100) */
-    score: number;
-}
-/**
- * Tier 1 skills to auto-install on first run
- *
- * These are the highest-value, lowest-friction skills identified
- * in the skill prioritization research.
- */
-export declare const TIER1_SKILLS: readonly Tier1Skill[];
-/**
- * Check if this is the first run of Skillsmith
- *
- * First run is detected by the absence of the marker file
- * at ~/.skillsmith/.first-run-complete
- *
- * @returns true if this is the first run, false otherwise
- */
-export declare function isFirstRun(): boolean;
-/**
- * Mark first run as complete
- *
- * Creates the marker file at ~/.skillsmith/.first-run-complete
- * with the current timestamp. Also ensures the .skillsmith
- * directory exists.
- */
-export declare function markFirstRunComplete(): void;
-/**
- * Generate welcome message after first run setup
- *
- * @param installedSkills - List of skill names that were installed
- * @returns Formatted welcome message
- */
-export declare function getWelcomeMessage(installedSkills: string[]): string;
-//# sourceMappingURL=first-run.d.ts.map

package/dist/src/onboarding/first-run.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"first-run.d.ts","sourceRoot":"","sources":["../../../src/onboarding/first-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH;;GAEG;AACH,eAAO,MAAM,cAAc,QAAiC,CAAA;AAE5D;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAA8C,CAAA;AAE3E;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAA;IACV,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAKpC,CAAA;AAEV;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,MAAM,CAWnE"}

package/dist/src/onboarding/first-run.js

@@ -1,79 +0,0 @@
-/**
- * SMI-911: First Run Detection and Tier 1 Skill Auto-Installation
- *
- * Detects first run of Skillsmith MCP server and provides:
- * - First run detection via marker file
- * - Tier 1 skills list for auto-installation
- * - Welcome message formatting
- *
- * Tier 1 skills (from research doc):
- * - varlock (score: 95) - Security foundation
- * - commit (score: 92) - Git workflow
- * - governance (score: 88) - Code quality
- * - skill-builder (score: 90) - Custom skill creation
- */
-import { existsSync, mkdirSync, writeFileSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
-/**
- * Skillsmith configuration directory
- */
-export const SKILLSMITH_DIR = join(homedir(), '.skillsmith');
-/**
- * Marker file indicating first run is complete
- */
-export const FIRST_RUN_MARKER = join(SKILLSMITH_DIR, '.first-run-complete');
-/**
- * Tier 1 skills to auto-install on first run
- *
- * These are the highest-value, lowest-friction skills identified
- * in the skill prioritization research.
- */
-export const TIER1_SKILLS = [
-    { id: 'anthropic/varlock', name: 'varlock', score: 95 },
-    { id: 'anthropic/commit', name: 'commit', score: 92 },
-    { id: 'anthropic/skill-builder', name: 'skill-builder', score: 90 },
-    { id: 'anthropic/governance', name: 'governance', score: 88 },
-];
-/**
- * Check if this is the first run of Skillsmith
- *
- * First run is detected by the absence of the marker file
- * at ~/.skillsmith/.first-run-complete
- *
- * @returns true if this is the first run, false otherwise
- */
-export function isFirstRun() {
-    return !existsSync(FIRST_RUN_MARKER);
-}
-/**
- * Mark first run as complete
- *
- * Creates the marker file at ~/.skillsmith/.first-run-complete
- * with the current timestamp. Also ensures the .skillsmith
- * directory exists.
- */
-export function markFirstRunComplete() {
-    if (!existsSync(SKILLSMITH_DIR)) {
-        mkdirSync(SKILLSMITH_DIR, { recursive: true });
-    }
-    writeFileSync(FIRST_RUN_MARKER, new Date().toISOString());
-}
-/**
- * Generate welcome message after first run setup
- *
- * @param installedSkills - List of skill names that were installed
- * @returns Formatted welcome message
- */
-export function getWelcomeMessage(installedSkills) {
-    const skillList = installedSkills.map((s) => `  - ${s}`).join('\n');
-    return `
-Welcome to Skillsmith!
-
-Essential skills installed:
-${skillList}
-
-Try: "Write a commit message" to see the commit skill in action.
-`.trim();
-}
-//# sourceMappingURL=first-run.js.map

package/dist/src/onboarding/first-run.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"first-run.js","sourceRoot":"","sources":["../../../src/onboarding/first-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAA;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAA;AAE5B;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAA;AAE5D;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,cAAc,EAAE,qBAAqB,CAAC,CAAA;AAc3E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,EAAE,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;IACvD,EAAE,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;IACrD,EAAE,EAAE,EAAE,yBAAyB,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,EAAE;IACnE,EAAE,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,EAAE;CACrD,CAAA;AAEV;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAChC,SAAS,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAChD,CAAC;IACD,aAAa,CAAC,gBAAgB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,eAAyB;IACzD,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEnE,OAAO;;;;EAIP,SAAS;;;CAGV,CAAC,IAAI,EAAE,CAAA;AACR,CAAC"}

package/dist/src/onboarding/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * SMI-911: Onboarding Module
- *
- * Exports first-run detection and Tier 1 skill auto-installation functionality.
- */
-export { SKILLSMITH_DIR, FIRST_RUN_MARKER, TIER1_SKILLS, isFirstRun, markFirstRunComplete, getWelcomeMessage, type Tier1Skill, } from './first-run.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/src/onboarding/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/onboarding/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAA"}

package/dist/src/onboarding/index.js

@@ -1,7 +0,0 @@
-/**
- * SMI-911: Onboarding Module
- *
- * Exports first-run detection and Tier 1 skill auto-installation functionality.
- */
-export { SKILLSMITH_DIR, FIRST_RUN_MARKER, TIER1_SKILLS, isFirstRun, markFirstRunComplete, getWelcomeMessage, } from './first-run.js';
-//# sourceMappingURL=index.js.map

package/dist/src/onboarding/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/onboarding/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,iBAAiB,GAElB,MAAM,gBAAgB,CAAA"}

package/dist/src/onboarding/install-assets.d.ts

@@ -1,27 +0,0 @@
-/**
- * SMI-XXXX: Install Bundled Assets on First Run
- *
- * Installs the skillsmith skill and user documentation
- * from the npm package's bundled assets.
- */
-/**
- * Install bundled skills from package assets
- *
- * Copies skills from src/assets/skills/ to ~/.claude/skills/
- *
- * @returns Array of installed skill names
- */
-export declare function installBundledSkills(): string[];
-/**
- * Install user documentation to ~/.skillsmith/docs/
- *
- * @returns true if docs were installed, false otherwise
- */
-export declare function installUserDocs(): boolean;
-/**
- * Get path to user guide for --docs flag
- *
- * @returns Path to USER_GUIDE.md if it exists, undefined otherwise
- */
-export declare function getUserGuidePath(): string | undefined;
-//# sourceMappingURL=install-assets.d.ts.map