thumbgate 1.10.1 → 1.11.0

package/.claude-plugin/marketplace.json

@@ -1,6 +1,6 @@
 {
   "name": "thumbgate-marketplace",
-  "version": "1.10.1",
+  "version": "1.11.0",
   "owner": {
     "name": "Igor Ganapolsky",
     "email": "ig5973700@gmail.com"
@@ -13,7 +13,7 @@
         "source": "npm",
         "package": "thumbgate"
       },
-      "version": "1.10.1",
+      "version": "1.11.0",
       "author": {
         "name": "Igor Ganapolsky"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "thumbgate",
   "description": "Type 👍 or 👎 on any agent action. ThumbGate captures it, distills a lesson, and blocks the pattern from repeating. One thumbs-down = the agent physically cannot make that mistake again. 33 pre-action gates, budget enforcement, self-protection, and NIST/SOC2 compliance tags.",
-  "version": "1.10.1",
+  "version": "1.11.0",
   "author": {
     "name": "Igor Ganapolsky"
   },

package/.well-known/llms.txt

@@ -48,6 +48,7 @@ npx thumbgate init --agent claude-code
 
 - Agent discovery: https://thumbgate-production.up.railway.app/.well-known/mcp.json
 - Progressive tool index: https://thumbgate-production.up.railway.app/.well-known/mcp/tools.json
+- Context footprint report: https://thumbgate-production.up.railway.app/.well-known/mcp/footprint.json
 - Agent skills: https://thumbgate-production.up.railway.app/.well-known/mcp/skills.json
 - MCP applications: https://thumbgate-production.up.railway.app/.well-known/mcp/applications.json
 - Documentation: https://thumbgate-production.up.railway.app/guide

package/.well-known/mcp/server-card.json

@@ -1,6 +1,6 @@
 {
   "name": "thumbgate",
-  "version": "1.10.1",
+  "version": "1.11.0",
   "description": "ThumbGate — 👍👎 feedback that teaches your AI agent. Thumbs down a mistake, it never happens again.",
   "homepage": "https://thumbgate-production.up.railway.app",
   "transport": "stdio",
@@ -8,6 +8,7 @@
     "manifestUrl": "https://thumbgate-production.up.railway.app/.well-known/mcp.json",
     "toolIndexUrl": "https://thumbgate-production.up.railway.app/.well-known/mcp/tools.json",
     "toolSchemaUrlTemplate": "https://thumbgate-production.up.railway.app/.well-known/mcp/tools/{name}.json",
+    "footprintUrl": "https://thumbgate-production.up.railway.app/.well-known/mcp/footprint.json",
     "skillsUrl": "https://thumbgate-production.up.railway.app/.well-known/mcp/skills.json",
     "applicationsUrl": "https://thumbgate-production.up.railway.app/.well-known/mcp/applications.json"
   }

package/adapters/README.md

@@ -3,7 +3,7 @@
 - `chatgpt/openapi.yaml`: import into GPT Actions.
 - `gemini/function-declarations.json`: Gemini function-calling definitions.
 - `mcp/server-stdio.js`: underlying local MCP stdio server implementation.
-- `claude/.mcp.json`: example Claude Code MCP config using `npx --yes --package thumbgate@1.10.1 thumbgate serve`.
+- `claude/.mcp.json`: example Claude Code MCP config using `npx --yes --package thumbgate@1.11.0 thumbgate serve`.
 - `codex/config.toml`: example Codex MCP profile section using the same version-pinned portable launcher.
 - `amp/skills/thumbgate-feedback/SKILL.md`: Amp skill template.
 - `opencode/opencode.json`: portable OpenCode MCP profile using the same version-pinned portable launcher.

package/adapters/claude/.mcp.json

@@ -2,13 +2,13 @@
   "mcpServers": {
     "thumbgate": {
       "command": "npx",
-      "args": ["--yes", "--package", "thumbgate@1.10.1", "thumbgate", "serve"]
+      "args": ["--yes", "--package", "thumbgate@1.11.0", "thumbgate", "serve"]
     }
   },
   "hooks": {
     "preToolUse": {
       "command": "npx",
-      "args": ["--yes", "--package", "thumbgate@1.10.1", "thumbgate", "gate-check"]
+      "args": ["--yes", "--package", "thumbgate@1.11.0", "thumbgate", "gate-check"]
     }
   }
 }

package/adapters/mcp/server-stdio.js

@@ -122,6 +122,7 @@ const {
 } = require('../../scripts/natural-language-harness');
 const { runLoop: runAutoresearchLoop } = require('../../scripts/autoresearch-runner');
 const { TOOLS } = require('../../scripts/tool-registry');
+const { buildContextFootprintReport } = require('../../scripts/context-footprint');
 const { reflect: reflectOnFeedback } = require('../../scripts/reflector-agent');
 const { submitProductIssue } = require('../../scripts/product-feedback');
 const {
@@ -152,7 +153,7 @@ const {
   finalizeSession: finalizeFeedbackSession,
 } = require('../../scripts/feedback-session');
 
-const SERVER_INFO = { name: 'thumbgate-mcp', version: '1.10.1' };
+const SERVER_INFO = { name: 'thumbgate-mcp', version: '1.11.0' };
 const COMMERCE_CATEGORIES = [
   'product_recommendation',
   'brand_compliance',
@@ -493,6 +494,7 @@ async function callTool(name, args = {}) {
 }
 
 async function callToolInner(name, args) {
+  args = args || {};
   // Semantic Aliases for high-level branding alignment
   if (name === 'capture_memory_feedback') name = 'capture_feedback';
   if (name === 'get_reliability_rules') name = 'prevention_rules';
@@ -868,6 +870,17 @@ async function callToolInner(name, args) {
       return toTextResult(runHarness(args.harness, args.inputs || {}, { jobId: args.jobId }));
     case 'plan_multimodal_retrieval':
       return toTextResult(buildMultimodalRetrievalPlan(args));
+    case 'plan_context_footprint':
+      return toTextResult(buildContextFootprintReport({
+        tools: TOOLS,
+        entries: Array.isArray(args.entries) ? args.entries : undefined,
+        anchors: Array.isArray(args.anchors) ? args.anchors : undefined,
+        schemaUrlTemplate: args.schemaUrlTemplate || '/.well-known/mcp/tools/{name}.json',
+        targetReduction: args.targetReduction,
+        windowSize: args.windowSize,
+        perEntryMaxChars: args.perEntryMaxChars,
+        totalMaxChars: args.totalMaxChars,
+      }));
     case 'run_autoresearch': {
       const iterations = Math.max(1, Math.min(5, Number(args.iterations || 1)));
       const timeoutMs = Math.max(1000, Math.min(600000, Number(args.timeoutMs || 120000)));

package/adapters/opencode/opencode.json

@@ -7,7 +7,7 @@
         "npx",
         "--yes",
         "--package",
-        "thumbgate@1.10.1",
+        "thumbgate@1.11.0",
         "thumbgate",
         "serve"
       ],

package/config/mcp-allowlists.json

@@ -13,6 +13,7 @@
       "retrieve_lessons",
       "search_thumbgate",
       "plan_multimodal_retrieval",
+      "plan_context_footprint",
       "reflect_on_feedback",
       "feedback_stats",
       "diagnose_failure",
@@ -73,6 +74,7 @@
       "retrieve_lessons",
       "search_thumbgate",
       "plan_multimodal_retrieval",
+      "plan_context_footprint",
       "reflect_on_feedback",
       "prevention_rules",
       "set_task_scope",
@@ -118,6 +120,7 @@
       "retrieve_lessons",
       "search_thumbgate",
       "plan_multimodal_retrieval",
+      "plan_context_footprint",
       "feedback_stats",
       "diagnose_failure",
       "list_harnesses",
@@ -151,6 +154,7 @@
       "retrieve_lessons",
       "search_thumbgate",
       "plan_multimodal_retrieval",
+      "plan_context_footprint",
       "feedback_stats",
       "diagnose_failure",
       "list_harnesses",
@@ -180,6 +184,7 @@
       "search_lessons",
       "retrieve_lessons",
       "search_thumbgate",
+      "plan_context_footprint",
       "diagnose_failure",
       "list_intents",
       "plan_intent",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thumbgate",
-  "version": "1.10.1",
+  "version": "1.11.0",
   "description": "Self-improving agent governance: type thumbs-up or thumbs-down on any AI agent action. ThumbGate turns every mistake into a prevention rule and blocks the pattern from repeating. One thumbs-down, never again. 33 pre-action gates, budget enforcement, and self-protection for Claude Code, Cursor, Codex, Gemini CLI, and Amp.",
   "homepage": "https://thumbgate-production.up.railway.app",
   "repository": {
@@ -76,6 +76,7 @@
     "scripts/conversation-context.js",
     "scripts/creator-campaigns.js",
     "scripts/cross-encoder-reranker.js",
+    "scripts/context-footprint.js",
     "scripts/daemon-manager.js",
     "scripts/dashboard-render-spec.js",
     "scripts/dashboard.js",
@@ -293,7 +294,7 @@
     "test:pulse": "node --test tests/pulse.test.js",
     "test:semantic-layer": "node --test tests/semantic-layer.test.js",
     "test:data-pipeline": "node --test tests/data-pipeline.test.js",
-    "test:optimize-context": "node --test tests/optimize-context.test.js",
+    "test:optimize-context": "node --test tests/optimize-context.test.js tests/context-footprint.test.js",
     "test:principle-extractor": "node --test tests/principle-extractor.test.js",
     "test:analytics-window": "node --test tests/analytics-window.test.js",
     "test:funnel-analytics": "node --test tests/funnel-analytics.test.js",

package/public/index.html

@@ -974,7 +974,7 @@ __GA_BOOTSTRAP__
 <!-- HOW IT WORKS -->
 <section class="how-it-works" id="how-it-works">
   <div class="container">
-    <div class="section-label">New in v1.10.1</div>
+    <div class="section-label">New in v1.11.0</div>
     <h2 class="section-title">Three steps to stop repeated AI failures</h2>
     <div class="steps">
       <div class="step">
@@ -1330,7 +1330,7 @@ __GA_BOOTSTRAP__
       <a href="https://www.linkedin.com/in/igorganapolsky" target="_blank" rel="noopener">LinkedIn</a>
       <a href="/blog">Blog</a>
     </div>
-    <span class="footer-copy">© 2026 Max Smith KDP LLC · MIT License · v1.10.1</span>
+    <span class="footer-copy">© 2026 Max Smith KDP LLC · MIT License · v1.11.0</span>
   </div>
 </footer>
 

package/scripts/context-footprint.js

@@ -0,0 +1,191 @@
+'use strict';
+
+const DEFAULT_CHARS_PER_TOKEN = 4;
+const DEFAULT_TARGET_REDUCTION = 0.22;
+
+function normalizeRatio(value, fallback = DEFAULT_TARGET_REDUCTION) {
+  const n = Number(value);
+  if (!Number.isFinite(n) || n < 0) return fallback;
+  if (n > 1) return n / 100;
+  return n;
+}
+
+function stablePayload(value) {
+  if (typeof value === 'string') return value;
+  return JSON.stringify(value == null ? '' : value, null, 2);
+}
+
+function estimateTokens(value, charsPerToken = DEFAULT_CHARS_PER_TOKEN) {
+  const payload = stablePayload(value);
+  const divisor = Math.max(1, Number(charsPerToken) || DEFAULT_CHARS_PER_TOKEN);
+  return Math.ceil(payload.length / divisor);
+}
+
+function measureFootprint(baseline, optimized, options = {}) {
+  const baselinePayload = stablePayload(baseline);
+  const optimizedPayload = stablePayload(optimized);
+  const baselineBytes = Buffer.byteLength(baselinePayload, 'utf8');
+  const optimizedBytes = Buffer.byteLength(optimizedPayload, 'utf8');
+  const baselineTokens = estimateTokens(baselinePayload, options.charsPerToken);
+  const optimizedTokens = estimateTokens(optimizedPayload, options.charsPerToken);
+  const bytesSaved = Math.max(0, baselineBytes - optimizedBytes);
+  const tokensSaved = Math.max(0, baselineTokens - optimizedTokens);
+  const reductionRatio = baselineBytes > 0 ? bytesSaved / baselineBytes : 0;
+
+  return {
+    baseline: {
+      bytes: baselineBytes,
+      estimatedTokens: baselineTokens,
+    },
+    optimized: {
+      bytes: optimizedBytes,
+      estimatedTokens: optimizedTokens,
+    },
+    savings: {
+      bytes: bytesSaved,
+      estimatedTokens: tokensSaved,
+      reductionRatio,
+      reductionPercent: Number((reductionRatio * 100).toFixed(1)),
+      targetMet: reductionRatio >= normalizeRatio(options.targetReduction),
+    },
+  };
+}
+
+function toolSchemaUrl(schemaUrlTemplate, toolName) {
+  const encodedName = encodeURIComponent(String(toolName || ''));
+  const template = String(schemaUrlTemplate || '/.well-known/mcp/tools/{name}.json');
+  return template.includes('{name}')
+    ? template.replace('{name}', encodedName)
+    : `${template.replace(/\/$/, '')}/${encodedName}.json`;
+}
+
+function normalizeToolForFullManifest(tool) {
+  return {
+    name: tool.name,
+    description: tool.description,
+    annotations: tool.annotations || {},
+    inputSchema: tool.inputSchema || {},
+  };
+}
+
+function normalizeToolForProgressiveManifest(tool, schemaUrlTemplate) {
+  return {
+    name: tool.name,
+    description: tool.description,
+    annotations: tool.annotations || {},
+    schemaUrl: toolSchemaUrl(schemaUrlTemplate, tool.name),
+  };
+}
+
+function buildMcpToolFootprintReport(tools = [], options = {}) {
+  const toolList = Array.isArray(tools) ? tools : [];
+  const schemaUrlTemplate = options.schemaUrlTemplate || '/.well-known/mcp/tools/{name}.json';
+  const baseline = {
+    pattern: 'preload-all-tool-schemas',
+    tools: toolList.map(normalizeToolForFullManifest),
+  };
+  const optimized = {
+    pattern: 'progressive-tool-discovery',
+    tools: toolList.map((tool) => normalizeToolForProgressiveManifest(tool, schemaUrlTemplate)),
+  };
+
+  return {
+    kind: 'mcp-tool-discovery',
+    strategy: 'lossless-progressive-disclosure',
+    toolCount: toolList.length,
+    qualityContract: {
+      behaviorPreserved: true,
+      reason: 'Each omitted inputSchema is still available through the tool schema URL.',
+      schemaUrlTemplate,
+    },
+    footprint: measureFootprint(baseline, optimized, {
+      targetReduction: options.targetReduction,
+      charsPerToken: options.charsPerToken,
+    }),
+  };
+}
+
+function buildFeedbackContextFootprintReport(entries = [], anchors = [], options = {}) {
+  const { compactContext } = require('./context-engine');
+  const safeEntries = Array.isArray(entries) ? entries : [];
+  const safeAnchors = Array.isArray(anchors) ? anchors : [];
+  const compaction = compactContext(safeEntries, safeAnchors, {
+    windowSize: options.windowSize,
+    perEntryMaxChars: options.perEntryMaxChars,
+    totalMaxChars: options.totalMaxChars,
+  });
+
+  const anchorIds = new Set(safeAnchors.map((entry) => entry && entry.id).filter(Boolean));
+  const optimizedAnchorIds = new Set(compaction.entries.map((entry) => entry && entry.id).filter(Boolean));
+  const anchorsPreserved = Array.from(anchorIds).every((id) => optimizedAnchorIds.has(id));
+
+  return {
+    kind: 'feedback-context-compaction',
+    strategy: 'bounded-context-compaction',
+    qualityContract: {
+      behaviorPreserved: false,
+      anchorsPreserved,
+      reason: 'Feedback context is intentionally bounded; anchor entries are preserved while stale or duplicate entries are removed.',
+    },
+    compaction: {
+      stage: compaction.stage,
+      removedCount: compaction.removedCount,
+      compacted: compaction.compacted,
+      baselineItems: safeEntries.length,
+      optimizedItems: compaction.entries.length,
+    },
+    footprint: measureFootprint(safeEntries, compaction.entries, {
+      targetReduction: options.targetReduction,
+      charsPerToken: options.charsPerToken,
+    }),
+  };
+}
+
+function buildContextFootprintReport(options = {}) {
+  const targetReduction = normalizeRatio(options.targetReduction);
+  const report = {
+    name: 'thumbgate-context-footprint',
+    targetReduction,
+    sourcePattern: 'Compress the bottleneck without changing the behavior agents rely on.',
+    recommendations: [
+      'Load the MCP tool index first; fetch one tool schema only when the agent selects that tool.',
+      'Use construct_context_pack with maxChars before injecting lessons into a model prompt.',
+      'Keep gate ids, proof URLs, and anchor lessons stable so compaction does not hide evidence.',
+      'Track estimated token savings beside every optimized context path.',
+    ],
+  };
+
+  if (Array.isArray(options.tools)) {
+    report.mcpToolDiscovery = buildMcpToolFootprintReport(options.tools, {
+      schemaUrlTemplate: options.schemaUrlTemplate,
+      targetReduction,
+      charsPerToken: options.charsPerToken,
+    });
+  }
+
+  if (Array.isArray(options.entries)) {
+    report.feedbackContext = buildFeedbackContextFootprintReport(
+      options.entries,
+      options.anchors,
+      {
+        windowSize: options.windowSize,
+        perEntryMaxChars: options.perEntryMaxChars,
+        totalMaxChars: options.totalMaxChars,
+        targetReduction,
+        charsPerToken: options.charsPerToken,
+      },
+    );
+  }
+
+  return report;
+}
+
+module.exports = {
+  DEFAULT_CHARS_PER_TOKEN,
+  DEFAULT_TARGET_REDUCTION,
+  estimateTokens,
+  measureFootprint,
+  buildMcpToolFootprintReport,
+  buildFeedbackContextFootprintReport,
+  buildContextFootprintReport,
+};

package/scripts/tool-registry.js

@@ -153,6 +153,45 @@ const TOOLS = [
       },
     },
   }),
+  readOnlyTool({
+    name: 'plan_context_footprint',
+    description: 'Estimate MCP schema and feedback-context footprint before loading large manifests into an agent prompt. Reports progressive-discovery savings, context compaction savings, and proof-preserving recommendations.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        entries: {
+          type: 'array',
+          description: 'Optional feedback/context entries to compact and measure.',
+          items: { type: 'object' },
+        },
+        anchors: {
+          type: 'array',
+          description: 'Optional entries that must survive compaction.',
+          items: { type: 'object' },
+        },
+        schemaUrlTemplate: {
+          type: 'string',
+          description: 'Template for progressive MCP tool schema URLs, using {name}.',
+        },
+        targetReduction: {
+          type: 'number',
+          description: 'Target footprint reduction as a ratio or percentage. Default: 0.22.',
+        },
+        windowSize: {
+          type: 'number',
+          description: 'Feedback compaction recency window.',
+        },
+        perEntryMaxChars: {
+          type: 'number',
+          description: 'Maximum characters retained per large feedback field.',
+        },
+        totalMaxChars: {
+          type: 'number',
+          description: 'Optional total character budget for compacted feedback entries.',
+        },
+      },
+    },
+  }),
   destructiveTool({
     name: 'import_document',
     description: 'Import a local policy or runbook document into ThumbGate, normalize it for search, and propose provenance-backed gate candidates.',

package/src/api/server.js

@@ -208,6 +208,9 @@ const {
 } = require('../../scripts/rate-limiter');
 const { sendProblem, PROBLEM_TYPES } = require('../../scripts/problem-detail');
 const { TOOLS: MCP_TOOLS } = require('../../scripts/tool-registry');
+const {
+  buildContextFootprintReport,
+} = require('../../scripts/context-footprint');
 const {
   findSeoPageByPath,
   renderSeoPageHtml,
@@ -567,6 +570,13 @@ function getToolDiscoveryIndex(hostedConfig) {
   }));
 }
 
+function getContextFootprintReport(hostedConfig) {
+  return buildContextFootprintReport({
+    tools: MCP_TOOLS,
+    schemaUrlTemplate: buildPublicUrl(hostedConfig, '/.well-known/mcp/tools/{name}.json'),
+  });
+}
+
 function getMcpSkillManifests(hostedConfig) {
   return [
     {
@@ -611,6 +621,21 @@ function getMcpSkillManifests(hostedConfig) {
       contextUrl: buildPublicUrl(hostedConfig, '/public/llm-context.md'),
       proofUrl: VERIFICATION_EVIDENCE_URL,
     },
+    {
+      name: 'context-footprint-optimizer',
+      title: 'Context Footprint Optimizer',
+      description: 'Measure MCP schema payloads and feedback-context packs before spending model context on them.',
+      triggers: ['context compression', 'token savings', 'progressive discovery', 'MCP schema loading', 'context budget'],
+      recommendedFlow: [
+        'Measure full schema or memory payload footprint.',
+        'Load the slim index first, then fetch only selected tool schemas.',
+        'Compact feedback context with anchors for proof-critical lessons.',
+        'Record estimated token savings next to the workflow evidence.',
+      ],
+      contextUrl: buildPublicUrl(hostedConfig, '/public/llm-context.md'),
+      footprintUrl: buildPublicUrl(hostedConfig, '/.well-known/mcp/footprint.json'),
+      proofUrl: VERIFICATION_EVIDENCE_URL,
+    },
   ];
 }
 
@@ -671,6 +696,7 @@ function getMcpDiscoveryManifest(hostedConfig) {
       serverCardUrl: buildPublicUrl(hostedConfig, '/.well-known/mcp/server-card.json'),
       toolIndexUrl: buildPublicUrl(hostedConfig, '/.well-known/mcp/tools.json'),
       toolSchemaUrlTemplate: buildPublicUrl(hostedConfig, '/.well-known/mcp/tools/{name}.json'),
+      footprintUrl: buildPublicUrl(hostedConfig, '/.well-known/mcp/footprint.json'),
       skillsUrl: buildPublicUrl(hostedConfig, '/.well-known/mcp/skills.json'),
       applicationsUrl: buildPublicUrl(hostedConfig, '/.well-known/mcp/applications.json'),
       llmsTxtUrl: buildPublicUrl(hostedConfig, '/.well-known/llms.txt'),
@@ -705,9 +731,15 @@ function getMcpDiscoveryManifest(hostedConfig) {
         description: 'Plan screenshot/PDF/proof-artifact retrieval before investing in multimodal finetuning.',
         tools: ['plan_multimodal_retrieval', 'search_thumbgate', 'construct_context_pack', 'require_evidence_for_claim'],
       },
+      {
+        name: 'context-footprint-optimizer',
+        description: 'Measure MCP schema and feedback-context footprint before loading large manifests into model context.',
+        tools: ['plan_context_footprint', 'construct_context_pack', 'context_provenance'],
+      },
     ],
     skills: getMcpSkillManifests(hostedConfig),
     applications: getMcpApplications(hostedConfig),
+    footprint: getContextFootprintReport(hostedConfig),
     proof: {
       verificationEvidenceUrl: VERIFICATION_EVIDENCE_URL,
       llmContextUrl: buildPublicUrl(hostedConfig, '/public/llm-context.md'),
@@ -4086,6 +4118,17 @@ async function addContext(){
       return;
     }
 
+    if (isGetLikeRequest && pathname === '/.well-known/mcp/footprint.json') {
+      sendJson(res, 200, {
+        name: 'thumbgate',
+        version: pkg.version,
+        ...getContextFootprintReport(hostedConfig),
+      }, {}, {
+        headOnly: isHeadRequest,
+      });
+      return;
+    }
+
     if (isGetLikeRequest && pathname.startsWith('/.well-known/mcp/tools/') && pathname.endsWith('.json')) {
       const encodedToolName = pathname.slice('/.well-known/mcp/tools/'.length, -'.json'.length);
       let toolName = encodedToolName;
@@ -4156,6 +4199,7 @@ async function addContext(){
         version: pkg.version,
         transport: discoveryManifest.transport,
         discovery: discoveryManifest.discovery,
+        footprint: discoveryManifest.footprint,
         tools: getServerCardTools(),
         skills: getMcpSkillManifests(hostedConfig),
         applications: getMcpApplications(hostedConfig),