@jungjaehoon/mama-core 1.1.1 → 1.1.3

package/dist/debug-logger.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * DebugLogger - Centralized logging for MAMA hooks
+ *
+ * CLAUDE.md Compliant:
+ * - NO console.log (use DebugLogger.info instead)
+ * - console.error/warn allowed but wrapped for consistency
+ *
+ * Features:
+ * - Log levels (DEBUG, INFO, WARN, ERROR)
+ * - Timestamp formatting
+ * - Environment-based filtering
+ * - Module/context tagging
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.error = exports.warn = exports.info = exports.debug = exports.DebugLogger = void 0;
+const LOG_LEVELS = {
+    DEBUG: 0,
+    INFO: 1,
+    WARN: 2,
+    ERROR: 3,
+    NONE: 4,
+};
+class DebugLogger {
+    context;
+    level;
+    constructor(context = 'MAMA') {
+        this.context = context;
+        this.level = this._getLogLevel();
+    }
+    _getLogLevel() {
+        // Changed default from 'INFO' to 'ERROR' for cleaner output
+        // Users can override with MAMA_LOG_LEVEL env var
+        const env = (process.env.MAMA_LOG_LEVEL || 'ERROR').toUpperCase();
+        return LOG_LEVELS[env] ?? LOG_LEVELS.ERROR;
+    }
+    _shouldLog(level) {
+        return LOG_LEVELS[level] >= this.level;
+    }
+    _formatMessage(level, ...args) {
+        const timestamp = new Date().toISOString();
+        const prefix = `[${timestamp}] [${this.context}] [${level}]`;
+        return [prefix, ...args];
+    }
+    debug(...args) {
+        if (!this._shouldLog('DEBUG')) {
+            return;
+        }
+        console.error(...this._formatMessage('DEBUG', ...args));
+    }
+    info(...args) {
+        if (!this._shouldLog('INFO')) {
+            return;
+        }
+        console.error(...this._formatMessage('INFO', ...args));
+    }
+    warn(...args) {
+        if (!this._shouldLog('WARN')) {
+            return;
+        }
+        console.warn(...this._formatMessage('WARN', ...args));
+    }
+    error(...args) {
+        if (!this._shouldLog('ERROR')) {
+            return;
+        }
+        console.error(...this._formatMessage('ERROR', ...args));
+    }
+}
+exports.DebugLogger = DebugLogger;
+// Export singleton with default context
+const logger = new DebugLogger('MAMA');
+// Export convenience functions
+const debug = (...args) => logger.debug(...args);
+exports.debug = debug;
+const info = (...args) => logger.info(...args);
+exports.info = info;
+const warn = (...args) => logger.warn(...args);
+exports.warn = warn;
+const error = (...args) => logger.error(...args);
+exports.error = error;
+exports.default = logger;
+//# sourceMappingURL=debug-logger.js.map

package/dist/decision-formatter.d.ts

@@ -0,0 +1,172 @@
+/**
+ * MAMA (Memory-Augmented MCP Architecture) - Decision Context Formatter
+ *
+ * Formats decision history with token budget enforcement and top-N selection
+ * Tasks: 6.1-6.6, 8.1-8.5 (Context formatting with top-N selection)
+ * AC #1: Context under 500 tokens
+ * AC #4: Rolling summary for large histories
+ * AC #5: Top-N selection with summary
+ *
+ * @module decision-formatter
+ * @version 2.0
+ * @date 2025-11-14
+ */
+/**
+ * Decision object for formatting
+ */
+export interface DecisionForFormat {
+    id?: string;
+    topic?: string;
+    decision: string;
+    reasoning?: string | null;
+    outcome?: string | null;
+    failure_reason?: string | null;
+    limitation?: string | null;
+    user_involvement?: string;
+    confidence?: number;
+    created_at: number | string;
+    updated_at?: number | string;
+    superseded_by?: string | null;
+    relevanceScore?: number;
+    similarity?: number;
+    recency_age_days?: number;
+    recency_score?: number;
+    final_score?: number;
+    trust_context?: TrustContext | string | null;
+    evidence?: string | string[] | unknown;
+    alternatives?: string | string[] | unknown;
+    risks?: string;
+}
+/**
+ * Trust context object
+ */
+export interface TrustContext {
+    source?: {
+        file?: string;
+        line?: number;
+        author?: string;
+        timestamp?: number | string;
+    };
+    causality?: {
+        impact?: string;
+    };
+    verification?: {
+        test_file?: string;
+        result?: string;
+    };
+    context_match?: {
+        user_intent?: string;
+    };
+    track_record?: {
+        recent_successes?: unknown[];
+        recent_failures?: unknown[];
+        success_rate?: number;
+        sample_size?: number;
+    };
+}
+/**
+ * Semantic edges for related decisions
+ */
+export interface SemanticEdges {
+    refines?: Array<{
+        topic: string;
+        decision: string;
+    }>;
+    refined_by?: Array<{
+        topic: string;
+        decision: string;
+    }>;
+    contradicts?: Array<{
+        topic: string;
+        decision: string;
+    }>;
+    contradicted_by?: Array<{
+        topic: string;
+        decision: string;
+    }>;
+}
+/**
+ * Formatting options
+ */
+export interface FormatOptions {
+    maxTokens?: number;
+    useTopN?: boolean;
+    topN?: number;
+    useTeaser?: boolean;
+    limit?: number;
+}
+/**
+ * Format decision context for Claude injection with top-N selection
+ *
+ * Task 6.1-6.2, 8.1-8.5: Build context format template with top-N selection
+ * AC #1: Format decision history
+ * AC #4: Handle large histories with rolling summary
+ * AC #5: Top-N selection with summary (top 3 full detail, rest summarized)
+ *
+ * Story 014.7.10 - Task 5: Fallback Formatting
+ * Tries Instant Answer format first (if trust_context available), falls back to legacy
+ *
+ * @param decisions - Decision chain (sorted by relevance)
+ * @param options - Formatting options
+ * @returns Formatted context for injection
+ */
+export declare function formatContext(decisions: DecisionForFormat[], options?: FormatOptions): string | null;
+/**
+ * Format decisions using legacy format (no trust context)
+ *
+ * Story 014.7.10 - Task 5.1: Fallback formatting
+ * AC #3: Graceful degradation for decisions without trust_context
+ *
+ * @param decisions - Decision chain (sorted by relevance)
+ * @param options - Formatting options
+ * @returns Formatted context (legacy format)
+ */
+export declare function formatLegacyContext(decisions: DecisionForFormat[], options?: FormatOptions): string | null;
+/**
+ * Ensure token budget is enforced
+ *
+ * Task 6.3-6.5: Token budget enforcement
+ * AC #1: Context stays under 500 tokens
+ */
+export declare function ensureTokenBudget(text: string, maxTokens: number): string;
+/**
+ * Estimate token count from text
+ *
+ * Task 6.4: Simple token estimation
+ * Heuristic: ~1 token per 4 characters
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Format context in Claude-friendly Instant Answer format
+ *
+ * Story 014.7.10: Claude-Friendly Context Formatting
+ * AC #1: Instant Answer format with trust components
+ */
+export declare function formatInstantAnswer(decision: DecisionForFormat | null, options?: FormatOptions): string | null;
+/**
+ * Extract quick answer from decision
+ */
+export declare function extractQuickAnswer(decision: DecisionForFormat): string | null;
+/**
+ * Extract code example from reasoning
+ */
+export declare function extractCodeExample(decision: DecisionForFormat): string | null;
+/**
+ * Format trust context section
+ *
+ * Story 014.7.10 AC #2: Trust Context display
+ */
+export declare function formatTrustContext(trustCtx: TrustContext | null | undefined): string | null;
+/**
+ * Format decision as curiosity-inducing teaser
+ */
+export declare function formatTeaser(decision: DecisionForFormat | null): string | null;
+/**
+ * Format mama.recall() results in readable format
+ */
+export declare function formatRecall(decisions: DecisionForFormat[], semanticEdges?: SemanticEdges | null): string;
+/**
+ * Format recent decisions list (all topics, chronological)
+ */
+export declare function formatList(decisions: DecisionForFormat[], options?: FormatOptions): string;
+//# sourceMappingURL=decision-formatter.d.ts.map