dino-spec 17.5.0 → 17.6.0

package/dist/mcp/utils/session-context.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Session Context Wrapper - v17.6.0
+ *
+ * Provides a wrapper for MCP tool handlers that auto-loads session context.
+ * This ensures tools have access to focusArea, phase, blockers, and recent changes
+ * without requiring each tool to implement session loading individually.
+ *
+ * Usage:
+ * ```typescript
+ * const handler = withSessionContext(async (params, projectDir, session) => {
+ *   // session.focusArea, session.phase, etc. are now available
+ *   return 'result'
+ * })
+ * ```
+ */
+/**
+ * Session context passed to wrapped handlers
+ */
+export interface SessionContext {
+    /** Focus area from session.md (e.g., "src/core/ralph/") */
+    focusArea?: string;
+    /** Focus confidence level */
+    focusConfidence?: string;
+    /** Focus source (e.g., "manual", "directory-cluster") */
+    focusSource?: string;
+    /** Current phase from session.md (e.g., "implementation", "discovery") */
+    phase?: string;
+    /** Active blockers from session.md */
+    blockers?: string[];
+    /** Recent changes from session.md */
+    recentChanges?: Array<{
+        time: string;
+        category: string;
+        file: string;
+    } | string>;
+    /** Test status from session.md */
+    testStatus?: string;
+    /** Build status from session.md */
+    buildStatus?: string;
+    /** Whether session was successfully loaded */
+    loaded: boolean;
+}
+/**
+ * Handler function type that receives session context
+ */
+export type SessionAwareHandler<TInput, TResult> = (params: TInput, projectDir: string, session: SessionContext) => Promise<TResult>;
+/**
+ * Standard MCP handler function type
+ */
+export type MCPHandler<TInput, TResult> = (params: TInput, projectDir: string) => Promise<TResult>;
+/**
+ * Wrap an MCP tool handler to auto-load session context
+ *
+ * @param handler - Handler function that receives session context as third parameter
+ * @returns Standard MCP handler that auto-loads session before calling inner handler
+ *
+ * @example
+ * ```typescript
+ * const handleWithContext = withSessionContext(async (params, projectDir, session) => {
+ *   if (session.focusArea) {
+ *     // Use focus area to scope operations
+ *   }
+ *   return 'result'
+ * })
+ * ```
+ */
+export declare function withSessionContext<TInput, TResult>(handler: SessionAwareHandler<TInput, TResult>): MCPHandler<TInput, TResult>;
+/**
+ * Load session context directly (for handlers that need more control)
+ *
+ * @returns Session context object
+ */
+export declare function loadSessionContext(): Promise<SessionContext>;
+/**
+ * Check if a file path is within the current focus area
+ *
+ * @param filePath - File path to check
+ * @param session - Session context
+ * @returns true if file is in focus area or no focus is set
+ */
+export declare function isInFocusArea(filePath: string, session: SessionContext): boolean;
+/**
+ * Filter a list of file paths to only those in focus area
+ *
+ * @param filePaths - Array of file paths
+ * @param session - Session context
+ * @returns Filtered array (or original if no focus)
+ */
+export declare function filterByFocus(filePaths: string[], session: SessionContext): string[];
+/**
+ * Get focus-aware priority for a file
+ * Files in focus area get higher priority (lower number)
+ *
+ * @param filePath - File path to prioritize
+ * @param session - Session context
+ * @returns Priority value (0 = highest, 1 = in-focus, 2 = near-focus, 3 = out-of-focus)
+ */
+export declare function getFocusPriority(filePath: string, session: SessionContext): number;
+/**
+ * Sort file paths by focus priority (in-focus first)
+ *
+ * @param filePaths - Array of file paths
+ * @param session - Session context
+ * @returns Sorted array with in-focus files first
+ */
+export declare function sortByFocusPriority(filePaths: string[], session: SessionContext): string[];
+export { parseSession, type SessionData } from './session-helpers.js';
+//# sourceMappingURL=session-context.d.ts.map

package/dist/mcp/utils/session-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-context.d.ts","sourceRoot":"","sources":["../../../src/mcp/utils/session-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6BAA6B;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,qCAAqC;IACrC,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,CAAA;IAChF,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,MAAM,EAAE,OAAO,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,MAAM,EAAE,OAAO,IAAI,CACjD,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,OAAO,CAAC,CAAA;AAErB;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AA2BlG;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAChD,OAAO,EAAE,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5C,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAgB7B;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,cAAc,CAAC,CAOlE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAUhF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,EAAE,CAMpF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAuBlF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,EAAE,CAI1F;AAMD,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/mcp/utils/session-context.js

@@ -0,0 +1,157 @@
+/**
+ * Session Context Wrapper - v17.6.0
+ *
+ * Provides a wrapper for MCP tool handlers that auto-loads session context.
+ * This ensures tools have access to focusArea, phase, blockers, and recent changes
+ * without requiring each tool to implement session loading individually.
+ *
+ * Usage:
+ * ```typescript
+ * const handler = withSessionContext(async (params, projectDir, session) => {
+ *   // session.focusArea, session.phase, etc. are now available
+ *   return 'result'
+ * })
+ * ```
+ */
+import { parseSession } from './session-helpers.js';
+// =============================================================================
+// Core Functions
+// =============================================================================
+/**
+ * Convert SessionData to SessionContext
+ */
+function sessionDataToContext(data) {
+    if (!data) {
+        return { loaded: false };
+    }
+    return {
+        focusArea: data.focus?.area,
+        focusConfidence: data.focus?.confidence,
+        focusSource: data.focus?.source,
+        phase: data.phase,
+        blockers: data.blockers,
+        recentChanges: data.recentChanges,
+        testStatus: data.testStatus,
+        buildStatus: data.buildStatus,
+        loaded: true,
+    };
+}
+/**
+ * Wrap an MCP tool handler to auto-load session context
+ *
+ * @param handler - Handler function that receives session context as third parameter
+ * @returns Standard MCP handler that auto-loads session before calling inner handler
+ *
+ * @example
+ * ```typescript
+ * const handleWithContext = withSessionContext(async (params, projectDir, session) => {
+ *   if (session.focusArea) {
+ *     // Use focus area to scope operations
+ *   }
+ *   return 'result'
+ * })
+ * ```
+ */
+export function withSessionContext(handler) {
+    return async (params, projectDir) => {
+        // Load session context
+        let sessionContext;
+        try {
+            const sessionData = await parseSession();
+            sessionContext = sessionDataToContext(sessionData);
+        }
+        catch {
+            // Session loading failed - continue with empty context
+            sessionContext = { loaded: false };
+        }
+        // Call the wrapped handler with session context
+        return handler(params, projectDir, sessionContext);
+    };
+}
+/**
+ * Load session context directly (for handlers that need more control)
+ *
+ * @returns Session context object
+ */
+export async function loadSessionContext() {
+    try {
+        const sessionData = await parseSession();
+        return sessionDataToContext(sessionData);
+    }
+    catch {
+        return { loaded: false };
+    }
+}
+/**
+ * Check if a file path is within the current focus area
+ *
+ * @param filePath - File path to check
+ * @param session - Session context
+ * @returns true if file is in focus area or no focus is set
+ */
+export function isInFocusArea(filePath, session) {
+    if (!session.focusArea) {
+        return true; // No focus = everything is in scope
+    }
+    // Normalize paths for comparison
+    const normalizedPath = filePath.replace(/\\/g, '/');
+    const normalizedFocus = session.focusArea.replace(/\\/g, '/');
+    return normalizedPath.startsWith(normalizedFocus);
+}
+/**
+ * Filter a list of file paths to only those in focus area
+ *
+ * @param filePaths - Array of file paths
+ * @param session - Session context
+ * @returns Filtered array (or original if no focus)
+ */
+export function filterByFocus(filePaths, session) {
+    if (!session.focusArea) {
+        return filePaths;
+    }
+    return filePaths.filter((path) => isInFocusArea(path, session));
+}
+/**
+ * Get focus-aware priority for a file
+ * Files in focus area get higher priority (lower number)
+ *
+ * @param filePath - File path to prioritize
+ * @param session - Session context
+ * @returns Priority value (0 = highest, 1 = in-focus, 2 = near-focus, 3 = out-of-focus)
+ */
+export function getFocusPriority(filePath, session) {
+    if (!session.focusArea) {
+        return 1; // Default priority when no focus
+    }
+    const normalizedPath = filePath.replace(/\\/g, '/');
+    const normalizedFocus = session.focusArea.replace(/\\/g, '/');
+    // Exact match or child
+    if (normalizedPath.startsWith(normalizedFocus)) {
+        return 0;
+    }
+    // Near focus (same parent directory)
+    const focusParent = normalizedFocus.split('/').slice(0, -1).join('/');
+    const pathParent = normalizedPath.split('/').slice(0, -1).join('/');
+    if (focusParent && pathParent.startsWith(focusParent)) {
+        return 1;
+    }
+    // Out of focus
+    return 2;
+}
+/**
+ * Sort file paths by focus priority (in-focus first)
+ *
+ * @param filePaths - Array of file paths
+ * @param session - Session context
+ * @returns Sorted array with in-focus files first
+ */
+export function sortByFocusPriority(filePaths, session) {
+    return [...filePaths].sort((a, b) => {
+        return getFocusPriority(a, session) - getFocusPriority(b, session);
+    });
+}
+// =============================================================================
+// Re-exports for convenience
+// =============================================================================
+export { parseSession } from './session-helpers.js';
+//# sourceMappingURL=session-context.js.map

package/dist/mcp/utils/session-context.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dino-spec",
-  "version": "17.5.0",
+  "version": "17.6.0",
   "description": "Automatic context engineering for Claude Code",
   "type": "module",
   "exports": {