smart-context-mcp 1.3.0 → 1.3.1

package/README.md

@@ -62,7 +62,7 @@ Restart your AI client. Done.
 - ✅ Token savings: 85-90% on complex tasks
 
 Check actual usage:
-- **Real-time feedback** - See usage immediately (enable with `export DEVCTX_SHOW_USAGE=true`)
+- **Real-time feedback** - Enabled by default (disable with `export DEVCTX_SHOW_USAGE=false`)
 - `npm run report:metrics` - Tool-level savings + adoption analysis
 - `npm run report:workflows` - Workflow-level savings (requires `DEVCTX_WORKFLOW_TRACKING=true`)
 
@@ -105,16 +105,11 @@ Production usage: **14.5M tokens → 1.6M tokens** (89.87% reduction)
 
 ## Verify It's Working
 
-### Real-Time Feedback (Auto-enabled for First 10 Calls)
+### Real-Time Feedback (Enabled by Default)
 
-Feedback is **automatically enabled** for your first 10 tool calls (onboarding mode), then auto-disables.
+Feedback is **enabled by default** and shows after every devctx tool call.
 
-**To keep it enabled permanently:**
-```bash
-export DEVCTX_SHOW_USAGE=true
-```
-
-**To disable immediately:**
+**To disable:**
 ```bash
 export DEVCTX_SHOW_USAGE=false
 ```
@@ -130,7 +125,7 @@ You'll see at the end of agent responses:
 
 **Total saved:** ~57.0K tokens
 
-*Onboarding mode: showing for 3 more tool calls. To keep: `export DEVCTX_SHOW_USAGE=true`*
+*To disable this message: `export DEVCTX_SHOW_USAGE=false`*
 ```
 
 **Why this is useful:**
@@ -203,12 +198,12 @@ You'll see warnings like:
 - Low adoption (<30%)
 - Usage dropped mid-session
 
-**Combine all features:**
+**All features enabled by default.** To disable:
 
 ```bash
-export DEVCTX_SHOW_USAGE=true    # See what's used
-export DEVCTX_EXPLAIN=true       # Understand why
-export DEVCTX_DETECT_MISSED=true # Detect gaps
+export DEVCTX_SHOW_USAGE=false
+export DEVCTX_EXPLAIN=false
+export DEVCTX_DETECT_MISSED=false
 ```
 
 ## MCP Prompts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smart-context-mcp",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "MCP server that reduces agent token usage by 90% with intelligent context compression, task checkpoint persistence, and workflow-aware agent guidance.",
   "author": "Francisco Caballero Portero <fcp1978@hotmail.com>",
   "type": "module",

package/src/decision-explainer.js

@@ -1,7 +1,7 @@
 /**
  * Decision explainer - tracks and explains why devctx tools were used or not used
  * 
- * Enable with environment variable: DEVCTX_EXPLAIN=true
+ * ENABLED BY DEFAULT - disable with: DEVCTX_EXPLAIN=false
  * 
  * Provides transparency into agent decision-making:
  * - Why was smart_read used instead of Read?
@@ -11,17 +11,37 @@
 
 const sessionDecisions = {
   decisions: [],
-  enabled: false,
+  enabled: true, // Changed: enabled by default
 };
 
 /**
  * Check if explanations are enabled
  */
+/**
+ * Check if decision explanations are enabled
+ * 
+ * Priority:
+ * 1. Explicit env var (DEVCTX_EXPLAIN=true/false)
+ * 2. Default: ENABLED (changed from disabled)
+ */
 export const isExplainEnabled = () => {
   const envValue = process.env.DEVCTX_EXPLAIN?.toLowerCase();
-  const enabled = envValue === 'true' || envValue === '1' || envValue === 'yes';
-  sessionDecisions.enabled = enabled;
-  return enabled;
+  
+  // Explicit enable
+  if (envValue === 'true' || envValue === '1' || envValue === 'yes') {
+    sessionDecisions.enabled = true;
+    return true;
+  }
+  
+  // Explicit disable
+  if (envValue === 'false' || envValue === '0' || envValue === 'no') {
+    sessionDecisions.enabled = false;
+    return false;
+  }
+  
+  // Default: ENABLED (changed)
+  sessionDecisions.enabled = true;
+  return true;
 };
 
 /**
@@ -100,6 +120,7 @@ export const formatDecisionExplanations = () => {
  */
 export const resetSessionDecisions = () => {
   sessionDecisions.decisions = [];
+  sessionDecisions.enabled = true; // Reset to default (enabled)
 };
 
 /**

package/src/missed-opportunities.js

@@ -3,7 +3,7 @@
  * 
  * Analyzes session metrics to detect patterns where devctx would have helped.
  * 
- * Enable with environment variable: DEVCTX_DETECT_MISSED=true
+ * ENABLED BY DEFAULT - disable with: DEVCTX_DETECT_MISSED=false
  * 
  * Detection heuristics (based on session metrics):
  * - Low devctx adoption in complex sessions (many operations, few devctx calls)
@@ -19,7 +19,7 @@ const sessionActivity = {
   totalOperations: 0, // Estimated from devctx calls + time-based heuristic
   lastDevctxCall: 0,
   sessionStart: Date.now(),
-  enabled: false,
+  enabled: true, // Changed: enabled by default
   warnings: [],
 };
 
@@ -36,12 +36,29 @@ const DEVCTX_TOOLS = new Set([
 
 /**
  * Check if missed opportunity detection is enabled
+ * 
+ * Priority:
+ * 1. Explicit env var (DEVCTX_DETECT_MISSED=true/false)
+ * 2. Default: ENABLED (changed from disabled)
  */
 export const isMissedDetectionEnabled = () => {
   const envValue = process.env.DEVCTX_DETECT_MISSED?.toLowerCase();
-  const enabled = envValue === 'true' || envValue === '1' || envValue === 'yes';
-  sessionActivity.enabled = enabled;
-  return enabled;
+  
+  // Explicit enable
+  if (envValue === 'true' || envValue === '1' || envValue === 'yes') {
+    sessionActivity.enabled = true;
+    return true;
+  }
+  
+  // Explicit disable
+  if (envValue === 'false' || envValue === '0' || envValue === 'no') {
+    sessionActivity.enabled = false;
+    return false;
+  }
+  
+  // Default: ENABLED (changed)
+  sessionActivity.enabled = true;
+  return true;
 };
 
 /**
@@ -152,8 +169,18 @@ export const formatMissedOpportunities = () => {
   const analysis = analyzeMissedOpportunities();
   if (!analysis) return '';
   
-  // Don't show if session is too short or no opportunities
-  if (analysis.message || analysis.opportunities.length === 0) {
+  // Show session too short message (but don't show full warning)
+  if (analysis.message) {
+    return '';
+  }
+  
+  // If no opportunities but session is active, show positive feedback
+  if (analysis.opportunities.length === 0 && analysis.devctxOperations > 0) {
+    return `\n\n✅ **devctx adoption: ${analysis.devctxRatio}%** (${analysis.devctxOperations}/${analysis.estimatedTotal} operations)\n`;
+  }
+  
+  // No opportunities and no devctx usage - don't show yet (wait for longer session)
+  if (analysis.opportunities.length === 0) {
     return '';
   }
   
@@ -222,6 +249,7 @@ export const resetSessionActivity = () => {
   sessionActivity.lastDevctxCall = 0;
   sessionActivity.sessionStart = Date.now();
   sessionActivity.warnings = [];
+  sessionActivity.enabled = true; // Reset to default (enabled)
 };
 
 /**

package/src/usage-feedback.js

@@ -2,19 +2,17 @@
  * Usage feedback system - tracks devctx tool usage in current session
  * and provides visible feedback to users about what tools were used and tokens saved.
  * 
- * Enable with environment variable: DEVCTX_SHOW_USAGE=true
+ * ENABLED BY DEFAULT - disable with: DEVCTX_SHOW_USAGE=false
  * 
- * Auto-enabled for first 10 tool calls (onboarding mode), then auto-disables.
- * User can explicitly enable/disable at any time.
+ * Shows feedback after every devctx tool call to ensure visibility.
+ * User can explicitly disable if they find it too verbose.
  */
 
 const sessionUsage = {
   tools: new Map(), // toolName -> { count, savedTokens }
   totalSavedTokens: 0,
-  enabled: false,
+  enabled: true, // Changed: enabled by default
   totalToolCalls: 0,
-  onboardingMode: true,
-  ONBOARDING_THRESHOLD: 10, // Auto-disable after 10 tool calls
 };
 
 /**
@@ -22,8 +20,7 @@ const sessionUsage = {
  * 
  * Priority:
  * 1. Explicit env var (DEVCTX_SHOW_USAGE=true/false)
- * 2. Onboarding mode (first 10 tool calls)
- * 3. Default: disabled
+ * 2. Default: ENABLED (changed from disabled)
  */
 export const isFeedbackEnabled = () => {
   const envValue = process.env.DEVCTX_SHOW_USAGE?.toLowerCase();
@@ -31,30 +28,18 @@ export const isFeedbackEnabled = () => {
   // Explicit enable
   if (envValue === 'true' || envValue === '1' || envValue === 'yes') {
     sessionUsage.enabled = true;
-    sessionUsage.onboardingMode = false;
     return true;
   }
   
   // Explicit disable
   if (envValue === 'false' || envValue === '0' || envValue === 'no') {
     sessionUsage.enabled = false;
-    sessionUsage.onboardingMode = false;
     return false;
   }
   
-  // Onboarding mode: auto-enable for first N tool calls
-  if (sessionUsage.onboardingMode && sessionUsage.totalToolCalls < sessionUsage.ONBOARDING_THRESHOLD) {
-    sessionUsage.enabled = true;
-    return true;
-  }
-  
-  // After onboarding threshold, auto-disable
-  if (sessionUsage.onboardingMode && sessionUsage.totalToolCalls >= sessionUsage.ONBOARDING_THRESHOLD) {
-    sessionUsage.enabled = false;
-    sessionUsage.onboardingMode = false;
-  }
-  
-  return sessionUsage.enabled;
+  // Default: ENABLED (changed)
+  sessionUsage.enabled = true;
+  return true;
 };
 
 /**
@@ -128,14 +113,7 @@ export const formatUsageFeedback = () => {
   }
   
   lines.push('');
-  
-  // Show onboarding message if in onboarding mode
-  if (sessionUsage.onboardingMode && sessionUsage.totalToolCalls < sessionUsage.ONBOARDING_THRESHOLD) {
-    const remaining = sessionUsage.ONBOARDING_THRESHOLD - sessionUsage.totalToolCalls;
-    lines.push(`*Onboarding mode: showing for ${remaining} more tool calls. To keep: \`export DEVCTX_SHOW_USAGE=true\`*`);
-  } else {
-    lines.push('*To disable this message: `export DEVCTX_SHOW_USAGE=false`*');
-  }
+  lines.push('*To disable this message: `export DEVCTX_SHOW_USAGE=false`*');
   
   return lines.join('\n');
 };
@@ -147,7 +125,7 @@ export const resetSessionUsage = () => {
   sessionUsage.tools.clear();
   sessionUsage.totalSavedTokens = 0;
   sessionUsage.totalToolCalls = 0;
-  sessionUsage.onboardingMode = true;
+  sessionUsage.enabled = true; // Reset to default (enabled)
 };
 
 /**