specweave 2.3.0 → 3.0.1

package/dist/src/utils/env-manager.d.ts

@@ -1,86 +0,0 @@
-/**
- * .env File Management Utilities
- *
- * Atomic updates, backup management, and project list merging
- *
- * NEW (v0.24.0): Supports import command .env updates
- *
- * @module utils/env-manager
- */
-import type { Logger } from './logger.js';
-export interface EnvUpdateOptions {
-    key: string;
-    value: string;
-    projectRoot: string;
-    logger?: Logger;
-    createBackup?: boolean;
-}
-export interface EnvMergeOptions {
-    key: string;
-    newValues: string[];
-    projectRoot: string;
-    logger?: Logger;
-    createBackup?: boolean;
-}
-/**
- * Parse .env file content into key-value pairs
- */
-export declare function parseEnvContent(content: string): Map<string, string>;
-/**
- * Serialize env map to .env file format
- */
-export declare function serializeEnvContent(envMap: Map<string, string>): string;
-/**
- * Update single key in .env file (atomic write with backup)
- *
- * TC-075: Atomic .env Update
- *
- * @param options - Update options
- */
-export declare function updateEnvFile(options: EnvUpdateOptions): Promise<void>;
-/**
- * Merge new values with existing comma-separated list (no duplicates)
- *
- * TC-076: Merge Project Lists (No Duplicates)
- *
- * Example:
- * - Existing: JIRA_PROJECTS=BACKEND,FRONTEND
- * - New: [MOBILE, INFRA, BACKEND]
- * - Result: JIRA_PROJECTS=BACKEND,FRONTEND,MOBILE,INFRA
- *
- * @param options - Merge options
- */
-export declare function mergeEnvList(options: EnvMergeOptions): Promise<void>;
-/**
- * Merge two project lists without duplicates
- *
- * Preserves existing order, appends new projects
- *
- * @param existing - Existing project list
- * @param newProjects - New projects to add
- * @returns Merged list without duplicates
- */
-export declare function mergeProjectList(existing: string[], newProjects: string[]): string[];
-/**
- * Get value from .env file
- *
- * @param projectRoot - Project root path
- * @param key - Environment variable key
- * @returns Value or null if not found
- */
-export declare function getEnvValue(projectRoot: string, key: string): Promise<string | null>;
-/**
- * Check if .env file exists
- *
- * @param projectRoot - Project root path
- * @returns True if .env exists
- */
-export declare function envFileExists(projectRoot: string): boolean;
-/**
- * Restore .env from backup
- *
- * @param projectRoot - Project root path
- * @param logger - Logger instance
- */
-export declare function restoreEnvBackup(projectRoot: string, logger?: Logger): Promise<void>;
-//# sourceMappingURL=env-manager.d.ts.map

package/dist/src/utils/env-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"env-manager.d.ts","sourceRoot":"","sources":["../../../src/utils/env-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBpE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAQvE;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyC5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAapF;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAU1F;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUzG"}

package/dist/src/utils/env-manager.js

@@ -1,188 +0,0 @@
-/**
- * .env File Management Utilities
- *
- * Atomic updates, backup management, and project list merging
- *
- * NEW (v0.24.0): Supports import command .env updates
- *
- * @module utils/env-manager
- */
-import { promises as fs } from 'fs';
-import { existsSync } from 'fs';
-import path from 'path';
-import { consoleLogger } from './logger.js';
-/**
- * Parse .env file content into key-value pairs
- */
-export function parseEnvContent(content) {
-    const envMap = new Map();
-    const lines = content.split('\n');
-    for (const line of lines) {
-        const trimmed = line.trim();
-        // Skip comments and empty lines
-        if (trimmed.startsWith('#') || trimmed === '') {
-            continue;
-        }
-        // Parse KEY=VALUE
-        const match = trimmed.match(/^([^=]+)=(.*)$/);
-        if (match) {
-            const key = match[1].trim();
-            const value = match[2].trim();
-            envMap.set(key, value);
-        }
-    }
-    return envMap;
-}
-/**
- * Serialize env map to .env file format
- */
-export function serializeEnvContent(envMap) {
-    const lines = [];
-    for (const [key, value] of envMap.entries()) {
-        lines.push(`${key}=${value}`);
-    }
-    return lines.join('\n') + '\n';
-}
-/**
- * Update single key in .env file (atomic write with backup)
- *
- * TC-075: Atomic .env Update
- *
- * @param options - Update options
- */
-export async function updateEnvFile(options) {
-    const { key, value, projectRoot, logger = consoleLogger, createBackup = true } = options;
-    const envPath = path.join(projectRoot, '.env');
-    const tempPath = path.join(projectRoot, '.env.tmp');
-    const backupPath = path.join(projectRoot, '.env.backup');
-    try {
-        // Step 1: Read existing .env content
-        let existingContent = '';
-        if (existsSync(envPath)) {
-            existingContent = await fs.readFile(envPath, 'utf-8');
-        }
-        // Step 2: Parse and update
-        const envMap = parseEnvContent(existingContent);
-        envMap.set(key, value);
-        // Step 3: Serialize
-        const newContent = serializeEnvContent(envMap);
-        // Step 4: Write to temp file (atomic write step 1)
-        await fs.writeFile(tempPath, newContent, 'utf-8');
-        // Step 5: Backup existing .env (if exists)
-        if (createBackup && existsSync(envPath)) {
-            await fs.copyFile(envPath, backupPath);
-            logger.log(`Created backup: .env.backup`);
-        }
-        // Step 6: Atomic rename (atomic write step 2)
-        await fs.rename(tempPath, envPath);
-        logger.log(`Updated .env: ${key}=${value}`);
-    }
-    catch (error) {
-        // Cleanup temp file on error
-        if (existsSync(tempPath)) {
-            await fs.unlink(tempPath);
-        }
-        throw new Error(`Failed to update .env file: ${error.message}`);
-    }
-}
-/**
- * Merge new values with existing comma-separated list (no duplicates)
- *
- * TC-076: Merge Project Lists (No Duplicates)
- *
- * Example:
- * - Existing: JIRA_PROJECTS=BACKEND,FRONTEND
- * - New: [MOBILE, INFRA, BACKEND]
- * - Result: JIRA_PROJECTS=BACKEND,FRONTEND,MOBILE,INFRA
- *
- * @param options - Merge options
- */
-export async function mergeEnvList(options) {
-    const { key, newValues, projectRoot, logger = consoleLogger, createBackup = true } = options;
-    const envPath = path.join(projectRoot, '.env');
-    // Step 1: Read existing value
-    let existingValues = [];
-    if (existsSync(envPath)) {
-        const content = await fs.readFile(envPath, 'utf-8');
-        const envMap = parseEnvContent(content);
-        const existingValue = envMap.get(key);
-        if (existingValue) {
-            existingValues = existingValue.split(',').map(v => v.trim()).filter(v => v.length > 0);
-        }
-    }
-    // Step 2: Merge (no duplicates)
-    const merged = mergeProjectList(existingValues, newValues);
-    // Step 3: Update .env
-    const mergedValue = merged.join(',');
-    await updateEnvFile({
-        key,
-        value: mergedValue,
-        projectRoot,
-        logger,
-        createBackup
-    });
-    logger.log(`Merged ${newValues.length} new value(s) into ${key}`);
-    logger.log(`Total: ${merged.length} unique value(s)`);
-}
-/**
- * Merge two project lists without duplicates
- *
- * Preserves existing order, appends new projects
- *
- * @param existing - Existing project list
- * @param newProjects - New projects to add
- * @returns Merged list without duplicates
- */
-export function mergeProjectList(existing, newProjects) {
-    const merged = [...existing];
-    const existingSet = new Set(existing.map(p => p.toLowerCase()));
-    for (const project of newProjects) {
-        // Case-insensitive duplicate check
-        if (!existingSet.has(project.toLowerCase())) {
-            merged.push(project);
-            existingSet.add(project.toLowerCase());
-        }
-    }
-    return merged;
-}
-/**
- * Get value from .env file
- *
- * @param projectRoot - Project root path
- * @param key - Environment variable key
- * @returns Value or null if not found
- */
-export async function getEnvValue(projectRoot, key) {
-    const envPath = path.join(projectRoot, '.env');
-    if (!existsSync(envPath)) {
-        return null;
-    }
-    const content = await fs.readFile(envPath, 'utf-8');
-    const envMap = parseEnvContent(content);
-    return envMap.get(key) || null;
-}
-/**
- * Check if .env file exists
- *
- * @param projectRoot - Project root path
- * @returns True if .env exists
- */
-export function envFileExists(projectRoot) {
-    return existsSync(path.join(projectRoot, '.env'));
-}
-/**
- * Restore .env from backup
- *
- * @param projectRoot - Project root path
- * @param logger - Logger instance
- */
-export async function restoreEnvBackup(projectRoot, logger = consoleLogger) {
-    const envPath = path.join(projectRoot, '.env');
-    const backupPath = path.join(projectRoot, '.env.backup');
-    if (!existsSync(backupPath)) {
-        throw new Error('No .env.backup file found');
-    }
-    await fs.copyFile(backupPath, envPath);
-    logger.log('Restored .env from backup');
-}
-//# sourceMappingURL=env-manager.js.map

package/dist/src/utils/env-manager.js.map

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

package/dist/src/utils/error-formatter.d.ts

@@ -1,82 +0,0 @@
-/**
- * Error Message Formatter
- *
- * Provides consistent error formatting across SpecWeave commands.
- * All error messages follow the same structure with emoji indicators,
- * clear descriptions, and actionable next steps.
- *
- * @module utils/error-formatter
- * @version 1.0.102
- */
-/**
- * Error severity levels
- */
-export type ErrorSeverity = 'error' | 'warning' | 'info';
-/**
- * Formatted error message structure
- */
-export interface FormattedError {
-    /** Error title */
-    title: string;
-    /** Error description */
-    description: string;
-    /** Suggested next steps (optional) */
-    suggestions?: string[];
-    /** Related commands (optional) */
-    relatedCommands?: string[];
-    /** Example of correct usage (optional) */
-    example?: string;
-}
-/**
- * Common error scenarios with formatted messages
- */
-export declare const ERROR_MESSAGES: {
-    INCREMENT_NOT_FOUND: (id: string) => FormattedError;
-    SPEC_NOT_FOUND: (incrementId: string) => FormattedError;
-    WRONG_COMMAND_FOR_NEW_INCREMENT: () => FormattedError;
-    WRONG_COMMAND_FOR_EXISTING_INCREMENT: (incrementId: string) => FormattedError;
-    INTERNAL_SKILL_DIRECT_CALL: (skillName: string, allowedCallers: string[]) => FormattedError;
-    INVALID_INCREMENT_NUMBER: (provided: string, expected: string) => FormattedError;
-    DUPLICATE_INCREMENT: (id: string) => FormattedError;
-    INVALID_STATUS_TRANSITION: (from: string, to: string) => FormattedError;
-    INCREMENT_NOT_READY: (incrementId: string, reason: string) => FormattedError;
-    MISSING_REQUIRED_ARG: (argName: string, command: string) => FormattedError;
-};
-/**
- * Formats and logs an error message with consistent styling
- *
- * @param error - Formatted error object
- * @param severity - Error severity level (default: 'error')
- *
- * @example
- * ```typescript
- * formatError(ERROR_MESSAGES.INCREMENT_NOT_FOUND('0042'));
- * ```
- */
-export declare function formatError(error: FormattedError, severity?: ErrorSeverity): void;
-/**
- * Quick helper to format and throw an error
- *
- * @param error - Formatted error object
- * @throws Error with formatted message
- *
- * @example
- * ```typescript
- * throwFormattedError(ERROR_MESSAGES.INCREMENT_NOT_FOUND('0042'));
- * ```
- */
-export declare function throwFormattedError(error: FormattedError): never;
-/**
- * Format a simple error message (for custom errors not in ERROR_MESSAGES)
- *
- * @param title - Error title
- * @param description - Error description
- * @param suggestions - Optional suggestions
- *
- * @example
- * ```typescript
- * formatSimpleError('File not found', 'The file does not exist', ['Check the path']);
- * ```
- */
-export declare function formatSimpleError(title: string, description: string, suggestions?: string[]): void;
-//# sourceMappingURL=error-formatter.d.ts.map

package/dist/src/utils/error-formatter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-formatter.d.ts","sourceRoot":"","sources":["../../../src/utils/error-formatter.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,kCAAkC;IAClC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;8BAEC,MAAM,KAAG,cAAc;kCAWnB,MAAM,KAAG,cAAc;2CAWhB,cAAc;wDAWC,MAAM,KAAG,cAAc;4CAUnC,MAAM,kBAAkB,MAAM,EAAE,KAAG,cAAc;yCAWpD,MAAM,YAAY,MAAM,KAAG,cAAc;8BASpD,MAAM,KAAG,cAAc;sCAYf,MAAM,MAAM,MAAM,KAAG,cAAc;uCAUlC,MAAM,UAAU,MAAM,KAAG,cAAc;oCAY1C,MAAM,WAAW,MAAM,KAAG,cAAc;CAQzE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,GAAE,aAAuB,GAAG,IAAI,CAsC1F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,GAAG,KAAK,CAGhE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,IAAI,CAMN"}

package/dist/src/utils/error-formatter.js

@@ -1,183 +0,0 @@
-import { consoleLogger } from './logger.js';
-/**
- * Common error scenarios with formatted messages
- */
-export const ERROR_MESSAGES = {
-    // Increment errors
-    INCREMENT_NOT_FOUND: (id) => ({
-        title: `Increment '${id}' not found`,
-        description: `The increment directory does not exist or ID format is invalid.`,
-        suggestions: [
-            `Check if increment exists: ls .specweave/increments/ | grep "${id}"`,
-            `Use 4-digit format: 0001, 0042, 0157 (not 1, 42, 157)`,
-            `Create new increment: sw:increment "description"`
-        ],
-        relatedCommands: ['sw:status', 'sw:increment']
-    }),
-    SPEC_NOT_FOUND: (incrementId) => ({
-        title: 'spec.md not found',
-        description: `Increment '${incrementId}' exists but has no spec.md file.`,
-        suggestions: [
-            `Create spec.md using: sw:increment (for new increments)`,
-            `Or manually create: .specweave/increments/${incrementId}/spec.md`
-        ],
-        relatedCommands: ['sw:increment']
-    }),
-    // Skill routing errors
-    WRONG_COMMAND_FOR_NEW_INCREMENT: () => ({
-        title: 'sw:plan is for EXISTING increments only',
-        description: 'You are trying to plan a new increment. Use sw:increment instead.',
-        suggestions: [
-            `sw:increment creates NEW increments from scratch`,
-            `sw:plan generates plan.md for EXISTING increments (with spec.md)`
-        ],
-        relatedCommands: ['sw:increment'],
-        example: `sw:increment "Add user authentication"`
-    }),
-    WRONG_COMMAND_FOR_EXISTING_INCREMENT: (incrementId) => ({
-        title: 'sw:increment is for NEW increments',
-        description: `Increment '${incrementId}' already exists. Use sw:plan to generate plan.md.`,
-        suggestions: [
-            `sw:plan ${incrementId} - Generate plan.md and tasks.md`,
-            `sw:do ${incrementId} - Start implementation`
-        ],
-        relatedCommands: ['sw:plan', 'sw:do']
-    }),
-    INTERNAL_SKILL_DIRECT_CALL: (skillName, allowedCallers) => ({
-        title: `Cannot call internal skill '${skillName}' directly`,
-        description: `This skill is internal-only and can only be invoked by specific commands.`,
-        suggestions: [
-            `Use one of these commands instead:`,
-            ...allowedCallers.map(cmd => `  • ${cmd}`)
-        ],
-        relatedCommands: allowedCallers
-    }),
-    // Validation errors
-    INVALID_INCREMENT_NUMBER: (provided, expected) => ({
-        title: 'Invalid increment number format',
-        description: `Increment numbers must be 4 digits (e.g., ${expected}).`,
-        suggestions: [
-            `Use ${expected} for the next sequential increment`,
-            `Format: 0001, 0042, 0157 (leading zeros required)`
-        ]
-    }),
-    DUPLICATE_INCREMENT: (id) => ({
-        title: `Increment '${id}' already exists`,
-        description: `An increment with this number already exists.`,
-        suggestions: [
-            `Check existing: sw:status`,
-            `Use next available number`,
-            `Or specify different name: ${id}-alternative`
-        ],
-        relatedCommands: ['sw:status', 'sw:fix-duplicates']
-    }),
-    // Status errors
-    INVALID_STATUS_TRANSITION: (from, to) => ({
-        title: `Cannot transition from '${from}' to '${to}'`,
-        description: `This status transition is not allowed by the workflow.`,
-        suggestions: [
-            `Valid transitions from ${from}:`,
-            `Check sw:workflow for status transition rules`
-        ],
-        relatedCommands: ['sw:workflow', 'sw:status']
-    }),
-    INCREMENT_NOT_READY: (incrementId, reason) => ({
-        title: `Increment '${incrementId}' is not ready`,
-        description: reason,
-        suggestions: [
-            `Check status: sw:status ${incrementId}`,
-            `View tasks: cat .specweave/increments/${incrementId}/tasks.md`,
-            `Validate: sw:validate ${incrementId}`
-        ],
-        relatedCommands: ['sw:status', 'sw:validate']
-    }),
-    // General errors
-    MISSING_REQUIRED_ARG: (argName, command) => ({
-        title: `Missing required argument: ${argName}`,
-        description: `This argument is required but was not provided.`,
-        suggestions: [
-            `Usage: ${command} <${argName}>`,
-            `Run '${command} --help' for more information`
-        ]
-    })
-};
-/**
- * Formats and logs an error message with consistent styling
- *
- * @param error - Formatted error object
- * @param severity - Error severity level (default: 'error')
- *
- * @example
- * ```typescript
- * formatError(ERROR_MESSAGES.INCREMENT_NOT_FOUND('0042'));
- * ```
- */
-export function formatError(error, severity = 'error') {
-    const icon = severity === 'error' ? '❌' : severity === 'warning' ? '⚠️' : 'ℹ️';
-    const logFn = severity === 'error' ? consoleLogger.error : severity === 'warning' ? consoleLogger.warn : consoleLogger.info;
-    // Title
-    logFn(`${icon} ${error.title}`);
-    logFn('');
-    // Description
-    if (error.description) {
-        logFn(error.description);
-        logFn('');
-    }
-    // Suggestions
-    if (error.suggestions && error.suggestions.length > 0) {
-        logFn('💡 Suggestions:');
-        error.suggestions.forEach(suggestion => {
-            logFn(`   ${suggestion}`);
-        });
-        logFn('');
-    }
-    // Related commands
-    if (error.relatedCommands && error.relatedCommands.length > 0) {
-        logFn('📚 Related commands:');
-        error.relatedCommands.forEach(cmd => {
-            logFn(`   ${cmd}`);
-        });
-        logFn('');
-    }
-    // Example
-    if (error.example) {
-        logFn('📝 Example:');
-        logFn(`   ${error.example}`);
-        logFn('');
-    }
-}
-/**
- * Quick helper to format and throw an error
- *
- * @param error - Formatted error object
- * @throws Error with formatted message
- *
- * @example
- * ```typescript
- * throwFormattedError(ERROR_MESSAGES.INCREMENT_NOT_FOUND('0042'));
- * ```
- */
-export function throwFormattedError(error) {
-    formatError(error, 'error');
-    throw new Error(error.title);
-}
-/**
- * Format a simple error message (for custom errors not in ERROR_MESSAGES)
- *
- * @param title - Error title
- * @param description - Error description
- * @param suggestions - Optional suggestions
- *
- * @example
- * ```typescript
- * formatSimpleError('File not found', 'The file does not exist', ['Check the path']);
- * ```
- */
-export function formatSimpleError(title, description, suggestions) {
-    formatError({
-        title,
-        description,
-        suggestions
-    });
-}
-//# sourceMappingURL=error-formatter.js.map

package/dist/src/utils/error-formatter.js.map

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

package/dist/src/utils/generate-skills-index.d.ts

@@ -1,29 +0,0 @@
-/**
- * Skills Index Generator
- *
- * @deprecated SKILLS-INDEX.md is no longer used. Skills are discovered via
- * SKILL.md frontmatter directly (each skill has name + description with
- * activation keywords). This file is kept for potential CI/CD use but is
- * not part of the active workflow.
- *
- * Generates SKILLS-INDEX.md from all SKILL.md files
- * Simulates Claude Code's progressive disclosure for non-native tools
- *
- * This allows GitHub Copilot, Cursor, and other AI tools to:
- * 1. Quickly scan all available skills (single file read)
- * 2. Match user requests to activation keywords
- * 3. Load full SKILL.md only when relevant
- * 4. Follow skill workflows for consistent output
- *
- * Usage:
- *   import { generateSkillsIndex } from './generate-skills-index.js';
- *   await generateSkillsIndex();
- *
- * Or run directly:
- *   npx ts-node src/utils/generate-skills-index.ts
- */
-/**
- * Main function: Generate skills index
- */
-export declare function generateSkillsIndex(outputPath?: string): Promise<void>;
-//# sourceMappingURL=generate-skills-index.d.ts.map

package/dist/src/utils/generate-skills-index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"generate-skills-index.d.ts","sourceRoot":"","sources":["../../../src/utils/generate-skills-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAqYH;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsD5E"}