atlas-pipeline-mcp 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,447 @@
+/**
+ * Atlas Server - Shared Type Definitions
+ *
+ * This module defines all shared interfaces and types used across the
+ * multi-stage AI pipeline. Types are organized by domain concern.
+ */
+import { z } from 'zod';
+/**
+ * Represents the user's original request to the pipeline
+ */
+export interface PipelineRequest {
+    /** The raw user query or instruction */
+    query: string;
+    /** Optional repository path for git operations */
+    repoPath?: string;
+    /** Additional context provided by the user */
+    userContext?: Record<string, unknown>;
+    /** Session identifier for tracking */
+    sessionId?: string;
+}
+/**
+ * The final output of the pipeline after all stages complete
+ */
+export interface PipelineResponse {
+    /** Whether the pipeline completed successfully */
+    success: boolean;
+    /** The final optimized response */
+    result: string;
+    /** Metadata about the pipeline execution */
+    metadata: PipelineMetadata;
+    /** Error details if the pipeline failed */
+    error?: PipelineError;
+}
+/**
+ * Metadata collected during pipeline execution
+ */
+export interface PipelineMetadata {
+    /** Total execution time in milliseconds */
+    executionTimeMs: number;
+    /** Results from each pipeline stage */
+    stages: StageResult[];
+    /** The model used for generation */
+    model: string;
+    /** Timestamp when processing started */
+    startedAt: string;
+    /** Timestamp when processing completed */
+    completedAt: string;
+}
+/**
+ * Result from a single pipeline stage
+ */
+export interface StageResult {
+    /** Name of the stage */
+    name: StageName;
+    /** Whether this stage succeeded */
+    success: boolean;
+    /** Execution time for this stage in milliseconds */
+    durationMs: number;
+    /** Optional output data from the stage */
+    output?: unknown;
+}
+/**
+ * Names of all pipeline stages
+ */
+export type StageName = 'intent' | 'context' | 'git' | 'decompose' | 'variants' | 'critique' | 'optimize';
+/**
+ * Pipeline error with structured details
+ */
+export interface PipelineError {
+    /** Error code for programmatic handling */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+    /** The stage where the error occurred */
+    stage?: StageName;
+    /** Additional error details */
+    details?: Record<string, unknown>;
+}
+/**
+ * Result of intent classification
+ */
+export interface IntentAnalysis {
+    /** Primary intent category */
+    primaryIntent: IntentType;
+    /** Confidence score from 0 to 1 */
+    confidence: number;
+    /** Extracted entities from the query */
+    entities: ExtractedEntity[];
+    /** Keywords identified in the query */
+    keywords: string[];
+    /** Whether the query requires clarification */
+    requiresClarification: boolean;
+    /** Suggested clarifying questions if needed */
+    clarifyingQuestions?: string[];
+}
+/**
+ * Types of intents the system can classify
+ */
+export type IntentType = 'code_generation' | 'code_review' | 'debugging' | 'refactoring' | 'explanation' | 'documentation' | 'testing' | 'architecture' | 'general_question' | 'unknown';
+/**
+ * An entity extracted from the user query
+ */
+export interface ExtractedEntity {
+    /** Type of entity */
+    type: 'language' | 'framework' | 'file' | 'function' | 'concept' | 'library';
+    /** The extracted value */
+    value: string;
+    /** Position in the original query */
+    position: {
+        start: number;
+        end: number;
+    };
+}
+/**
+ * Aggregated context for the pipeline
+ */
+export interface PipelineContext {
+    /** The analyzed intent */
+    intent: IntentAnalysis;
+    /** Relevant code snippets */
+    codeSnippets: CodeSnippet[];
+    /** Git history context if available */
+    gitContext?: GitContext;
+    /** Project structure information */
+    projectInfo?: ProjectInfo;
+}
+/**
+ * A code snippet with metadata
+ */
+export interface CodeSnippet {
+    /** File path relative to repo root */
+    filePath: string;
+    /** The code content */
+    content: string;
+    /** Programming language */
+    language: string;
+    /** Line range in the original file */
+    lineRange: {
+        start: number;
+        end: number;
+    };
+    /** Relevance score from 0 to 1 */
+    relevance: number;
+}
+/**
+ * Project structure and configuration info
+ */
+export interface ProjectInfo {
+    /** Root directory path */
+    rootPath: string;
+    /** Detected languages in the project */
+    languages: string[];
+    /** Detected frameworks */
+    frameworks: string[];
+    /** Package manager in use */
+    packageManager?: 'npm' | 'yarn' | 'pnpm' | 'bun';
+    /** Key configuration files found */
+    configFiles: string[];
+}
+/**
+ * Git repository context
+ */
+export interface GitContext {
+    /** Current branch name */
+    currentBranch: string;
+    /** Recent commits */
+    recentCommits: GitCommit[];
+    /** Uncommitted changes */
+    uncommittedChanges: GitChange[];
+    /** Repository remote URL */
+    remoteUrl?: string;
+    /** Whether repo has uncommitted changes */
+    isDirty: boolean;
+}
+/**
+ * A git commit with metadata
+ */
+export interface GitCommit {
+    /** Commit hash (short) */
+    hash: string;
+    /** Commit message */
+    message: string;
+    /** Author name */
+    author: string;
+    /** Commit date as ISO string */
+    date: string;
+    /** Files changed in this commit */
+    filesChanged: number;
+}
+/**
+ * A single git change (staged or unstaged)
+ */
+export interface GitChange {
+    /** File path */
+    path: string;
+    /** Type of change */
+    type: 'added' | 'modified' | 'deleted' | 'renamed';
+    /** Whether the change is staged */
+    staged: boolean;
+}
+/**
+ * A decomposed task from the original query
+ */
+export interface DecomposedTask {
+    /** Unique identifier for the task */
+    id: string;
+    /** Task description */
+    description: string;
+    /** Task type category */
+    type: TaskType;
+    /** Priority from 1 (highest) to 5 (lowest) */
+    priority: 1 | 2 | 3 | 4 | 5;
+    /** IDs of tasks this depends on */
+    dependencies: string[];
+    /** Estimated complexity */
+    complexity: 'low' | 'medium' | 'high';
+    /** Suggested approach for this task */
+    approach?: string;
+}
+/**
+ * Types of decomposed tasks
+ */
+export type TaskType = 'research' | 'design' | 'implementation' | 'testing' | 'documentation' | 'review';
+/**
+ * Result of task decomposition
+ */
+export interface DecompositionResult {
+    /** Original query summary */
+    summary: string;
+    /** List of decomposed tasks */
+    tasks: DecomposedTask[];
+    /** Suggested execution order */
+    executionOrder: string[];
+    /** Total estimated complexity */
+    overallComplexity: 'low' | 'medium' | 'high';
+}
+/**
+ * A solution variant generated by the system
+ */
+export interface SolutionVariant {
+    /** Unique identifier */
+    id: string;
+    /** Variant label (A, B, C, etc.) */
+    label: string;
+    /** The generated solution code or text */
+    content: string;
+    /** Approach description */
+    approach: string;
+    /** Trade-offs of this approach */
+    tradeoffs: {
+        pros: string[];
+        cons: string[];
+    };
+    /** Target use case */
+    useCase: string;
+}
+/**
+ * Result of variant generation
+ */
+export interface VariantGenerationResult {
+    /** Generated variants */
+    variants: SolutionVariant[];
+    /** Recommended variant ID */
+    recommendedVariantId: string;
+    /** Reasoning for the recommendation */
+    recommendationReason: string;
+}
+/**
+ * Critique of a solution variant
+ */
+export interface Critique {
+    /** ID of the variant being critiqued */
+    variantId: string;
+    /** Overall quality score from 0 to 100 */
+    qualityScore: number;
+    /** Detailed assessment categories */
+    assessment: CritiqueAssessment;
+    /** List of identified issues */
+    issues: CritiqueIssue[];
+    /** Suggestions for improvement */
+    suggestions: string[];
+    /** Whether this variant is viable */
+    isViable: boolean;
+}
+/**
+ * Detailed assessment across categories
+ */
+export interface CritiqueAssessment {
+    /** Code correctness score (0-100) */
+    correctness: number;
+    /** Performance characteristics (0-100) */
+    performance: number;
+    /** Code maintainability (0-100) */
+    maintainability: number;
+    /** Security considerations (0-100) */
+    security: number;
+    /** Best practices adherence (0-100) */
+    bestPractices: number;
+}
+/**
+ * An issue identified during critique
+ */
+export interface CritiqueIssue {
+    /** Severity of the issue */
+    severity: 'critical' | 'major' | 'minor' | 'suggestion';
+    /** Category of the issue */
+    category: keyof CritiqueAssessment;
+    /** Description of the issue */
+    description: string;
+    /** Location in the code if applicable */
+    location?: string;
+    /** Suggested fix */
+    suggestedFix?: string;
+}
+/**
+ * Result of critiquing all variants
+ */
+export interface CritiqueResult {
+    /** Critiques for each variant */
+    critiques: Critique[];
+    /** ID of the best variant after critique */
+    bestVariantId: string;
+    /** Summary of the critique process */
+    summary: string;
+}
+/**
+ * Final optimized output
+ */
+export interface OptimizedOutput {
+    /** The final optimized content */
+    content: string;
+    /** Optimizations applied */
+    optimizationsApplied: Optimization[];
+    /** Final quality metrics */
+    finalMetrics: CritiqueAssessment;
+    /** Explanation of the final solution */
+    explanation: string;
+}
+/**
+ * An optimization that was applied
+ */
+export interface Optimization {
+    /** Type of optimization */
+    type: 'performance' | 'readability' | 'security' | 'simplification' | 'best_practice';
+    /** Description of what was optimized */
+    description: string;
+    /** Impact assessment */
+    impact: 'low' | 'medium' | 'high';
+}
+/**
+ * Configuration for Ollama API calls
+ */
+export interface OllamaConfig {
+    /** Base URL for Ollama API */
+    baseUrl: string;
+    /** Model to use for generation */
+    model: string;
+    /** Request timeout in milliseconds */
+    timeoutMs: number;
+    /** Maximum retries on failure */
+    maxRetries: number;
+}
+/**
+ * Options for a generation request
+ */
+export interface GenerationOptions {
+    /** System prompt to set context */
+    systemPrompt?: string;
+    /** Temperature for generation (0-1) */
+    temperature?: number;
+    /** Maximum tokens to generate */
+    maxTokens?: number;
+    /** Stop sequences */
+    stop?: string[];
+    /** Whether to stream the response */
+    stream?: boolean;
+}
+/**
+ * Response from Ollama generation
+ */
+export interface GenerationResponse {
+    /** Generated text */
+    text: string;
+    /** Model used */
+    model: string;
+    /** Generation statistics */
+    stats: {
+        promptTokens: number;
+        completionTokens: number;
+        totalDurationMs: number;
+    };
+}
+export declare const PipelineRequestSchema: z.ZodObject<{
+    query: z.ZodString;
+    repoPath: z.ZodOptional<z.ZodString>;
+    userContext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    sessionId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    repoPath?: string | undefined;
+    userContext?: Record<string, unknown> | undefined;
+    sessionId?: string | undefined;
+}, {
+    query: string;
+    repoPath?: string | undefined;
+    userContext?: Record<string, unknown> | undefined;
+    sessionId?: string | undefined;
+}>;
+export declare const HealthResponseSchema: z.ZodObject<{
+    status: z.ZodEnum<["healthy", "degraded", "unhealthy"]>;
+    version: z.ZodString;
+    timestamp: z.ZodString;
+    services: z.ZodObject<{
+        ollama: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        ollama: boolean;
+    }, {
+        ollama: boolean;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    status: "healthy" | "degraded" | "unhealthy";
+    version: string;
+    timestamp: string;
+    services: {
+        ollama: boolean;
+    };
+}, {
+    status: "healthy" | "degraded" | "unhealthy";
+    version: string;
+    timestamp: string;
+    services: {
+        ollama: boolean;
+    };
+}>;
+export interface ServerConfig {
+    /** Server port */
+    port: number;
+    /** Server host */
+    host: string;
+    /** Log level */
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+    /** Ollama configuration */
+    ollama: OllamaConfig;
+    /** Enable CORS */
+    corsEnabled: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,25 @@
+/**
+ * Atlas Server - Shared Type Definitions
+ *
+ * This module defines all shared interfaces and types used across the
+ * multi-stage AI pipeline. Types are organized by domain concern.
+ */
+import { z } from 'zod';
+// ============================================================================
+// Zod Schemas for Validation
+// ============================================================================
+export const PipelineRequestSchema = z.object({
+    query: z.string().min(1, 'Query is required'),
+    repoPath: z.string().optional(),
+    userContext: z.record(z.unknown()).optional(),
+    sessionId: z.string().optional(),
+});
+export const HealthResponseSchema = z.object({
+    status: z.enum(['healthy', 'degraded', 'unhealthy']),
+    version: z.string(),
+    timestamp: z.string(),
+    services: z.object({
+        ollama: z.boolean(),
+    }),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqdxB,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC;IAC7C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IACpD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB,CAAC;CACH,CAAC,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Atlas Server - Utility Functions
+ *
+ * Shared utilities for logging, timing, error handling, and common operations.
+ */
+import pino from 'pino';
+import type { PipelineError, StageName, StageResult } from './types.js';
+/**
+ * Create a configured pino logger instance
+ */
+export declare function createLogger(level?: string): pino.Logger<never, boolean>;
+/** Default logger instance */
+export declare const logger: pino.Logger<never, boolean>;
+/**
+ * Measure execution time of an async function
+ */
+export declare function measureTime<T>(fn: () => Promise<T>): Promise<{
+    result: T;
+    durationMs: number;
+}>;
+/**
+ * Create a simple timer for measuring elapsed time
+ */
+export declare function createTimer(): {
+    elapsed: () => number;
+};
+/**
+ * Safely stringify an object, handling circular references
+ */
+export declare function safeStringify(obj: unknown, indent?: number): string;
+/**
+ * Create a stage result with timing
+ */
+export declare function executeStage<T>(name: StageName, fn: () => Promise<T>): Promise<{
+    stageResult: StageResult;
+    output: T;
+}>;
+/**
+ * Create a structured pipeline error
+ */
+export declare function createPipelineError(code: string, message: string, stage?: StageName, details?: Record<string, unknown>): PipelineError;
+/**
+ * Type guard to check if value is an Error
+ */
+export declare function isError(value: unknown): value is Error;
+/**
+ * Extract error message from unknown error type
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Generate a unique ID for tracking
+ */
+export declare function generateId(): string;
+/**
+ * Truncate string to max length with ellipsis
+ */
+export declare function truncate(str: string, maxLength: number): string;
+/**
+ * Clean and normalize whitespace in a string
+ */
+export declare function normalizeWhitespace(str: string): string;
+/**
+ * Extract code blocks from markdown text
+ */
+export declare function extractCodeBlocks(text: string): Array<{
+    language: string;
+    code: string;
+}>;
+export interface RetryOptions {
+    /** Maximum number of attempts */
+    maxAttempts: number;
+    /** Initial delay in milliseconds */
+    initialDelayMs: number;
+    /** Maximum delay in milliseconds */
+    maxDelayMs: number;
+    /** Backoff multiplier */
+    backoffMultiplier: number;
+}
+/**
+ * Retry an async function with exponential backoff
+ */
+export declare function retry<T>(fn: () => Promise<T>, options?: Partial<RetryOptions>): Promise<T>;
+/**
+ * Sleep for a specified duration
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Safely parse JSON with error handling
+ */
+export declare function safeJsonParse<T>(text: string): {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Extract JSON from a text that might contain markdown or other content
+ */
+export declare function extractJson<T>(text: string): T | null;
+/**
+ * Check if a value is defined (not null or undefined)
+ */
+export declare function isDefined<T>(value: T | null | undefined): value is T;
+/**
+ * Ensure a value is defined or throw
+ */
+export declare function ensureDefined<T>(value: T | null | undefined, message: string): T;
+/**
+ * Get current timestamp as ISO string
+ */
+export declare function nowISO(): string;
+/**
+ * Format milliseconds to human-readable duration
+ */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

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