@skillsmith/mcp-server 0.1.0

package/dist/src/__tests__/test-utils.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Test utilities for MCP server tests
+ * @see SMI-792: Database initialization
+ */
+import { type ToolContext } from '../context.js';
+export type { ToolContext };
+/**
+ * Create a test context with in-memory database
+ */
+export declare function createTestContext(): ToolContext;
+/**
+ * Seed test data into the context
+ */
+export declare function seedTestData(context: ToolContext): void;
+/**
+ * Create a seeded test context
+ */
+export declare function createSeededTestContext(): ToolContext;
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/src/__tests__/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../../src/__tests__/test-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AAEnE,YAAY,EAAE,WAAW,EAAE,CAAA;AAE3B;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAqEvD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,WAAW,CAIrD"}

package/dist/src/__tests__/test-utils.js

@@ -0,0 +1,87 @@
+/**
+ * Test utilities for MCP server tests
+ * @see SMI-792: Database initialization
+ */
+import { createToolContext } from '../context.js';
+/**
+ * Create a test context with in-memory database
+ */
+export function createTestContext() {
+    return createToolContext({ dbPath: ':memory:' });
+}
+/**
+ * Seed test data into the context
+ */
+export function seedTestData(context) {
+    const { skillRepository } = context;
+    // Add test skills
+    skillRepository.create({
+        id: 'anthropic/commit',
+        name: 'commit',
+        description: 'Generate semantic commit messages following conventional commits',
+        author: 'anthropic',
+        repoUrl: 'https://github.com/anthropics/claude-code-skills',
+        qualityScore: 0.95,
+        trustTier: 'verified',
+        tags: ['git', 'commit', 'conventional-commits', 'automation'],
+    });
+    skillRepository.create({
+        id: 'anthropic/review-pr',
+        name: 'review-pr',
+        description: 'Review pull requests with detailed code analysis',
+        author: 'anthropic',
+        repoUrl: 'https://github.com/anthropics/claude-code-skills-pr',
+        qualityScore: 0.93,
+        trustTier: 'verified',
+        tags: ['git', 'pull-request', 'code-review', 'quality'],
+    });
+    skillRepository.create({
+        id: 'community/jest-helper',
+        name: 'jest-helper',
+        description: 'Generate Jest test cases for React components',
+        author: 'community',
+        repoUrl: 'https://github.com/skillsmith-community/jest-helper',
+        qualityScore: 0.87,
+        trustTier: 'community',
+        tags: ['jest', 'testing', 'react', 'unit-tests'],
+    });
+    skillRepository.create({
+        id: 'community/vitest-helper',
+        name: 'vitest-helper',
+        description: 'Generate Vitest test cases with modern testing patterns',
+        author: 'community',
+        repoUrl: 'https://github.com/skillsmith-community/vitest-helper',
+        qualityScore: 0.85,
+        trustTier: 'community',
+        tags: ['vitest', 'testing', 'typescript', 'unit-tests'],
+    });
+    skillRepository.create({
+        id: 'community/docker-compose',
+        name: 'docker-compose',
+        description: 'Generate and manage Docker Compose configurations',
+        author: 'community',
+        repoUrl: 'https://github.com/skillsmith-community/docker-compose',
+        qualityScore: 0.84,
+        trustTier: 'community',
+        tags: ['docker', 'devops', 'containers', 'infrastructure'],
+    });
+    skillRepository.create({
+        id: 'community/api-docs',
+        name: 'api-docs',
+        description: 'Generate OpenAPI documentation from code',
+        author: 'community',
+        repoUrl: 'https://github.com/skillsmith-community/api-docs',
+        qualityScore: 0.78,
+        trustTier: 'experimental',
+        tags: ['documentation', 'openapi', 'api'],
+    });
+}
+/**
+ * Create a seeded test context
+ */
+export function createSeededTestContext() {
+    const context = createTestContext();
+    seedTestData(context);
+    return context;
+}
+//# sourceMappingURL=test-utils.js.map

package/dist/src/__tests__/test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.js","sourceRoot":"","sources":["../../../src/__tests__/test-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAoB,MAAM,eAAe,CAAA;AAInE;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,iBAAiB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAoB;IAC/C,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAA;IAEnC,kBAAkB;IAClB,eAAe,CAAC,MAAM,CAAC;QACrB,EAAE,EAAE,kBAAkB;QACtB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,kEAAkE;QAC/E,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,kDAAkD;QAC3D,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,UAAU;QACrB,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,sBAAsB,EAAE,YAAY,CAAC;KAC9D,CAAC,CAAA;IAEF,eAAe,CAAC,MAAM,CAAC;QACrB,EAAE,EAAE,qBAAqB;QACzB,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,kDAAkD;QAC/D,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,qDAAqD;QAC9D,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,UAAU;QACrB,IAAI,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,CAAC;KACxD,CAAC,CAAA;IAEF,eAAe,CAAC,MAAM,CAAC;QACrB,EAAE,EAAE,uBAAuB;QAC3B,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,+CAA+C;QAC5D,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,qDAAqD;QAC9D,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,WAAW;QACtB,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC;KACjD,CAAC,CAAA;IAEF,eAAe,CAAC,MAAM,CAAC;QACrB,EAAE,EAAE,yBAAyB;QAC7B,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,yDAAyD;QACtE,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,uDAAuD;QAChE,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,WAAW;QACtB,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC;KACxD,CAAC,CAAA;IAEF,eAAe,CAAC,MAAM,CAAC;QACrB,EAAE,EAAE,0BAA0B;QAC9B,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,mDAAmD;QAChE,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,wDAAwD;QACjE,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,WAAW;QACtB,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,CAAC;KAC3D,CAAC,CAAA;IAEF,eAAe,CAAC,MAAM,CAAC;QACrB,EAAE,EAAE,oBAAoB;QACxB,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,0CAA0C;QACvD,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,kDAAkD;QAC3D,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,cAAc;QACzB,IAAI,EAAE,CAAC,eAAe,EAAE,SAAS,EAAE,KAAK,CAAC;KAC1C,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAA;IACnC,YAAY,CAAC,OAAO,CAAC,CAAA;IACrB,OAAO,OAAO,CAAA;AAChB,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Context Detection Module Exports
+ * @module @skillsmith/mcp-server/context
+ * @see SMI-912: Project context detection for skill suggestions
+ *
+ * Re-exports all project context detection utilities for easy importing.
+ *
+ * @example
+ * import {
+ *   detectProjectContext,
+ *   getSuggestedSkills,
+ *   ProjectContext
+ * } from './context';
+ *
+ * const context = detectProjectContext();
+ * const skills = getSuggestedSkills(context);
+ */
+export { detectProjectContext, detectDocker, detectLinear, detectGitHub, detectTestFramework, detectApiFramework, detectNativeModules, detectLanguage, getSuggestedSkills, type ProjectContext, } from './project-detector.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAEL,oBAAoB,EAEpB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EAEd,kBAAkB,EAElB,KAAK,cAAc,GACpB,MAAM,uBAAuB,CAAA"}

package/dist/src/context/index.js

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Context Detection Module Exports
+ * @module @skillsmith/mcp-server/context
+ * @see SMI-912: Project context detection for skill suggestions
+ *
+ * Re-exports all project context detection utilities for easy importing.
+ *
+ * @example
+ * import {
+ *   detectProjectContext,
+ *   getSuggestedSkills,
+ *   ProjectContext
+ * } from './context';
+ *
+ * const context = detectProjectContext();
+ * const skills = getSuggestedSkills(context);
+ */
+export { 
+// Main detection function
+detectProjectContext, 
+// Individual detection functions
+detectDocker, detectLinear, detectGitHub, detectTestFramework, detectApiFramework, detectNativeModules, detectLanguage, 
+// Skill suggestion helper
+getSuggestedSkills, } from './project-detector.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO;AACL,0BAA0B;AAC1B,oBAAoB;AACpB,iCAAiC;AACjC,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc;AACd,0BAA0B;AAC1B,kBAAkB,GAGnB,MAAM,uBAAuB,CAAA"}

package/dist/src/context/project-detector.d.ts

@@ -0,0 +1,145 @@
+/**
+ * @fileoverview Project Context Detection for Skill Suggestions
+ * @module @skillsmith/mcp-server/context/project-detector
+ * @see SMI-912: Project context detection for skill suggestions
+ *
+ * Analyzes the user's project to detect technologies, frameworks, and tools
+ * in use to provide contextual skill recommendations.
+ *
+ * @example
+ * // Detect project context for the current working directory
+ * const context = detectProjectContext();
+ *
+ * // Detect project context for a specific path
+ * const context = detectProjectContext('/path/to/project');
+ *
+ * // Use context for skill suggestions
+ * if (context.hasDocker) {
+ *   suggestSkill('docker');
+ * }
+ */
+/**
+ * Validates that a path does not escape the allowed base directory.
+ * Prevents path traversal attacks using sequences like '../'.
+ *
+ * @param inputPath - The path to validate (can be relative or absolute)
+ * @param baseDir - The allowed base directory
+ * @returns The resolved, sanitized absolute path
+ * @throws Error if the path attempts to escape the base directory
+ */
+export declare function validatePath(inputPath: string, baseDir: string): string;
+/**
+ * Detected project context for skill recommendations
+ */
+export interface ProjectContext {
+    /** Whether project uses Docker (Dockerfile or docker-compose) */
+    hasDocker: boolean;
+    /** Whether project is connected to Linear (detected from git config) */
+    hasLinear: boolean;
+    /** Whether project is hosted on GitHub */
+    hasGitHub: boolean;
+    /** Detected test framework (jest, vitest, mocha) */
+    testFramework: 'jest' | 'vitest' | 'mocha' | null;
+    /** Detected API framework (express, fastapi, nextjs) */
+    apiFramework: 'express' | 'fastapi' | 'nextjs' | null;
+    /** Whether project uses native modules (better-sqlite3, sharp, etc.) */
+    hasNativeModules: boolean;
+    /** Detected primary language */
+    language: 'typescript' | 'javascript' | 'python' | null;
+}
+/**
+ * Detect complete project context from filesystem analysis
+ *
+ * @param projectPath - Path to the project directory (defaults to cwd)
+ * @param allowedBaseDir - Optional base directory to restrict path access (defaults to projectPath itself)
+ * @returns Detected project context
+ * @throws Error if projectPath attempts to escape the allowedBaseDir
+ *
+ * @example
+ * const context = detectProjectContext('/path/to/project');
+ * console.log(context.hasDocker); // true/false
+ */
+export declare function detectProjectContext(projectPath?: string, allowedBaseDir?: string): ProjectContext;
+/**
+ * Detect Docker usage in project
+ *
+ * Checks for:
+ * - Dockerfile
+ * - docker-compose.yml
+ * - docker-compose.yaml
+ *
+ * @param path - Project path to check
+ * @returns True if Docker is detected
+ */
+export declare function detectDocker(path: string): boolean;
+/**
+ * Detect Linear integration from git remote config
+ *
+ * Checks if any git remote references linear.app
+ *
+ * @param path - Project path to check
+ * @returns True if Linear integration is detected
+ */
+export declare function detectLinear(path: string): boolean;
+/**
+ * Detect GitHub hosting from git remote config
+ *
+ * Checks if any git remote references github.com
+ *
+ * @param path - Project path to check
+ * @returns True if GitHub hosting is detected
+ */
+export declare function detectGitHub(path: string): boolean;
+/**
+ * Detect test framework from package.json dependencies
+ *
+ * Checks for: vitest, jest, mocha (in priority order)
+ *
+ * @param path - Project path to check
+ * @returns Detected test framework or null
+ */
+export declare function detectTestFramework(path: string): 'jest' | 'vitest' | 'mocha' | null;
+/**
+ * Detect API framework from package.json or requirements.txt
+ *
+ * Checks for: next (Next.js), express (Express), fastapi (FastAPI)
+ *
+ * @param path - Project path to check
+ * @returns Detected API framework or null
+ */
+export declare function detectApiFramework(path: string): 'express' | 'fastapi' | 'nextjs' | null;
+/**
+ * Detect native module usage in package.json
+ *
+ * Checks for modules known to require native compilation:
+ * better-sqlite3, sharp, canvas, bcrypt, onnxruntime-node, etc.
+ *
+ * @param path - Project path to check
+ * @returns True if native modules are detected
+ */
+export declare function detectNativeModules(path: string): boolean;
+/**
+ * Detect primary programming language from project structure
+ *
+ * Detection order:
+ * 1. TypeScript (tsconfig.json)
+ * 2. JavaScript (package.json without tsconfig)
+ * 3. Python (requirements.txt or pyproject.toml)
+ *
+ * @param path - Project path to check
+ * @returns Detected language or null
+ */
+export declare function detectLanguage(path: string): 'typescript' | 'javascript' | 'python' | null;
+/**
+ * Get suggested skills based on project context
+ *
+ * @param context - Detected project context
+ * @returns Array of suggested skill IDs
+ *
+ * @example
+ * const context = detectProjectContext();
+ * const suggestions = getSuggestedSkills(context);
+ * // ['docker', 'github-actions', 'jest-helper']
+ */
+export declare function getSuggestedSkills(context: ProjectContext): string[];
+//# sourceMappingURL=project-detector.d.ts.map

package/dist/src/context/project-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detector.d.ts","sourceRoot":"","sources":["../../../src/context/project-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAWvE;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,SAAS,EAAE,OAAO,CAAA;IAClB,wEAAwE;IACxE,SAAS,EAAE,OAAO,CAAA;IAClB,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAA;IAClB,oDAAoD;IACpD,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAA;IACjD,wDAAwD;IACxD,YAAY,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAA;IACrD,wEAAwE;IACxE,gBAAgB,EAAE,OAAO,CAAA;IACzB,gCAAgC;IAChC,QAAQ,EAAE,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,IAAI,CAAA;CACxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,GAAE,MAAsB,EACnC,cAAc,CAAC,EAAE,MAAM,GACtB,cAAc,CAchB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMlD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAelD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAelD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,CAsBpF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,CAmDxF;AAmBD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAiBzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,IAAI,CAa1F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,EAAE,CA2CpE"}

package/dist/src/context/project-detector.js

@@ -0,0 +1,321 @@
+/**
+ * @fileoverview Project Context Detection for Skill Suggestions
+ * @module @skillsmith/mcp-server/context/project-detector
+ * @see SMI-912: Project context detection for skill suggestions
+ *
+ * Analyzes the user's project to detect technologies, frameworks, and tools
+ * in use to provide contextual skill recommendations.
+ *
+ * @example
+ * // Detect project context for the current working directory
+ * const context = detectProjectContext();
+ *
+ * // Detect project context for a specific path
+ * const context = detectProjectContext('/path/to/project');
+ *
+ * // Use context for skill suggestions
+ * if (context.hasDocker) {
+ *   suggestSkill('docker');
+ * }
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join, resolve, isAbsolute } from 'path';
+/**
+ * Validates that a path does not escape the allowed base directory.
+ * Prevents path traversal attacks using sequences like '../'.
+ *
+ * @param inputPath - The path to validate (can be relative or absolute)
+ * @param baseDir - The allowed base directory
+ * @returns The resolved, sanitized absolute path
+ * @throws Error if the path attempts to escape the base directory
+ */
+export function validatePath(inputPath, baseDir) {
+    const resolvedBase = resolve(baseDir);
+    const resolvedPath = isAbsolute(inputPath) ? resolve(inputPath) : resolve(baseDir, inputPath);
+    // Ensure the resolved path starts with the base directory
+    // Add path separator to prevent partial matches (e.g., /base vs /base-other)
+    if (!resolvedPath.startsWith(resolvedBase + '/') && resolvedPath !== resolvedBase) {
+        throw new Error(`Path traversal attempt detected: ${inputPath}`);
+    }
+    return resolvedPath;
+}
+/**
+ * Detect complete project context from filesystem analysis
+ *
+ * @param projectPath - Path to the project directory (defaults to cwd)
+ * @param allowedBaseDir - Optional base directory to restrict path access (defaults to projectPath itself)
+ * @returns Detected project context
+ * @throws Error if projectPath attempts to escape the allowedBaseDir
+ *
+ * @example
+ * const context = detectProjectContext('/path/to/project');
+ * console.log(context.hasDocker); // true/false
+ */
+export function detectProjectContext(projectPath = process.cwd(), allowedBaseDir) {
+    // Validate path to prevent traversal attacks
+    const baseDir = allowedBaseDir ?? projectPath;
+    const validatedPath = validatePath(projectPath, baseDir);
+    return {
+        hasDocker: detectDocker(validatedPath),
+        hasLinear: detectLinear(validatedPath),
+        hasGitHub: detectGitHub(validatedPath),
+        testFramework: detectTestFramework(validatedPath),
+        apiFramework: detectApiFramework(validatedPath),
+        hasNativeModules: detectNativeModules(validatedPath),
+        language: detectLanguage(validatedPath),
+    };
+}
+/**
+ * Detect Docker usage in project
+ *
+ * Checks for:
+ * - Dockerfile
+ * - docker-compose.yml
+ * - docker-compose.yaml
+ *
+ * @param path - Project path to check
+ * @returns True if Docker is detected
+ */
+export function detectDocker(path) {
+    return (existsSync(join(path, 'Dockerfile')) ||
+        existsSync(join(path, 'docker-compose.yml')) ||
+        existsSync(join(path, 'docker-compose.yaml')));
+}
+/**
+ * Detect Linear integration from git remote config
+ *
+ * Checks if any git remote references linear.app
+ *
+ * @param path - Project path to check
+ * @returns True if Linear integration is detected
+ */
+export function detectLinear(path) {
+    const gitConfig = join(path, '.git', 'config');
+    if (!existsSync(gitConfig))
+        return false;
+    try {
+        const content = readFileSync(gitConfig, 'utf-8');
+        return content.includes('linear.app');
+    }
+    catch (error) {
+        console.warn('[project-detector] Failed to read git config for Linear detection:', gitConfig, error instanceof Error ? error.message : String(error));
+        return false;
+    }
+}
+/**
+ * Detect GitHub hosting from git remote config
+ *
+ * Checks if any git remote references github.com
+ *
+ * @param path - Project path to check
+ * @returns True if GitHub hosting is detected
+ */
+export function detectGitHub(path) {
+    const gitConfig = join(path, '.git', 'config');
+    if (!existsSync(gitConfig))
+        return false;
+    try {
+        const content = readFileSync(gitConfig, 'utf-8');
+        return content.includes('github.com');
+    }
+    catch (error) {
+        console.warn('[project-detector] Failed to read git config for GitHub detection:', gitConfig, error instanceof Error ? error.message : String(error));
+        return false;
+    }
+}
+/**
+ * Detect test framework from package.json dependencies
+ *
+ * Checks for: vitest, jest, mocha (in priority order)
+ *
+ * @param path - Project path to check
+ * @returns Detected test framework or null
+ */
+export function detectTestFramework(path) {
+    const pkgPath = join(path, 'package.json');
+    if (!existsSync(pkgPath))
+        return null;
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+        // Check in priority order (vitest is preferred over jest)
+        if (deps['vitest'])
+            return 'vitest';
+        if (deps['jest'])
+            return 'jest';
+        if (deps['mocha'])
+            return 'mocha';
+    }
+    catch (error) {
+        console.warn('[project-detector] Failed to parse package.json for test framework detection:', pkgPath, error instanceof Error ? error.message : String(error));
+        return null;
+    }
+    return null;
+}
+/**
+ * Detect API framework from package.json or requirements.txt
+ *
+ * Checks for: next (Next.js), express (Express), fastapi (FastAPI)
+ *
+ * @param path - Project path to check
+ * @returns Detected API framework or null
+ */
+export function detectApiFramework(path) {
+    // Check Node.js frameworks first
+    const pkgPath = join(path, 'package.json');
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+            // Check in priority order (Next.js is a more specific framework)
+            if (deps['next'])
+                return 'nextjs';
+            if (deps['express'])
+                return 'express';
+        }
+        catch (error) {
+            console.warn('[project-detector] Failed to parse package.json for API framework detection:', pkgPath, error instanceof Error ? error.message : String(error));
+        }
+    }
+    // Check for FastAPI (Python)
+    const requirementsPath = join(path, 'requirements.txt');
+    if (existsSync(requirementsPath)) {
+        try {
+            const content = readFileSync(requirementsPath, 'utf-8');
+            if (content.toLowerCase().includes('fastapi'))
+                return 'fastapi';
+        }
+        catch (error) {
+            console.warn('[project-detector] Failed to read requirements.txt:', requirementsPath, error instanceof Error ? error.message : String(error));
+        }
+    }
+    // Also check pyproject.toml for modern Python projects
+    const pyprojectPath = join(path, 'pyproject.toml');
+    if (existsSync(pyprojectPath)) {
+        try {
+            const content = readFileSync(pyprojectPath, 'utf-8');
+            if (content.toLowerCase().includes('fastapi'))
+                return 'fastapi';
+        }
+        catch (error) {
+            console.warn('[project-detector] Failed to read pyproject.toml:', pyprojectPath, error instanceof Error ? error.message : String(error));
+        }
+    }
+    return null;
+}
+/**
+ * Known native Node.js modules that require compilation
+ */
+const NATIVE_MODULES = [
+    'better-sqlite3',
+    'sharp',
+    'canvas',
+    'bcrypt',
+    'onnxruntime-node',
+    'node-gyp',
+    'node-sass',
+    'sqlite3',
+    'fsevents',
+    'bufferutil',
+    'utf-8-validate',
+];
+/**
+ * Detect native module usage in package.json
+ *
+ * Checks for modules known to require native compilation:
+ * better-sqlite3, sharp, canvas, bcrypt, onnxruntime-node, etc.
+ *
+ * @param path - Project path to check
+ * @returns True if native modules are detected
+ */
+export function detectNativeModules(path) {
+    const pkgPath = join(path, 'package.json');
+    if (!existsSync(pkgPath))
+        return false;
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+        return NATIVE_MODULES.some((mod) => mod in deps);
+    }
+    catch (error) {
+        console.warn('[project-detector] Failed to parse package.json for native module detection:', pkgPath, error instanceof Error ? error.message : String(error));
+        return false;
+    }
+}
+/**
+ * Detect primary programming language from project structure
+ *
+ * Detection order:
+ * 1. TypeScript (tsconfig.json)
+ * 2. JavaScript (package.json without tsconfig)
+ * 3. Python (requirements.txt or pyproject.toml)
+ *
+ * @param path - Project path to check
+ * @returns Detected language or null
+ */
+export function detectLanguage(path) {
+    // TypeScript takes priority
+    if (existsSync(join(path, 'tsconfig.json')))
+        return 'typescript';
+    // JavaScript (has package.json but no tsconfig)
+    if (existsSync(join(path, 'package.json')))
+        return 'javascript';
+    // Python
+    if (existsSync(join(path, 'requirements.txt')) || existsSync(join(path, 'pyproject.toml'))) {
+        return 'python';
+    }
+    return null;
+}
+/**
+ * Get suggested skills based on project context
+ *
+ * @param context - Detected project context
+ * @returns Array of suggested skill IDs
+ *
+ * @example
+ * const context = detectProjectContext();
+ * const suggestions = getSuggestedSkills(context);
+ * // ['docker', 'github-actions', 'jest-helper']
+ */
+export function getSuggestedSkills(context) {
+    const suggestions = [];
+    if (context.hasDocker) {
+        suggestions.push('docker');
+    }
+    if (context.hasGitHub) {
+        suggestions.push('github-actions');
+        suggestions.push('github-pr');
+    }
+    if (context.hasLinear) {
+        suggestions.push('linear');
+    }
+    if (context.testFramework === 'jest') {
+        suggestions.push('jest-helper');
+    }
+    else if (context.testFramework === 'vitest') {
+        suggestions.push('vitest-helper');
+    }
+    else if (context.testFramework === 'mocha') {
+        suggestions.push('mocha-helper');
+    }
+    if (context.apiFramework === 'nextjs') {
+        suggestions.push('nextjs');
+    }
+    else if (context.apiFramework === 'express') {
+        suggestions.push('express');
+    }
+    else if (context.apiFramework === 'fastapi') {
+        suggestions.push('fastapi');
+    }
+    if (context.hasNativeModules) {
+        suggestions.push('native-modules');
+    }
+    if (context.language === 'typescript') {
+        suggestions.push('typescript');
+    }
+    else if (context.language === 'python') {
+        suggestions.push('python');
+    }
+    return suggestions;
+}
+//# sourceMappingURL=project-detector.js.map

package/dist/src/context/project-detector.js.map

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