sdd-mcp-server 2.2.1 → 3.0.1

package/dist/rules/RulesManager.d.ts

@@ -0,0 +1,53 @@
+import { BaseManager, ComponentDescriptor } from '../shared/BaseManager.js';
+/**
+ * Descriptor for a rule component
+ */
+export interface RuleDescriptor extends ComponentDescriptor {
+    /** Rule name */
+    name: string;
+    /** Brief description of the rule */
+    description: string;
+    /** Path to the rule file */
+    path: string;
+    /** Execution priority (higher = first) */
+    priority: number;
+    /** Whether rule is always applied */
+    alwaysActive: boolean;
+}
+/**
+ * Manages rule components - discovery, listing, and installation
+ *
+ * Rules are always-active guidelines that apply across all AI interactions.
+ * They define coding standards, security requirements, testing practices, etc.
+ *
+ * @example
+ * ```typescript
+ * const manager = new RulesManager('/path/to/rules');
+ * const rules = await manager.listComponents();
+ * await manager.installComponents('/project/.claude/rules');
+ * ```
+ */
+export declare class RulesManager extends BaseManager<RuleDescriptor> {
+    /**
+     * Create a new RulesManager
+     * @param rulesPath - Path to the rules directory
+     */
+    constructor(rulesPath: string);
+    /**
+     * Parse metadata from rule file content
+     * @param content - Raw content of the rule file
+     * @param filePath - Path to the rule file
+     * @returns Parsed rule descriptor
+     */
+    protected parseMetadata(content: string, filePath: string): RuleDescriptor;
+    /**
+     * Get rules sorted by priority (highest first)
+     * @returns Array of rule descriptors sorted by priority
+     */
+    listByPriority(): Promise<RuleDescriptor[]>;
+    /**
+     * Get only active rules
+     * @returns Array of rule descriptors that are always active
+     */
+    listActiveRules(): Promise<RuleDescriptor[]>;
+}

package/dist/rules/RulesManager.js

@@ -0,0 +1,62 @@
+import * as path from 'path';
+import { BaseManager } from '../shared/BaseManager.js';
+/**
+ * Manages rule components - discovery, listing, and installation
+ *
+ * Rules are always-active guidelines that apply across all AI interactions.
+ * They define coding standards, security requirements, testing practices, etc.
+ *
+ * @example
+ * ```typescript
+ * const manager = new RulesManager('/path/to/rules');
+ * const rules = await manager.listComponents();
+ * await manager.installComponents('/project/.claude/rules');
+ * ```
+ */
+export class RulesManager extends BaseManager {
+    /**
+     * Create a new RulesManager
+     * @param rulesPath - Path to the rules directory
+     */
+    constructor(rulesPath) {
+        super({
+            componentPath: rulesPath,
+            structureType: 'file',
+            fileExtension: '.md',
+        });
+    }
+    /**
+     * Parse metadata from rule file content
+     * @param content - Raw content of the rule file
+     * @param filePath - Path to the rule file
+     * @returns Parsed rule descriptor
+     */
+    parseMetadata(content, filePath) {
+        const metadata = this.parseYamlFrontmatter(content);
+        const fileName = path.basename(filePath, this.config.fileExtension);
+        return {
+            name: metadata.name || fileName,
+            description: metadata.description || '',
+            path: filePath,
+            priority: typeof metadata.priority === 'number' ? metadata.priority : 0,
+            alwaysActive: metadata.alwaysActive !== false, // Default to true
+        };
+    }
+    /**
+     * Get rules sorted by priority (highest first)
+     * @returns Array of rule descriptors sorted by priority
+     */
+    async listByPriority() {
+        const rules = await this.listComponents();
+        return rules.sort((a, b) => b.priority - a.priority);
+    }
+    /**
+     * Get only active rules
+     * @returns Array of rule descriptors that are always active
+     */
+    async listActiveRules() {
+        const rules = await this.listComponents();
+        return rules.filter(rule => rule.alwaysActive);
+    }
+}
+//# sourceMappingURL=RulesManager.js.map

package/dist/rules/RulesManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RulesManager.js","sourceRoot":"","sources":["../../src/rules/RulesManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAsC,MAAM,0BAA0B,CAAC;AAkB3F;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,YAAa,SAAQ,WAA2B;IAC3D;;;OAGG;IACH,YAAY,SAAiB;QAC3B,KAAK,CAAC;YACJ,aAAa,EAAE,SAAS;YACxB,aAAa,EAAE,MAAM;YACrB,aAAa,EAAE,KAAK;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACO,aAAa,CAAC,OAAe,EAAE,QAAgB;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAEpE,OAAO;YACL,IAAI,EAAG,QAAQ,CAAC,IAAe,IAAI,QAAQ;YAC3C,WAAW,EAAG,QAAQ,CAAC,WAAsB,IAAI,EAAE;YACnD,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,OAAO,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACvE,YAAY,EAAE,QAAQ,CAAC,YAAY,KAAK,KAAK,EAAE,kBAAkB;SAClE,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc;QAClB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACvD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe;QACnB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/rules/index.d.ts

@@ -0,0 +1 @@
+export { RulesManager, RuleDescriptor } from './RulesManager.js';

package/dist/rules/index.js

@@ -0,0 +1,3 @@
+// Rules module exports
+export { RulesManager } from './RulesManager.js';
+//# sourceMappingURL=index.js.map

package/dist/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AAAA,uBAAuB;AAEvB,OAAO,EAAE,YAAY,EAAkB,MAAM,mBAAmB,CAAC"}

package/dist/shared/BaseManager.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Base descriptor for all managed components
+ */
+export interface ComponentDescriptor {
+    /** Component name (e.g., 'coding-style', 'planner') */
+    name: string;
+    /** Brief description of the component */
+    description: string;
+    /** Path to the component (file or directory) */
+    path: string;
+}
+/**
+ * Result of component installation
+ */
+export interface InstallResult {
+    /** Successfully installed components */
+    installed: string[];
+    /** Failed installations with error details */
+    failed: Array<{
+        name: string;
+        error: string;
+    }>;
+}
+/**
+ * Parsed component metadata from YAML frontmatter
+ */
+export interface ComponentMetadata {
+    name?: string;
+    description?: string;
+    [key: string]: unknown;
+}
+/**
+ * Configuration options for BaseManager
+ */
+export interface ManagerConfig {
+    /** Path to the component directory */
+    componentPath: string;
+    /**
+     * Component structure type:
+     * - 'directory': Components are in subdirectories with a main file (like skills/)
+     * - 'file': Components are individual files (like agents/, rules/, contexts/)
+     */
+    structureType: 'directory' | 'file';
+    /**
+     * Main filename for directory-based components (e.g., 'SKILL.md', 'AGENT.md')
+     * Only used when structureType is 'directory'
+     */
+    mainFileName?: string;
+    /** File extension to filter (default: '.md') */
+    fileExtension?: string;
+}
+/**
+ * Abstract base class for component managers
+ *
+ * Provides common functionality for discovering, listing, and installing
+ * various component types (skills, agents, rules, contexts, hooks).
+ *
+ * @typeParam T - The descriptor type for the managed component
+ */
+export declare abstract class BaseManager<T extends ComponentDescriptor> {
+    protected readonly config: ManagerConfig;
+    /**
+     * Create a new BaseManager
+     * @param config - Manager configuration
+     */
+    constructor(config: ManagerConfig);
+    /**
+     * Parse metadata from component content
+     * Override this method to customize metadata extraction
+     * @param content - Raw content of the component file
+     * @param filePath - Path to the component file (for context)
+     * @returns Parsed component descriptor
+     */
+    protected abstract parseMetadata(content: string, filePath: string): T;
+    /**
+     * Get the component name from a file or directory path
+     * @param entryPath - Path to the entry
+     * @returns Component name
+     */
+    protected getComponentName(entryPath: string): string;
+    /**
+     * List all available components
+     * @returns Array of component descriptors
+     */
+    listComponents(): Promise<T[]>;
+    /**
+     * Get content of a specific component
+     * @param componentName - Name of the component
+     * @returns Component content
+     * @throws Error if component not found
+     */
+    getComponentContent(componentName: string): Promise<string>;
+    /**
+     * Get path to a specific component
+     * @param componentName - Name of the component
+     * @returns Path to the component
+     * @throws Error if component not found
+     */
+    getComponentPath(componentName: string): Promise<string>;
+    /**
+     * Install components to a target directory
+     * @param targetPath - Target directory for installation
+     * @returns Installation result with success and failure details
+     */
+    installComponents(targetPath: string): Promise<InstallResult>;
+    /**
+     * Parse YAML frontmatter from content
+     * @param content - Content with YAML frontmatter
+     * @returns Parsed metadata
+     */
+    protected parseYamlFrontmatter(content: string): ComponentMetadata;
+    /**
+     * Get content body (without frontmatter)
+     * @param content - Full content with possible frontmatter
+     * @returns Content body
+     */
+    protected getContentBody(content: string): string;
+    /**
+     * Copy a directory recursively
+     * @param source - Source directory
+     * @param destination - Destination directory
+     */
+    protected copyDirectory(source: string, destination: string): Promise<void>;
+    /**
+     * Check if a path exists
+     * @param filePath - Path to check
+     * @returns True if path exists
+     */
+    protected pathExists(filePath: string): Promise<boolean>;
+}

package/dist/shared/BaseManager.js

@@ -0,0 +1,274 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Abstract base class for component managers
+ *
+ * Provides common functionality for discovering, listing, and installing
+ * various component types (skills, agents, rules, contexts, hooks).
+ *
+ * @typeParam T - The descriptor type for the managed component
+ */
+export class BaseManager {
+    config;
+    /**
+     * Create a new BaseManager
+     * @param config - Manager configuration
+     */
+    constructor(config) {
+        this.config = {
+            ...config,
+            fileExtension: config.fileExtension || '.md',
+        };
+    }
+    /**
+     * Get the component name from a file or directory path
+     * @param entryPath - Path to the entry
+     * @returns Component name
+     */
+    getComponentName(entryPath) {
+        return path.basename(entryPath, this.config.fileExtension);
+    }
+    /**
+     * List all available components
+     * @returns Array of component descriptors
+     */
+    async listComponents() {
+        const components = [];
+        try {
+            const entries = await fs.promises.readdir(this.config.componentPath, { withFileTypes: true });
+            if (this.config.structureType === 'directory') {
+                // Directory-based structure (like skills/)
+                for (const entry of entries) {
+                    if (entry.isDirectory()) {
+                        const mainFilePath = path.join(this.config.componentPath, entry.name, this.config.mainFileName || `${entry.name}${this.config.fileExtension}`);
+                        try {
+                            const content = await fs.promises.readFile(mainFilePath, 'utf-8');
+                            const descriptor = this.parseMetadata(content, mainFilePath);
+                            components.push({
+                                ...descriptor,
+                                path: path.join(this.config.componentPath, entry.name),
+                            });
+                        }
+                        catch {
+                            // Skip directories without main file
+                            continue;
+                        }
+                    }
+                }
+            }
+            else {
+                // File-based structure (like agents/, rules/, contexts/)
+                for (const entry of entries) {
+                    if (entry.isFile() && entry.name.endsWith(this.config.fileExtension || '.md')) {
+                        const filePath = path.join(this.config.componentPath, entry.name);
+                        try {
+                            const content = await fs.promises.readFile(filePath, 'utf-8');
+                            const descriptor = this.parseMetadata(content, filePath);
+                            components.push({
+                                ...descriptor,
+                                path: filePath,
+                            });
+                        }
+                        catch {
+                            // Skip files that can't be read or parsed
+                            continue;
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // Return empty array if component directory doesn't exist
+            return [];
+        }
+        return components;
+    }
+    /**
+     * Get content of a specific component
+     * @param componentName - Name of the component
+     * @returns Component content
+     * @throws Error if component not found
+     */
+    async getComponentContent(componentName) {
+        let componentPath;
+        if (this.config.structureType === 'directory') {
+            componentPath = path.join(this.config.componentPath, componentName, this.config.mainFileName || `${componentName}${this.config.fileExtension}`);
+        }
+        else {
+            componentPath = path.join(this.config.componentPath, `${componentName}${this.config.fileExtension}`);
+        }
+        try {
+            return await fs.promises.readFile(componentPath, 'utf-8');
+        }
+        catch {
+            throw new Error(`Component "${componentName}" not found`);
+        }
+    }
+    /**
+     * Get path to a specific component
+     * @param componentName - Name of the component
+     * @returns Path to the component
+     * @throws Error if component not found
+     */
+    async getComponentPath(componentName) {
+        let componentPath;
+        if (this.config.structureType === 'directory') {
+            componentPath = path.join(this.config.componentPath, componentName);
+        }
+        else {
+            componentPath = path.join(this.config.componentPath, `${componentName}${this.config.fileExtension}`);
+        }
+        const exists = await this.pathExists(componentPath);
+        if (!exists) {
+            throw new Error(`Component "${componentName}" not found`);
+        }
+        return componentPath;
+    }
+    /**
+     * Install components to a target directory
+     * @param targetPath - Target directory for installation
+     * @returns Installation result with success and failure details
+     */
+    async installComponents(targetPath) {
+        const result = {
+            installed: [],
+            failed: [],
+        };
+        // Create target directory
+        await fs.promises.mkdir(targetPath, { recursive: true });
+        try {
+            const entries = await fs.promises.readdir(this.config.componentPath, { withFileTypes: true });
+            if (this.config.structureType === 'directory') {
+                // Install directory-based components
+                for (const entry of entries) {
+                    if (!entry.isDirectory())
+                        continue;
+                    const componentName = entry.name;
+                    const sourceDir = path.join(this.config.componentPath, componentName);
+                    const destDir = path.join(targetPath, componentName);
+                    try {
+                        await this.copyDirectory(sourceDir, destDir);
+                        result.installed.push(componentName);
+                    }
+                    catch (error) {
+                        result.failed.push({
+                            name: componentName,
+                            error: error instanceof Error ? error.message : String(error),
+                        });
+                    }
+                }
+            }
+            else {
+                // Install file-based components
+                for (const entry of entries) {
+                    if (!entry.isFile() || !entry.name.endsWith(this.config.fileExtension || '.md')) {
+                        continue;
+                    }
+                    const componentName = this.getComponentName(entry.name);
+                    const sourceFile = path.join(this.config.componentPath, entry.name);
+                    const destFile = path.join(targetPath, entry.name);
+                    try {
+                        await fs.promises.copyFile(sourceFile, destFile);
+                        result.installed.push(componentName);
+                    }
+                    catch (error) {
+                        result.failed.push({
+                            name: componentName,
+                            error: error instanceof Error ? error.message : String(error),
+                        });
+                    }
+                }
+            }
+        }
+        catch {
+            // Return current result if reading component directory fails
+        }
+        return result;
+    }
+    /**
+     * Parse YAML frontmatter from content
+     * @param content - Content with YAML frontmatter
+     * @returns Parsed metadata
+     */
+    parseYamlFrontmatter(content) {
+        const metadata = {};
+        // Match YAML frontmatter between --- delimiters
+        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!frontmatterMatch) {
+            return metadata;
+        }
+        const frontmatter = frontmatterMatch[1];
+        // Simple YAML parsing for key: value pairs
+        const lines = frontmatter.split('\n');
+        for (const line of lines) {
+            const colonIndex = line.indexOf(':');
+            if (colonIndex > 0) {
+                const key = line.slice(0, colonIndex).trim();
+                let value = line.slice(colonIndex + 1).trim();
+                // Handle quoted values
+                if ((value.startsWith('"') && value.endsWith('"')) ||
+                    (value.startsWith("'") && value.endsWith("'"))) {
+                    value = value.slice(1, -1);
+                }
+                // Handle boolean values
+                if (value === 'true') {
+                    metadata[key] = true;
+                }
+                else if (value === 'false') {
+                    metadata[key] = false;
+                }
+                else if (!isNaN(Number(value)) && value !== '') {
+                    metadata[key] = Number(value);
+                }
+                else {
+                    metadata[key] = value;
+                }
+            }
+        }
+        return metadata;
+    }
+    /**
+     * Get content body (without frontmatter)
+     * @param content - Full content with possible frontmatter
+     * @returns Content body
+     */
+    getContentBody(content) {
+        // Remove YAML frontmatter if present
+        const bodyMatch = content.match(/^---\n[\s\S]*?\n---\n?([\s\S]*)$/);
+        return bodyMatch ? bodyMatch[1].trim() : content.trim();
+    }
+    /**
+     * Copy a directory recursively
+     * @param source - Source directory
+     * @param destination - Destination directory
+     */
+    async copyDirectory(source, destination) {
+        await fs.promises.mkdir(destination, { recursive: true });
+        const entries = await fs.promises.readdir(source, { withFileTypes: true });
+        for (const entry of entries) {
+            const sourcePath = path.join(source, entry.name);
+            const destPath = path.join(destination, entry.name);
+            if (entry.isDirectory()) {
+                await this.copyDirectory(sourcePath, destPath);
+            }
+            else {
+                await fs.promises.copyFile(sourcePath, destPath);
+            }
+        }
+    }
+    /**
+     * Check if a path exists
+     * @param filePath - Path to check
+     * @returns True if path exists
+     */
+    async pathExists(filePath) {
+        try {
+            await fs.promises.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=BaseManager.js.map

package/dist/shared/BaseManager.js.map

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

package/dist/shared/index.d.ts

@@ -0,0 +1 @@
+export { BaseManager, ComponentDescriptor, InstallResult, ComponentMetadata, ManagerConfig, } from './BaseManager.js';

package/dist/shared/index.js

@@ -0,0 +1,3 @@
+// Shared module exports
+export { BaseManager, } from './BaseManager.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AAExB,OAAO,EACL,WAAW,GAKZ,MAAM,kBAAkB,CAAC"}

package/dist/utils/sddPaths.d.ts

@@ -0,0 +1,69 @@
+/**
+ * SDD directory names
+ * .spec is the new standard (v2.1.0+)
+ * .kiro is legacy (for backwards compatibility)
+ */
+export declare const SDD_DIR = ".spec";
+export declare const SDD_DIR_LEGACY = ".kiro";
+/**
+ * Get the SDD root directory for a project
+ * Prefers .spec, falls back to .kiro for legacy projects
+ *
+ * @param projectPath - Project root path
+ * @returns SDD root directory path (.spec or .kiro)
+ */
+export declare function getSddRoot(projectPath: string): string;
+/**
+ * Get the SDD directory name for a project
+ * Returns the actual directory name used (.spec or .kiro)
+ *
+ * @param projectPath - Project root path
+ * @returns Directory name (.spec or .kiro)
+ */
+export declare function getSddDirName(projectPath: string): string;
+/**
+ * Get the specs directory path
+ * @param projectPath - Project root path
+ * @returns Specs directory path
+ */
+export declare function getSpecsPath(projectPath: string): string;
+/**
+ * Get the steering directory path
+ * @param projectPath - Project root path
+ * @returns Steering directory path
+ */
+export declare function getSteeringPath(projectPath: string): string;
+/**
+ * Get a feature's spec directory path
+ * @param projectPath - Project root path
+ * @param featureName - Feature name
+ * @returns Feature spec directory path
+ */
+export declare function getFeatureSpecPath(projectPath: string, featureName: string): string;
+/**
+ * Get the spec.json file path for a feature
+ * @param projectPath - Project root path
+ * @param featureName - Feature name
+ * @returns spec.json file path
+ */
+export declare function getSpecJsonPath(projectPath: string, featureName: string): string;
+/**
+ * Check if this is a legacy project (using .kiro instead of .spec)
+ * @param projectPath - Project root path
+ * @returns true if project uses .kiro
+ */
+export declare function isLegacyProject(projectPath: string): boolean;
+/**
+ * Get the appropriate SDD directory for new projects
+ * Always returns .spec for new projects
+ *
+ * @param projectPath - Project root path
+ * @returns Path to create SDD directory (.spec)
+ */
+export declare function getNewSddRoot(projectPath: string): string;
+/**
+ * Create all required SDD directories for a new project
+ * @param projectPath - Project root path
+ * @returns Created paths
+ */
+export declare function createSddDirectories(projectPath: string): string[];