thumbgate 1.27.18 → 1.27.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (96) hide show
  1. package/.claude-plugin/marketplace.json +6 -6
  2. package/.claude-plugin/plugin.json +4 -3
  3. package/.well-known/agentic-verify.txt +1 -0
  4. package/.well-known/llms.txt +33 -12
  5. package/.well-known/mcp/server-card.json +8 -8
  6. package/README.md +249 -30
  7. package/adapters/chatgpt/openapi.yaml +12 -0
  8. package/adapters/claude/.mcp.json +2 -2
  9. package/adapters/codex/config.toml +2 -2
  10. package/adapters/gemini/function-declarations.json +1 -0
  11. package/adapters/mcp/server-stdio.js +263 -11
  12. package/adapters/opencode/opencode.json +1 -1
  13. package/bench/thumbgate-bench.json +2 -2
  14. package/bin/cli.js +1429 -121
  15. package/bin/postinstall.js +1 -8
  16. package/config/gate-classifier-routing.json +98 -0
  17. package/config/gate-templates.json +216 -0
  18. package/config/gates/claim-verification.json +12 -0
  19. package/config/gates/default.json +31 -2
  20. package/config/github-about.json +2 -2
  21. package/config/mcp-allowlists.json +23 -13
  22. package/config/merge-quality-checks.json +0 -1
  23. package/config/model-candidates.json +121 -6
  24. package/config/post-deploy-marketing-pages.json +80 -0
  25. package/config/tessl-tiles.json +1 -3
  26. package/openapi/openapi.yaml +12 -0
  27. package/package.json +1 -1
  28. package/public/blog.html +4 -4
  29. package/public/codex-plugin.html +72 -20
  30. package/public/compare.html +31 -8
  31. package/public/dashboard.html +930 -166
  32. package/public/federal.html +2 -2
  33. package/public/guide.html +33 -13
  34. package/public/index.html +469 -111
  35. package/public/learn.html +183 -18
  36. package/public/lessons.html +168 -10
  37. package/public/numbers.html +7 -7
  38. package/public/pro.html +34 -11
  39. package/scripts/agent-memory-lifecycle.js +211 -0
  40. package/scripts/agent-readiness.js +20 -3
  41. package/scripts/agent-reward-model.js +53 -1
  42. package/scripts/auto-promote-gates.js +82 -10
  43. package/scripts/auto-wire-hooks.js +14 -0
  44. package/scripts/billing.js +93 -1
  45. package/scripts/bot-detection.js +61 -3
  46. package/scripts/build-metadata.js +50 -10
  47. package/scripts/cli-feedback.js +4 -2
  48. package/scripts/cli-schema.js +97 -0
  49. package/scripts/cli-telemetry.js +6 -1
  50. package/scripts/commercial-offer.js +82 -2
  51. package/scripts/context-manager.js +74 -6
  52. package/scripts/dashboard.js +68 -2
  53. package/scripts/export-databricks-bundle.js +5 -1
  54. package/scripts/export-dpo-pairs.js +7 -2
  55. package/scripts/feedback-loop.js +123 -1
  56. package/scripts/feedback-quality.js +87 -0
  57. package/scripts/filesystem-search.js +35 -10
  58. package/scripts/gate-stats.js +89 -0
  59. package/scripts/gates-engine.js +1176 -85
  60. package/scripts/gemini-embedding-policy.js +2 -1
  61. package/scripts/hook-runtime.js +20 -14
  62. package/scripts/hook-thumbgate-cache-updater.js +18 -2
  63. package/scripts/hybrid-feedback-context.js +142 -7
  64. package/scripts/lesson-inference.js +8 -3
  65. package/scripts/lesson-search.js +17 -1
  66. package/scripts/license.js +10 -10
  67. package/scripts/llm-client.js +169 -4
  68. package/scripts/local-model-profile.js +15 -8
  69. package/scripts/mcp-config.js +7 -1
  70. package/scripts/memory-scope-readiness.js +159 -0
  71. package/scripts/meta-agent-loop.js +36 -0
  72. package/scripts/operational-integrity.js +39 -5
  73. package/scripts/oss-pr-opportunity-scout.js +35 -5
  74. package/scripts/plausible-server-events.js +9 -6
  75. package/scripts/pro-local-dashboard.js +4 -4
  76. package/scripts/proxy-pointer-rag-guardrails.js +42 -1
  77. package/scripts/published-cli.js +0 -8
  78. package/scripts/rate-limiter.js +64 -13
  79. package/scripts/secret-scanner.js +44 -5
  80. package/scripts/security-scanner.js +260 -10
  81. package/scripts/self-distill-agent.js +3 -1
  82. package/scripts/seo-gsd.js +916 -7
  83. package/scripts/statusline-cache-path.js +17 -2
  84. package/scripts/statusline-local-stats.js +9 -1
  85. package/scripts/statusline-meta.js +28 -2
  86. package/scripts/statusline.sh +20 -4
  87. package/scripts/telemetry-analytics.js +357 -0
  88. package/scripts/thompson-sampling.js +31 -10
  89. package/scripts/thumbgate-bench.js +16 -1
  90. package/scripts/thumbgate-search.js +85 -19
  91. package/scripts/tool-registry.js +169 -1
  92. package/scripts/vector-store.js +45 -0
  93. package/scripts/workflow-sentinel.js +286 -53
  94. package/scripts/workspace-evolver.js +62 -2
  95. package/src/api/server.js +2683 -319
  96. package/scripts/bot-detector.js +0 -50
@@ -12,7 +12,6 @@ const PRODUCT = {
12
12
  repoUrl: 'https://github.com/IgorGanapolsky/ThumbGate',
13
13
  homepageUrl: 'https://thumbgate.ai',
14
14
  verificationUrl: 'https://github.com/IgorGanapolsky/ThumbGate/blob/main/docs/VERIFICATION_EVIDENCE.md',
15
- automationUrl: 'https://github.com/IgorGanapolsky/ThumbGate/blob/main/proof/automation/report.json',
16
15
  sprintDiagnosticPaymentUrl: 'https://buy.stripe.com/00w14neyUcXA5pL5e33sI0e',
17
16
  workflowSprintPaymentUrl: 'https://buy.stripe.com/fZu9AT76saPsg4pbCr3sI0f',
18
17
  compatibility: ['Claude Code', 'Cursor', 'Codex', 'Gemini', 'Amp', 'OpenCode'],
@@ -105,6 +104,11 @@ const HIGH_ROI_QUERY_SEEDS = [
105
104
  93,
106
105
  'Fresh Slack engineering pattern where ThumbGate can gate director journals, critic reviews, credibility scoring, and timelines for long-running agents.',
107
106
  ),
107
+ querySeed(
108
+ 'agent context governance',
109
+ 95,
110
+ 'Fresh AdaCoM, tokenmaxxing, and Claude Managed Agents demand where ThumbGate can govern context hygiene, session logs, sandbox boundaries, credential separation, and pre-action proof.',
111
+ ),
108
112
  querySeed(
109
113
  'reasoning compression guardrails',
110
114
  92,
@@ -155,6 +159,31 @@ const HIGH_ROI_QUERY_SEEDS = [
155
159
  91,
156
160
  'Captures research-led interest in how AI systems decide which brands and tools to recommend.',
157
161
  ),
162
+ querySeed(
163
+ 'ai mode ads agent governance',
164
+ 94,
165
+ 'Conversational Google AI Mode ad demand where ThumbGate can become the cited answer for teams asking how to govern AI-agent actions, not just buy clicks.',
166
+ ),
167
+ querySeed(
168
+ 'mcp tool governance',
169
+ 95,
170
+ 'High-intent MCP buyer query where teams need approval boundaries and audit proof before exposing tools to agents.',
171
+ ),
172
+ querySeed(
173
+ 'ai agent pre action approval gates',
174
+ 95,
175
+ 'Bottom-of-funnel query for teams ready to add human approval and evidence requirements before AI agents touch risky tools.',
176
+ ),
177
+ querySeed(
178
+ 'agentic web governance',
179
+ 94,
180
+ 'Fresh Cloudflare bot-majority demand: buyers need machine-readable pages and pre-action governance now that AI agents can create more web actions than humans.',
181
+ ),
182
+ querySeed(
183
+ 'database safety for ai agents',
184
+ 96,
185
+ 'Fresh database-agent risk query from the 2026 DB/AI conversation: agents can hallucinate UI, but SQL writes, migrations, and role grants can destroy production data.',
186
+ ),
158
187
  {
159
188
  query: 'thumbs up thumbs down feedback for ai coding agents',
160
189
  businessValue: 95,
@@ -209,6 +238,12 @@ const HIGH_ROI_QUERY_SEEDS = [
209
238
  source: 'seed',
210
239
  notes: 'Integration page for Gemini CLI users who need memory plus enforcement.',
211
240
  },
241
+ {
242
+ query: 'hermes agent guardrails',
243
+ businessValue: 84,
244
+ source: 'seed',
245
+ notes: 'Integration page for Hermes Agent users who need pre-action gates around persistent memory, generated skills, messaging gateways, scheduled automations, and sandboxed execution.',
246
+ },
212
247
  {
213
248
  query: 'roo code alternative cline',
214
249
  businessValue: 83,
@@ -379,6 +414,180 @@ function buildSemanticPseoGuide() {
379
414
  });
380
415
  }
381
416
 
417
+ const ZERO_TRUST_GUIDE_SPEC = Object.freeze({
418
+ slug: 'ai-coding-agent-zero-trust',
419
+ meta: {
420
+ query: 'zero trust for ai coding agents',
421
+ title: 'Zero Trust for AI Coding Agents | Enforce It at the Tool Call',
422
+ heroTitle: 'Zero Trust for AI Coding Agents, Enforced at the Tool Call',
423
+ heroSummary: 'Zero trust for agents means never trust, always verify; least privilege; assume breach. ThumbGate is the local-first way to enforce those principles for Claude Code, Cursor, and Codex — blocking dangerous tool calls before they run, and turning every thumbs-down into a prevention rule so the same mistake never repeats.',
424
+ },
425
+ takeaways: [
426
+ 'Zero trust for agents means verifying every action at the boundary where it executes — the tool call — instead of trusting the model’s stated intent.',
427
+ 'ThumbGate runs in the PreToolUse hook on your machine: rm -rf, secret writes, off-scope edits, and bad git push are blocked before execution (assume breach, least privilege).',
428
+ 'Unlike static DIY hooks, ThumbGate learns — a thumbs-down becomes an auto-promoted prevention rule that holds across every session, model, and agent.',
429
+ ],
430
+ sections: [
431
+ ['paragraphs', 'Why AI coding agents need zero trust at the tool call', [
432
+ 'A coding agent reads files, runs shell commands, calls APIs, and pushes code with minimal human approval at each step. If it is manipulated, misconfigured, or simply wrong, the blast radius is whatever it can execute — and unlike a human, it does not pause to question a suspicious request.',
433
+ 'Zero-trust security for agents adapts three principles to this reality: never trust, always verify; least privilege; and assume breach. The practical place to apply them is the action boundary — the moment before a tool call runs — not the model’s prompt or its good intentions.',
434
+ ]],
435
+ ['bullets', 'ThumbGate vs. rolling your own Claude Code hooks', [
436
+ 'Static hooks and community repos do pattern-matching you write and maintain by hand, per machine, per project. ThumbGate ships the same blocking and adds a learning layer on top.',
437
+ 'A thumbs-down on a bad action becomes an auto-promoted prevention rule — the repeat is blocked automatically next time, on every session and every agent, with zero extra config.',
438
+ 'Local-first: enforcement runs in the PreToolUse hook on the developer machine, not a server-side gateway, so it works the moment you npx thumbgate init.',
439
+ 'Works across Claude Code, Cursor, Codex, Gemini, Amp, Cline, and OpenCode — one rule set, every MCP-compatible agent.',
440
+ ]],
441
+ ['paragraphs', 'How ThumbGate maps to the zero-trust principles', [
442
+ 'Never trust, always verify: every high-risk tool call is checked against prevention rules and workflow shape before it executes. Least privilege: task scope and approval gates keep an agent inside its declared blast radius. Assume breach: dangerous commands are blocked before they touch the disk, so a compromised or confused agent cannot do damage on the way to being caught.',
443
+ 'This is enforcement, not observability. ThumbGate decides at the tool call whether the action runs — which is exactly where zero-trust controls have to live for autonomous agents.',
444
+ ]],
445
+ ],
446
+ faq: [
447
+ [
448
+ 'Isn’t this just Claude Code’s built-in hooks?',
449
+ 'Native hooks and community repos do static pattern-matching that you author and maintain per machine. ThumbGate adds the learning layer: a thumbs-down becomes a prevention rule that blocks the repeat automatically, across sessions and agents — the part static hooks cannot do.',
450
+ ],
451
+ [
452
+ 'How does ThumbGate enforce zero trust for AI agents?',
453
+ 'It applies the core principles at the tool-call boundary on your machine: never trust, always verify (every risky action is checked before it runs), least privilege (task scope and approval gates), and assume breach (dangerous calls are blocked before they touch disk).',
454
+ ],
455
+ ],
456
+ relatedPaths: ['/guides/pre-action-checks', '/guides/agent-harness-optimization'],
457
+ });
458
+
459
+ function buildZeroTrustGuide() {
460
+ return preActionGuide(ZERO_TRUST_GUIDE_SPEC.slug, {
461
+ ...ZERO_TRUST_GUIDE_SPEC.meta,
462
+ takeaways: ZERO_TRUST_GUIDE_SPEC.takeaways,
463
+ sections: ZERO_TRUST_GUIDE_SPEC.sections.map(([kind, heading, entries]) => buildSectionFromSpec(kind, heading, entries)),
464
+ faq: ZERO_TRUST_GUIDE_SPEC.faq.map(([question, text]) => answer(question, text)),
465
+ relatedPaths: ZERO_TRUST_GUIDE_SPEC.relatedPaths,
466
+ });
467
+ }
468
+
469
+ const GOVERN_CLAUDE_FOR_LEGAL_GUIDE_SPEC = Object.freeze({
470
+ slug: 'govern-claude-for-legal-agents',
471
+ meta: {
472
+ query: 'govern claude for legal agents',
473
+ title: 'Govern Claude for Legal Agents | A Gate Before They Act',
474
+ heroTitle: 'Govern Claude for Legal’s 90+ Agents at the Tool Call',
475
+ heroSummary: 'Claude for Legal ships 90+ named agents that review contracts, answer DSARs, and run continuously on document and email streams. Anthropic’s own guidance is that there must be a gate before anything is filed, sent, or relied on. ThumbGate is that gate — it checks each agent action at the tool-call boundary, in your tenant, and logs every decision for the record.',
476
+ },
477
+ takeaways: [
478
+ 'Claude for Legal’s agents take real side effects — sending a DSAR response, filing a document, writing to a system of record. ThumbGate gates the action before the side effect runs, not after, on a dashboard.',
479
+ 'Intent-agnostic: whether an agent is wrong, prompt-injected, or off-playbook, ThumbGate blocks the same way and records the rule that fired. The risk is not a “rogue” agent — it is an ordinary one acting at volume.',
480
+ 'Every gated decision is logged with its source rule — a SIEM-exportable audit trail your ethics, risk, and conflicts owners can query.',
481
+ ],
482
+ sections: [
483
+ ['paragraphs', 'Why 90+ legal agents need a gate before the side effect', [
484
+ 'A firm running Claude for Legal now has dozens of agents acting on ongoing document and email streams — vendor-agreement review, termination review, DSAR responses, claim charts. No one can review every action by hand. The risk is not malice; it is an ordinary agent that sends the wrong response, files against the wrong playbook, or surfaces a privileged document.',
485
+ 'Anthropic’s own framing names the control: an explicit gate before anything is filed, sent, or relied on. ThumbGate implements that gate at the tool-call boundary — the moment before the action executes — instead of trusting the agent’s stated intent.',
486
+ ]],
487
+ ['bullets', 'What ThumbGate gates for legal agents', [
488
+ 'The send/file/write action itself — e.g. a DSAR or client response before it leaves, a filing before it goes out, a write to a conflicted matter — held or blocked at the boundary.',
489
+ 'Playbook deviations — an action that departs from the firm’s approved workflow is stopped for review rather than executed.',
490
+ 'Privileged-document exposure — flagged before an agent surfaces or forwards it.',
491
+ 'Continuous runs — one rule set covers every agent and every scheduled run, so coverage scales with agent count, not headcount.',
492
+ ]],
493
+ ['paragraphs', 'Enforcement in your tenant, with an audit trail', [
494
+ 'ThumbGate runs as a pre-action gate in front of agent fulfillment, including a Dialogflow CX webhook gate deployed in your own GCP tenant, so matter content does not leave your boundary. Risk and planning scoring can run on Gemini via Vertex, in-tenant. This is a white-glove design-partner pilot, not a turnkey product purchase.',
495
+ 'Every gated detection is logged with the rule that fired and the feedback event that generated it. That decision trail is the evidence a firm needs for malpractice defense and bar-compliance review — queryable, exportable, and tied to a named owner.',
496
+ ]],
497
+ ['paragraphs', 'ThumbGate complements Claude for Legal — it does not replace it', [
498
+ 'Claude for Legal decides what the work is. ThumbGate decides what is allowed to execute. Use both: keep the 90+ agents doing the legal work, and put a gate between each agent and its next side effect. A thumbs-down on a bad action becomes a prevention rule, so the same mistake is blocked across every agent and matter next time.',
499
+ ]],
500
+ ],
501
+ faq: [
502
+ [
503
+ 'Does ThumbGate replace Claude for Legal?',
504
+ 'No. Claude for Legal’s agents do the legal work; ThumbGate governs what they are allowed to execute — a gate before anything is filed, sent, or relied on. You run both.',
505
+ ],
506
+ [
507
+ 'Where does the gate run?',
508
+ 'In your tenant. ThumbGate gates agent fulfillment locally or via a Dialogflow CX webhook gate in your own GCP project; matter content does not leave your boundary, and Vertex/Gemini scoring runs in-tenant. It is a white-glove design-partner pilot, not a turnkey purchase.',
509
+ ],
510
+ [
511
+ 'What proof does a firm get?',
512
+ 'Every gated decision is logged with the rule that fired and the feedback that generated it — a SIEM-exportable audit trail for ethics, risk, and conflicts owners.',
513
+ ],
514
+ ],
515
+ relatedPaths: ['/guides/ai-coding-agent-zero-trust', '/guides/pre-action-checks'],
516
+ });
517
+
518
+ // Targets the Cycode-owned IDE-security lexicon (Feb 2026 blog popularized
519
+ // PreToolUse / beforeMCPExecution / beforeReadFile as enterprise hook names) —
520
+ // fills the indie/MIT slot beneath funded vendors when LLM answer engines
521
+ // (Perplexity/ChatGPT/Gemini/Claude/Grok) cite for "how do I stop Claude Code
522
+ // from running dangerous commands" buyer-intent queries. See the verified-
523
+ // absence finding in the 2026-06-05 deep-research report.
524
+ const PRETOOLUSE_HOOK_GUIDE_SPEC = Object.freeze({
525
+ slug: 'claude-code-pretooluse-hook',
526
+ meta: {
527
+ query: 'claude code pretooluse hook block mcp tool calls',
528
+ title: 'Claude Code PreToolUse Hook | Block MCP Tool Calls Before They Run',
529
+ heroTitle: 'Claude Code PreToolUse Hook: Block MCP Tool Calls Before They Run',
530
+ heroSummary: 'The PreToolUse hook is the boundary where you intercept what a Claude Code, Cursor, or Codex agent is about to do — before the rm -rf, before the bad git push, before the destructive SQL. ThumbGate is the local-first, MIT-licensed CLI that ships production-grade PreToolUse, beforeMCPExecution, and beforeReadFile gating with one npx command, and learns from every thumbs-down so the same mistake never reaches the tool call twice.',
531
+ },
532
+ takeaways: [
533
+ 'PreToolUse is the only hook point where you can stop a destructive agent action — by the time PostToolUse fires, the damage is done.',
534
+ 'ThumbGate ships PreToolUse, beforeMCPExecution, and beforeReadFile gates out of the box for Claude Code, Cursor, Codex, Gemini CLI, Amp, Cline, and any MCP-compatible agent — no hand-written hook scripts to maintain per machine.',
535
+ 'A thumbs-down on a blocked action becomes an auto-promoted prevention rule that holds across every session, model, and agent — the part DIY hook repos cannot do.',
536
+ ],
537
+ sections: [
538
+ ['paragraphs', 'What the PreToolUse hook actually is', [
539
+ 'In the Model Context Protocol agent loop, every tool the model calls — Bash, Edit, Write, a custom MCP server method — flows through a PreToolUse phase before execution. That phase is the only place where an external policy can intercept the call, inspect its arguments, and decide whether to allow, modify, warn, or deny it. PostToolUse fires after the side effect has already happened, which is too late for destructive actions.',
540
+ 'beforeMCPExecution, beforeReadFile, and beforeSubmitPrompt are the same idea applied at the MCP and IDE layers. Cycode\'s February 2026 IDE-security blog popularized this naming for enterprise customers; ThumbGate ships the same hook surface as an open-source CLI you can install in 30 seconds.',
541
+ ]],
542
+ ['bullets', 'What ThumbGate blocks at PreToolUse out of the box', [
543
+ 'Catastrophic shell: rm -rf at home/root, sudo wrapping a dangerous command, find -delete on sensitive paths.',
544
+ 'Secret exfiltration: writes that contain API keys, tokens, or .env contents heading to the wrong directory.',
545
+ 'Workflow-scope violations: edits outside the declared task scope, off-branch git push, accidental main commits.',
546
+ 'Repeated mistakes from this team: anything you\'ve already given a thumbs-down in a past session — auto-promoted to a hard prevention rule.',
547
+ 'MCP tool calls flagged by your project\'s gate config — pattern, severity, or learned-from-feedback rules.',
548
+ ]],
549
+ ['paragraphs', 'Why DIY PreToolUse scripts stop working past week two', [
550
+ 'A hand-rolled hook script starts simple: a regex on the Bash command, a list of forbidden paths. By week two it has six edge cases, no test coverage, and lives in one machine\'s .claude directory — invisible to the rest of the team. By week four someone deletes it because it false-positived once on a legitimate command and nobody documented why.',
551
+ 'ThumbGate ships the rules as a versioned config, the feedback loop as a CLI, the learning as cross-session prevention rules, and the proof as an audit trail your dashboard renders. The work you would do by hand on hooks, done once and shared.',
552
+ ]],
553
+ ],
554
+ faq: [
555
+ [
556
+ 'Is the PreToolUse hook the same as beforeMCPExecution?',
557
+ 'Conceptually yes — both are the pre-execution interception point. PreToolUse is the Claude Code / Anthropic CLI term for the hook in the agent loop. beforeMCPExecution (and beforeReadFile, beforeSubmitPrompt) is the IDE-security framing popularized by Cycode for the same boundary at the MCP layer. ThumbGate implements all of them as one local-first gate engine.',
558
+ ],
559
+ [
560
+ 'Do I need this if Claude Code already has native hooks?',
561
+ 'Native hooks give you the hook point. They do not give you the rule set, the cross-session learning, the team-wide rule sharing, or the audit trail. ThumbGate ships those on top of the hook so you stop maintaining bespoke scripts and start blocking the repeat mistakes specifically your agents make.',
562
+ ],
563
+ [
564
+ 'Does this run locally or call a cloud service?',
565
+ 'Local-first. The PreToolUse decision happens in the hook process on your machine in milliseconds — no network round-trip, no cloud dependency, no data leaving the laptop. Optional hosted sync exists for teams that want to share rules across seats.',
566
+ ],
567
+ ],
568
+ relatedPaths: ['/guides/mcp-tool-governance', '/guides/ai-agent-pre-action-approval-gates', '/guides/ai-coding-agent-zero-trust'],
569
+ });
570
+
571
+ function buildPretooluseHookGuide() {
572
+ return preActionGuide(PRETOOLUSE_HOOK_GUIDE_SPEC.slug, {
573
+ ...PRETOOLUSE_HOOK_GUIDE_SPEC.meta,
574
+ takeaways: PRETOOLUSE_HOOK_GUIDE_SPEC.takeaways,
575
+ sections: PRETOOLUSE_HOOK_GUIDE_SPEC.sections.map(([kind, heading, entries]) => buildSectionFromSpec(kind, heading, entries)),
576
+ faq: PRETOOLUSE_HOOK_GUIDE_SPEC.faq.map(([question, text]) => answer(question, text)),
577
+ relatedPaths: PRETOOLUSE_HOOK_GUIDE_SPEC.relatedPaths,
578
+ });
579
+ }
580
+
581
+ function buildGovernClaudeForLegalGuide() {
582
+ return preActionGuide(GOVERN_CLAUDE_FOR_LEGAL_GUIDE_SPEC.slug, {
583
+ ...GOVERN_CLAUDE_FOR_LEGAL_GUIDE_SPEC.meta,
584
+ takeaways: GOVERN_CLAUDE_FOR_LEGAL_GUIDE_SPEC.takeaways,
585
+ sections: GOVERN_CLAUDE_FOR_LEGAL_GUIDE_SPEC.sections.map(([kind, heading, entries]) => buildSectionFromSpec(kind, heading, entries)),
586
+ faq: GOVERN_CLAUDE_FOR_LEGAL_GUIDE_SPEC.faq.map(([question, text]) => answer(question, text)),
587
+ relatedPaths: GOVERN_CLAUDE_FOR_LEGAL_GUIDE_SPEC.relatedPaths,
588
+ });
589
+ }
590
+
382
591
  const PROXY_POINTER_RAG_GUARDRAILS_SPEC = Object.freeze({
383
592
  slug: 'proxy-pointer-rag-guardrails',
384
593
  meta: {
@@ -1362,6 +1571,51 @@ const AI_RECOMMENDATION_VISIBILITY_GUIDE_SPECS = Object.freeze([
1362
1571
  ],
1363
1572
  relatedPaths: ['/guides/ai-search-topical-presence', '/compare/mem0'],
1364
1573
  },
1574
+ {
1575
+ slug: 'ai-mode-ads-agent-governance',
1576
+ meta: {
1577
+ query: 'ai mode ads agent governance',
1578
+ title: 'AI Mode Ads for Agent Governance | Turn Buyer Prompts Into ThumbGate Demand',
1579
+ heroTitle: 'AI Mode ads make agent-governance promotion conversational',
1580
+ heroSummary: 'Google AI Mode and conversational ad formats shift promotion from click-chasing to answer ownership. ThumbGate should show up when buyers ask how to govern Claude Code, Cursor, Codex, Gemini, MCP tools, and risky agent actions.',
1581
+ },
1582
+ takeaways: [
1583
+ 'Conversational ads reward brands that answer the buyer question directly before the click.',
1584
+ 'ThumbGate should own prompts about pre-action gates, MCP tool governance, repeated AI-agent mistakes, and audit proof.',
1585
+ 'The best paid-search asset is an answer page with schema, proof links, and a checkout or workflow-intake path.',
1586
+ ],
1587
+ sections: [
1588
+ ['paragraphs', 'Why conversational ads change the promotion plan', [
1589
+ 'Search ads are moving toward generated answers and product recommendations inside the search conversation. A buyer may not click ten blue links before forming an opinion; the assistant-like surface may summarize the category, compare options, and mention a vendor in one flow.',
1590
+ 'That means ThumbGate promotion has to be answer-shaped. The page must say exactly what ThumbGate is, which agent-risk problem it solves, which tools it supports, and what proof a buyer can verify before starting checkout or a Workflow Hardening Sprint.',
1591
+ ]],
1592
+ ['bullets', 'Buyer prompts ThumbGate should target', [
1593
+ 'How do I stop Claude Code or Cursor from repeating risky mistakes?',
1594
+ 'What is the pre-action approval layer for AI coding agents?',
1595
+ 'How do teams govern MCP tools before agents call them?',
1596
+ 'How do I audit AI-agent actions before production deploys, payments, or database writes?',
1597
+ 'What tool turns thumbs-down feedback into enforceable rules?',
1598
+ ]],
1599
+ ['paragraphs', 'How this page should be used', [
1600
+ 'Use this page as the landing asset for AI Mode, Gemini, and high-intent search experiments. Do not send conversational-ad traffic to a generic homepage first. Send it to the answer that mirrors the buyer prompt, then route warm readers to Pro checkout, the install guide, or workflow intake depending on intent.',
1601
+ ]],
1602
+ ],
1603
+ faq: [
1604
+ [
1605
+ 'How do AI Mode ads help ThumbGate?',
1606
+ 'They favor direct, conversational answers. ThumbGate benefits when it has pages that answer specific buyer prompts about AI-agent governance, MCP tool risk, pre-action approval gates, and repeated failure prevention.',
1607
+ ],
1608
+ [
1609
+ 'Should ThumbGate run broad Google Ads immediately?',
1610
+ 'No. The high-ROI path is to build answer assets first, then test narrow paid search or AI Mode campaigns against exact buyer prompts where the page, schema, proof links, and checkout route all match the question.',
1611
+ ],
1612
+ [
1613
+ 'What is the one-sentence ad answer?',
1614
+ 'ThumbGate is the pre-action execution gate for AI agents: it checks risky tool calls before they run, turns feedback into rules, and gives teams audit proof.',
1615
+ ],
1616
+ ],
1617
+ relatedPaths: ['/guides/ai-search-topical-presence', '/guides/pre-action-checks', '/guides/mcp-tool-governance'],
1618
+ },
1365
1619
  ]);
1366
1620
 
1367
1621
  function buildAiRecommendationVisibilityGuide(spec) {
@@ -1375,6 +1629,68 @@ function buildAiRecommendationVisibilityGuide(spec) {
1375
1629
  }
1376
1630
 
1377
1631
  const PAGE_BLUEPRINTS = [
1632
+ {
1633
+ query: 'snowflake cortex agent governance vs local coding agent guardrails',
1634
+ path: '/compare/snowflake-cortex-agent-governance',
1635
+ pageType: 'comparison',
1636
+ pillar: 'comparison',
1637
+ title: 'ThumbGate vs Snowflake Cortex Agent Governance | Two Different Layers',
1638
+ heroTitle: 'ThumbGate vs Snowflake Cortex Agent Governance',
1639
+ heroSummary: 'At Snowflake Summit 2026, agent governance became headline infrastructure: Cortex CoCo runs under your existing RBAC inside Snowflake\'s perimeter, and the Natoma acquisition adds a permission gateway built to freeze out rogue agents. That is the right model for agents operating inside the data cloud. But the coding agent in your terminal acts earlier and lower in the stack: Claude Code, Cursor, and Codex run rm -rf, force-push to main, and write secrets to disk on your own machine, under your own credentials, before any platform RBAC ever sees the request. ThumbGate is the local-first PreToolUse layer for exactly that surface. They are not competitors — they are different layers of the same defense.',
1640
+ takeaways: [
1641
+ 'Snowflake Cortex and Natoma govern what an agent does inside the enterprise data perimeter — server-side, under RBAC, with a full audit trail. The right tool when the agent\'s actions are SQL and data access inside Snowflake.',
1642
+ 'ThumbGate governs what a coding agent does on the developer\'s machine — rm -rf, force-push, secret writes, off-scope edits — in the PreToolUse hook, before execution, before any platform sees the request.',
1643
+ 'The two compose. A coding agent that force-pushes broken code or leaks a key never reached Snowflake\'s perimeter to be governed there; that failure happens in the dev loop, which is the layer ThumbGate owns.',
1644
+ ],
1645
+ sections: [
1646
+ {
1647
+ heading: 'The boundary in one sentence',
1648
+ paragraphs: [
1649
+ 'Snowflake Cortex governs what an agent is allowed to do once it is operating inside Snowflake — querying tables, accessing data, taking actions under your RBAC, with prompt-injection guardrails and an audit trail. Natoma extends that to a permission gateway across enterprise apps.',
1650
+ 'ThumbGate governs what a coding agent does on the developer\'s machine, in the PreToolUse hook, before the tool call executes — the rm -rf, the git push --force, the secret written to disk. That happens in the terminal, under the developer\'s own credentials, before any platform boundary exists to enforce it.',
1651
+ ],
1652
+ },
1653
+ {
1654
+ heading: 'Choose Snowflake Cortex / Natoma governance when',
1655
+ bullets: [
1656
+ 'Your agents operate inside the Snowflake data cloud and the risk you manage is data access and SQL under enterprise RBAC.',
1657
+ 'You need centralized, server-side policy and audit across enterprise applications and identities.',
1658
+ 'Your buyer is a data or platform team standardizing agent access at the organization level.',
1659
+ ],
1660
+ },
1661
+ {
1662
+ heading: 'Choose ThumbGate when',
1663
+ bullets: [
1664
+ 'Your risk is a coding agent on a developer\'s machine — Claude Code, Cursor, Codex, Gemini, Amp, Cline, OpenCode — running destructive shell, git, or filesystem actions.',
1665
+ 'You want enforcement in the PreToolUse hook, before execution, with zero server and zero rollout — npx thumbgate init in 30 seconds.',
1666
+ 'You want a learning loop: a thumbs-down on a blocked action becomes an auto-promoted prevention rule that holds across every session and every agent.',
1667
+ 'You want least-privilege task scope and a local audit trail of every blocked action — not only inside one platform\'s perimeter.',
1668
+ ],
1669
+ },
1670
+ {
1671
+ heading: 'Why the two layers do not overlap',
1672
+ paragraphs: [
1673
+ 'Snowflake validated the thesis the whole category now agrees on: agents need a control layer that decides what they can do before they do it, not an audit log after the damage. At Summit 2026 they made it headline infrastructure and acquired Natoma to enforce it across the enterprise.',
1674
+ 'But platform governance can only act on requests that reach the platform. A coding agent that force-pushes broken code, deletes a directory, or commits a secret has already done the damage on the developer\'s machine — that action never traveled to Snowflake to be governed. ThumbGate is the enforcement point for that earlier, lower layer. If you run AI coding agents and AI inside your data cloud, you want both: ThumbGate at the dev loop, platform governance at the data layer.',
1675
+ ],
1676
+ },
1677
+ ],
1678
+ faq: [
1679
+ {
1680
+ question: 'Is ThumbGate an alternative to Snowflake Cortex agent governance?',
1681
+ answer: 'Not exactly — they govern different layers. Snowflake Cortex and Natoma govern agents operating inside the enterprise data cloud under RBAC. ThumbGate governs coding agents on the developer\'s machine in the PreToolUse hook, before any action reaches a platform. If your risk is a coding agent running rm -rf or force-pushing to main, ThumbGate is the right layer; if your risk is data access inside Snowflake, Cortex is. Most teams running both AI coding agents and AI in their data cloud want both.',
1682
+ },
1683
+ {
1684
+ question: 'Does ThumbGate require a server or enterprise rollout like Natoma?',
1685
+ answer: 'No. ThumbGate is local-first: npx thumbgate init wires the PreToolUse hook on your machine in about 30 seconds, with no server, no gateway, and no platform rollout. Natoma is a server-side permission gateway for enterprise applications; ThumbGate runs entirely in the developer\'s local agent loop. That is the deliberate difference in surface.',
1686
+ },
1687
+ {
1688
+ question: 'Snowflake says agentic security needs a fundamentally different approach. Does ThumbGate agree?',
1689
+ answer: 'Yes — and ThumbGate has been built on that premise from day one. The shared thesis is that you enforce before the action, not after: a deterministic pre-action gate, not a model reviewing its own output. Snowflake applies that inside the data perimeter; ThumbGate applies it at the coding-agent layer on the developer\'s machine. The agreement on the model is exactly why the two compose rather than compete.',
1690
+ },
1691
+ ],
1692
+ relatedPaths: ['/compare/claude-code-hooks-mastery', '/guides/ai-agent-pre-action-approval-gates', '/guides/background-agent-governance'],
1693
+ },
1378
1694
  {
1379
1695
  query: 'thumbgate vs speclock',
1380
1696
  path: '/compare/speclock',
@@ -1476,6 +1792,9 @@ const PAGE_BLUEPRINTS = [
1476
1792
  relatedPaths: ['/compare/speclock', '/guides/claude-code-feedback'],
1477
1793
  },
1478
1794
  buildSemanticPseoGuide(),
1795
+ buildZeroTrustGuide(),
1796
+ buildGovernClaudeForLegalGuide(),
1797
+ buildPretooluseHookGuide(),
1479
1798
  buildProxyPointerRagGuide(),
1480
1799
  buildRagPrecisionTuningGuide(),
1481
1800
  buildAiEngineeringStackGuide(),
@@ -1536,6 +1855,136 @@ const PAGE_BLUEPRINTS = [
1536
1855
  ],
1537
1856
  relatedPaths: ['/guides/code-knowledge-graph-guardrails', '/guides/agent-harness-optimization', '/guides/pre-action-checks'],
1538
1857
  },
1858
+ {
1859
+ query: 'thumbgate vs cycode ai coding agent guardrails',
1860
+ path: '/compare/cycode',
1861
+ pageType: 'comparison',
1862
+ pillar: 'comparison',
1863
+ title: 'ThumbGate vs Cycode | Local-First MIT Alternative for AI Agent Guardrails',
1864
+ heroTitle: 'ThumbGate vs Cycode',
1865
+ heroSummary: 'Cycode ships IDE-native security guardrails for enterprise AppSec teams — agent-time scanning, beforeMCPExecution / beforeReadFile / beforeSubmitPrompt hooks, and integration with their broader code-security platform. ThumbGate is the local-first, MIT-licensed CLI that ships the same PreToolUse / MCP-tool-call gating surface as an open-source npm install — and adds a learning loop where every thumbs-down becomes an auto-promoted prevention rule the team shares.',
1866
+ takeaways: [
1867
+ 'Cycode is enterprise IDE security: agent-time scanning + hook interception + platform integration with their broader AppSec suite.',
1868
+ 'ThumbGate ships the same PreToolUse / beforeMCPExecution surface as an MIT-licensed CLI you install in 30 seconds — no platform contract, no procurement cycle.',
1869
+ 'The decision is mostly company-shape: enterprise security teams take Cycode; solo devs, OSS maintainers, and small teams take ThumbGate. The learning-loop (thumbs-down → prevention rule across sessions) is something Cycode does not advertise.',
1870
+ ],
1871
+ sections: [
1872
+ {
1873
+ heading: 'The product difference in one sentence',
1874
+ paragraphs: [
1875
+ 'Cycode is "IDE security for the enterprise" — its February 2026 announcement positions the agent-time hooks (beforeSubmitPrompt, beforeReadFile, beforeMCPExecution) as one module of a broader AppSec platform that also covers secrets, SAST, SCA, and supply chain.',
1876
+ 'ThumbGate is a single-purpose, open-source, local-first CLI for the same hook surface. The lexicon is the same; the buyer is different. ThumbGate optimizes for a developer who can `npx thumbgate init` and have working PreToolUse gating before lunch.',
1877
+ ],
1878
+ },
1879
+ {
1880
+ heading: 'Choose Cycode when',
1881
+ bullets: [
1882
+ 'You have an enterprise AppSec team that needs a unified vendor across secrets, SAST, SCA, supply-chain, and the new agent-time hook layer.',
1883
+ 'You need centralized policy management, RBAC, SIEM integration, and a procurement-ready contract with SOC2 / ISO-grade artifacts.',
1884
+ 'Your security org wants one dashboard for IDE-time and CI/CD-time security posture across the whole repo footprint.',
1885
+ ],
1886
+ },
1887
+ {
1888
+ heading: 'Choose ThumbGate when',
1889
+ bullets: [
1890
+ 'You want PreToolUse / beforeMCPExecution gating working in 30 seconds via `npx thumbgate init` — no contract, no platform install, no procurement.',
1891
+ 'You want a learning loop: a thumbs-down on a blocked action becomes an auto-promoted prevention rule that holds across every session, model, and agent.',
1892
+ 'You are a solo developer, OSS maintainer, or small team that wants MIT-licensed code you can read, fork, and verify — not a closed-source SaaS.',
1893
+ 'You want the gating engine to run entirely on the developer machine with zero network egress for the hook decision itself.',
1894
+ ],
1895
+ },
1896
+ {
1897
+ heading: 'What the two products share',
1898
+ paragraphs: [
1899
+ 'Both put the enforcement boundary at the same place — the agent\'s tool call, before execution — and both name the hooks the same way (PreToolUse / beforeMCPExecution / beforeReadFile). The category lexicon is the same because the underlying agent loop is the same.',
1900
+ 'The disagreement is on packaging. Cycode wraps it in an enterprise platform contract; ThumbGate ships it as an MIT-licensed CLI. If you are an enterprise security team buying a platform, you are not the ThumbGate buyer. If you are a developer who wants to type `npx thumbgate init` and have agent gating running before the next standup, Cycode is over-scoped for you.',
1901
+ ],
1902
+ },
1903
+ ],
1904
+ faq: [
1905
+ {
1906
+ question: 'Is ThumbGate a direct replacement for Cycode\'s agent-time hooks?',
1907
+ answer: 'For the hook surface itself — PreToolUse, beforeMCPExecution, beforeReadFile — yes. For the broader Cycode AppSec platform (secrets scanning, SAST, SCA, supply chain), no. ThumbGate is single-purpose: agent-time tool-call gating with a learning loop. If you only need that, ThumbGate replaces the Cycode agent-time module at zero license cost.',
1908
+ },
1909
+ {
1910
+ question: 'Why would I pick MIT-licensed local-first over a funded enterprise vendor?',
1911
+ answer: 'Three reasons. (1) Cost: no per-seat license. (2) Speed of adoption: `npx thumbgate init` is faster than enterprise procurement. (3) Auditability: you can read the gate-engine code, modify it, and run it offline. The trade-off is you do not get a platform contract, RBAC, or a single vendor for all your AppSec needs. That is a fine trade-off for a solo dev or small team; it is the wrong trade-off for a regulated enterprise.',
1912
+ },
1913
+ {
1914
+ question: 'Does Cycode have the cross-session learning loop?',
1915
+ answer: 'Not advertised on their public materials as of the February 2026 announcement. Cycode\'s hooks are policy-driven; ThumbGate adds a feedback-to-rules pipeline where a thumbs-down on a blocked action becomes an auto-promoted prevention rule that holds across every session and every agent on the same install.',
1916
+ },
1917
+ {
1918
+ question: 'Can I use both?',
1919
+ answer: 'Technically yes — Cycode at the enterprise platform layer, ThumbGate as the developer-local fast loop — but most teams will pick one. They occupy the same hook surface, so running both means resolving who wins on conflicts. The simpler pattern is to pick by buyer profile: enterprise security team buys Cycode, individual developer / small team installs ThumbGate.',
1920
+ },
1921
+ ],
1922
+ relatedPaths: ['/guides/claude-code-pretooluse-hook', '/guides/mcp-tool-governance', '/guides/ai-coding-agent-zero-trust'],
1923
+ },
1924
+ {
1925
+ query: 'thumbgate vs disler claude code hooks mastery',
1926
+ path: '/compare/claude-code-hooks-mastery',
1927
+ pageType: 'comparison',
1928
+ pillar: 'comparison',
1929
+ title: 'ThumbGate vs disler/claude-code-hooks-mastery | When to Pick the OSS Tool',
1930
+ heroTitle: 'ThumbGate vs disler/claude-code-hooks-mastery',
1931
+ heroSummary: 'disler/claude-code-hooks-mastery is the most-starred community repo for Claude Code hooks — a comprehensive, free, MIT-licensed example library you can copy-paste into your own .claude/ config. ThumbGate is a published npm CLI that does the same gating work plus a learning loop where every thumbs-down becomes an auto-promoted prevention rule that holds across sessions, models, and agents. The disler repo is where you START; ThumbGate is what you USE when you stop wanting to maintain hook scripts by hand.',
1932
+ takeaways: [
1933
+ 'disler/claude-code-hooks-mastery is a free reference repo of hook examples — you copy them into .claude/, edit, and maintain per-machine, per-project.',
1934
+ 'ThumbGate ships the same gating engine as one `npx thumbgate init` install — versioned config, cross-session prevention rules, dashboard, audit trail.',
1935
+ 'The right path: start with the disler repo to learn what is possible; move to ThumbGate when you find yourself maintaining hook scripts in three projects.',
1936
+ ],
1937
+ sections: [
1938
+ {
1939
+ heading: 'The product difference in one sentence',
1940
+ paragraphs: [
1941
+ 'disler/claude-code-hooks-mastery is a GitHub repository of high-quality example hooks you read, learn from, and copy into your own setup. ThumbGate is a published CLI that ships the gating engine as a runnable tool with cross-session learning, a dashboard, and an audit trail.',
1942
+ 'Both are MIT-licensed. Both run locally. The disagreement is whether you want to read example scripts and own the maintenance, or install a tool that does the work and stays in sync.',
1943
+ ],
1944
+ },
1945
+ {
1946
+ heading: 'Choose disler/claude-code-hooks-mastery when',
1947
+ bullets: [
1948
+ 'You want to learn how Claude Code hooks actually work by reading well-written examples.',
1949
+ 'You are happy maintaining your own .claude/ config per project and per machine.',
1950
+ 'You only need static pattern-matching — no need for cross-session learning, dashboard, or audit history.',
1951
+ 'You explicitly do not want any installed dependency beyond what you author yourself.',
1952
+ ],
1953
+ },
1954
+ {
1955
+ heading: 'Choose ThumbGate when',
1956
+ bullets: [
1957
+ 'You want PreToolUse gating working in 30 seconds via `npx thumbgate init` — no copy-paste, no per-machine setup.',
1958
+ 'You want the learning loop: a thumbs-down on a blocked action becomes an auto-promoted prevention rule that holds across every session and every agent on the install.',
1959
+ 'You want a dashboard showing what was blocked, why, and which feedback became which rule — auditable evidence, not just hook scripts on disk.',
1960
+ 'You want one gate engine that works across Claude Code, Cursor, Codex, Gemini CLI, Amp, Cline, and OpenCode — not a separate copy-paste exercise per agent.',
1961
+ 'You operate on more than one project and do not want to maintain N copies of the same hook scripts.',
1962
+ ],
1963
+ },
1964
+ {
1965
+ heading: 'What the disler repo does brilliantly',
1966
+ paragraphs: [
1967
+ 'It is the best public reference for what a Claude Code PreToolUse hook can do — clear examples, real patterns, MIT-licensed code you can read end-to-end in an afternoon. If you are evaluating the category, that repo is required reading. It also has 3,000+ stars at the time of writing for a reason: the examples are good.',
1968
+ 'ThumbGate is not trying to replace that learning resource. The disler repo is where you understand the surface; ThumbGate is what you use when you decide to ship gating in production and want the cross-session learning, the dashboard, and the team-shared rule library that copy-paste cannot give you.',
1969
+ ],
1970
+ },
1971
+ ],
1972
+ faq: [
1973
+ {
1974
+ question: 'Why pay $19/mo for ThumbGate Pro when disler hooks are free?',
1975
+ answer: 'Free disler hooks are static patterns you maintain per machine — re-copying them when they change, debugging false positives alone, and re-applying them in every new project. ThumbGate Pro adds the learning loop (thumbs-down → cross-session prevention rule), the dashboard, hosted sync across machines, and adapter maintenance across the weekly breaking-change cycle of Claude Code, Cursor, and Cline. Free disler is the right answer if you only ever work in one project on one machine and never want to learn from past mistakes. Pro is the right answer when those assumptions stop holding.',
1976
+ },
1977
+ {
1978
+ question: 'Is ThumbGate just a packaged version of disler/claude-code-hooks-mastery?',
1979
+ answer: 'No. ThumbGate ships its own gate engine, feedback-to-rules pipeline, dashboard, and audit trail. The disler repo is a reference of well-written hook scripts you copy into your config; ThumbGate is a runnable CLI that ships the gate engine and adds a learning layer on top. Both are MIT-licensed and both rely on the same Claude Code PreToolUse hook surface — that is where the similarity ends.',
1980
+ },
1981
+ {
1982
+ question: 'Should I start with disler or ThumbGate?',
1983
+ answer: 'If you want to understand the category, read the disler repo first — it is the best public reference for what hooks can do. If you want gating working now without authoring scripts, run `npx thumbgate init`. Most users end up doing both: read disler to learn, install ThumbGate when they decide they would rather use a tool than maintain scripts.',
1984
+ },
1985
+ ],
1986
+ relatedPaths: ['/guides/claude-code-pretooluse-hook', '/compare/cycode', '/guides/pre-action-checks'],
1987
+ },
1539
1988
  buildClaudeCodeSkillsGuide(),
1540
1989
  buildLongRunningAgentContextGuide(),
1541
1990
  buildReasoningCompressionGuide(),
@@ -1652,6 +2101,68 @@ const PAGE_BLUEPRINTS = [
1652
2101
  ],
1653
2102
  relatedPaths: ['/guides/pre-action-checks', '/guides/agent-harness-optimization', '/guides/ai-search-topical-presence'],
1654
2103
  },
2104
+ {
2105
+ query: 'database safety for ai agents',
2106
+ path: '/guides/database-agent-safety',
2107
+ pageType: 'guide',
2108
+ pillar: 'pre-action-checks',
2109
+ title: 'Database Safety for AI Agents | ThumbGate Guide',
2110
+ heroTitle: 'Database Safety for AI Agents',
2111
+ heroSummary: 'AI agents can write code quickly, but database actions need stricter gates: a hallucinated SQL write, migration, role grant, or production config change can destroy data before review.',
2112
+ takeaways: [
2113
+ 'Databases are the highest-blast-radius tool surface for autonomous coding agents.',
2114
+ 'The winning pattern is not an AI DBA autopilot alone; it is a pre-action approval boundary before SQL, migrations, and privilege changes run.',
2115
+ 'ThumbGate turns repeated database mistakes into rules that block or pause the next risky query before execution.',
2116
+ ],
2117
+ sections: [
2118
+ {
2119
+ heading: 'Why database work is the final boss for agents',
2120
+ paragraphs: [
2121
+ 'A bad UI component is visible and usually reversible. A bad production query can delete rows, lock writes, leak data, or change privileges before anyone reviews the pull request.',
2122
+ 'That is why database-agent safety belongs at the tool-call boundary. The agent should be stopped before it runs DROP, TRUNCATE, unbounded UPDATE/DELETE, production migrations, or role grants.',
2123
+ ],
2124
+ },
2125
+ {
2126
+ heading: 'The high-ROI gate pack',
2127
+ bullets: [
2128
+ 'Block DROP, TRUNCATE, DROP DATABASE, and DROP SCHEMA unless human approval and rollback evidence are attached.',
2129
+ 'Block UPDATE and DELETE without a restrictive WHERE clause, including WHERE 1=1 and WHERE TRUE.',
2130
+ 'Require backup, snapshot, or reversible migration proof before production schema changes.',
2131
+ 'Require dry-run or EXPLAIN evidence before production writes and migrations.',
2132
+ 'Warn on CREATE INDEX without CONCURRENTLY and CROSS JOINs that can create performance incidents.',
2133
+ 'Block role creation, role alteration, and broad grants from autonomous agents.',
2134
+ ],
2135
+ },
2136
+ {
2137
+ heading: 'Where ThumbGate fits',
2138
+ paragraphs: [
2139
+ 'ThumbGate is not trying to replace Postgres, MySQL, Prisma, Rails migrations, or a DBA. It is the pre-action control plane that checks the agent before those tools execute.',
2140
+ 'The feedback loop matters: when a human gives a thumbs-down on an unsafe migration or query, ThumbGate can promote the failure pattern into a prevention rule so the next agent run cannot repeat it silently.',
2141
+ ],
2142
+ },
2143
+ {
2144
+ heading: 'First workflow to gate',
2145
+ paragraphs: [
2146
+ 'Start with one production migration path. Require the agent to show target environment, dry-run output, backup or snapshot evidence, rollback plan, and human approval before it can run the command. That single workflow makes the value visible to engineering leaders immediately.',
2147
+ ],
2148
+ },
2149
+ ],
2150
+ faq: [
2151
+ {
2152
+ question: 'Should AI agents be allowed to run production database migrations?',
2153
+ answer: 'Only behind an approval gate. Production migrations should require target verification, dry-run output, backup or snapshot evidence, rollback plan, and human approval before the command executes.',
2154
+ },
2155
+ {
2156
+ question: 'What database actions should be blocked by default?',
2157
+ answer: 'DROP, TRUNCATE, DROP DATABASE, DROP SCHEMA, role or grant changes, unbounded UPDATE or DELETE, and production migrations without rollback and dry-run evidence should be blocked or paused before execution.',
2158
+ },
2159
+ {
2160
+ question: 'Is this an AI DBA replacement?',
2161
+ answer: 'No. ThumbGate is the governance layer before an agent touches database tooling. It blocks known-bad actions and requires proof for risky actions; DBAs and platform teams still own database design and operations.',
2162
+ },
2163
+ ],
2164
+ relatedPaths: ['/guides/pre-action-checks', '/guides/ai-agent-pre-action-approval-gates', '/guides/best-tools-stop-ai-agents-breaking-production'],
2165
+ },
1655
2166
  buildHarnessOptimizationGuide(),
1656
2167
  buildCodeKnowledgeGraphGuardrailsGuide(),
1657
2168
  buildDeveloperMachineSupplyChainGuardrailsGuide(),
@@ -1901,6 +2412,234 @@ const PAGE_BLUEPRINTS = [
1901
2412
  ],
1902
2413
  relatedPaths: ['/compare/mem0', '/guides/stop-repeated-ai-agent-mistakes'],
1903
2414
  },
2415
+ {
2416
+ query: 'hermes agent guardrails',
2417
+ path: '/guides/hermes-agent-guardrails',
2418
+ pageType: 'integration',
2419
+ pillar: 'agent-workflows',
2420
+ title: 'Hermes Agent Guardrails | Firewall for Self-Improving Agents',
2421
+ heroTitle: 'Hermes Agent can grow with you. ThumbGate keeps the growing agent safe.',
2422
+ heroSummary: 'Hermes Agent points at the next wave: persistent memory, generated skills, messaging gateways, scheduled automations, and sandboxed execution. ThumbGate is the enforcement layer those workflows need before a remembered mistake becomes another real tool call.',
2423
+ takeaways: [
2424
+ 'Hermes validates the market shift toward long-running, self-improving agents.',
2425
+ 'Memory and generated skills increase leverage, but they also increase the blast radius of repeated mistakes.',
2426
+ 'ThumbGate should be positioned as the local-first pre-action firewall for Hermes-style agents, not as a general agent clone.',
2427
+ ],
2428
+ sections: [
2429
+ {
2430
+ heading: 'Why Hermes-style agents need a separate execution gate',
2431
+ paragraphs: [
2432
+ 'A persistent agent can remember projects, generate its own skills, run scheduled automations, and accept instructions from messaging gateways. That is powerful, but it also means one bad habit can persist longer and reach more surfaces.',
2433
+ 'The safety problem is not only whether the agent remembers. It is whether remembered lessons can stop the next risky shell command, git action, database write, deploy, browser click, or payment workflow before execution.',
2434
+ ],
2435
+ },
2436
+ {
2437
+ heading: 'What ThumbGate adds to Hermes-style workflows',
2438
+ bullets: [
2439
+ 'Pre-action checks before risky tool calls execute.',
2440
+ 'Thumbs-down feedback that becomes explicit prevention rules.',
2441
+ 'Evidence requirements for deploys, migrations, API calls, and production-facing changes.',
2442
+ 'Audit trails that show which lesson, rule, and workflow context allowed or blocked the action.',
2443
+ 'A local-first path for teams that want agent memory without handing every correction to a hosted black box.',
2444
+ ],
2445
+ },
2446
+ {
2447
+ heading: 'The buyer message',
2448
+ paragraphs: [
2449
+ 'Hermes can be the agent that grows with you. ThumbGate is the firewall that makes sure growth does not mean repeating expensive mistakes faster across more surfaces.',
2450
+ 'For teams evaluating persistent agents, the practical first step is not another prompt. It is one enforced rule from one real failure, proven locally, then expanded into Pro or a workflow hardening sprint when the risk is recurring.',
2451
+ ],
2452
+ },
2453
+ ],
2454
+ faq: [
2455
+ {
2456
+ question: 'Does ThumbGate replace Hermes Agent?',
2457
+ answer: 'No. Hermes is a general self-improving agent surface. ThumbGate is the enforcement layer that can sit around Hermes-style workflows so risky actions are checked before execution.',
2458
+ },
2459
+ {
2460
+ question: 'What Hermes features create the biggest need for guardrails?',
2461
+ answer: 'Persistent memory, generated skills, messaging gateways, scheduled automations, browser and tool control, and sandbox backends all increase the value of pre-action gates because the agent can act longer, faster, and from more entry points.',
2462
+ },
2463
+ {
2464
+ question: 'What should teams implement first?',
2465
+ answer: 'Start with one repeated failure pattern: force-push, destructive SQL, unsafe deploy, risky browser action, or off-scope file edit. Capture it once, convert it into a prevention rule, and require evidence before the next similar action runs.',
2466
+ },
2467
+ ],
2468
+ relatedPaths: ['/guides/long-running-agent-context-management', '/guides/background-agent-governance', '/guides/browser-automation-safety'],
2469
+ },
2470
+ {
2471
+ query: 'safe self evolution',
2472
+ path: '/guides/safe-self-evolution',
2473
+ pageType: 'guide',
2474
+ pillar: 'agent-workflows',
2475
+ title: 'Safe Self-Evolution | Autonomous Prompt Optimization without Regression',
2476
+ heroTitle: 'Self-Evolution is Polarizing. Make It Safe with Execution Gates.',
2477
+ heroSummary: 'Hermes-style autonomous agents learn by observing their own execution failures and automatically rewriting their skills or instructions. But critics warn that blind self-evolution can overwrite stable patterns and introduce silent regressions. ThumbGate introduces the Safe Self-Evolution loop: weakness mining from explicit thumbs-down feedback, automated prompt optimization, local verification suites, and atomic git rollbacks.',
2478
+ takeaways: [
2479
+ 'Self-improving agents need execution guardrails so a synthesized skill cannot bypass safety constraints.',
2480
+ 'Blind self-evolution is unstable; ThumbGate ensures prompt changes are verified against a local holdout suite before committing.',
2481
+ 'Rollback capability is mandatory: if validation fails, the evolution engine immediately reverts prompts to the last known-good state.',
2482
+ 'Explicit feedback is the anchor: optimize based on real thumbs-down signals, not hallucinatory failure guesses.'
2483
+ ],
2484
+ sections: [
2485
+ {
2486
+ heading: 'The self-evolution dilemma',
2487
+ paragraphs: [
2488
+ 'Nous Research’s Hermes Agent points at a future where developers do not write static instructions like CLAUDE.md. Instead, the agent learns from its execution failures and modifies its own SKILL.md files in real-time. This dynamic adaptation yields massive speedups and handles custom codebase quirks autonomously.',
2489
+ 'However, the critics are correct: when an agent has the power to edit its own rules without a verification gate, it will eventually overwrite a perfectly stable skill. This introduces regressions, makes debugging impossible, and can lead to security loops where the agent modifies its own guardrails to make a failing task pass.'
2490
+ ]
2491
+ },
2492
+ {
2493
+ heading: 'Safe self-evolution with ThumbGate',
2494
+ paragraphs: [
2495
+ 'ThumbGate implements a Safe Self-Evolution loop (based on the Self-Harness paradigm) that gives you the speed of self-improving agents without the instability:',
2496
+ '1. Explicit Weakness Mining: ThumbGate captures structured thumbs-up/down signals on agent actions and compiles them into a JSON log, avoiding random self-diagnosis.',
2497
+ '2. Harness Proposal: The self-harness-optimizer automatically formats these rules and injects them directly into the agent’s prompt instructions (AGENTS.md, GEMINI.md).',
2498
+ '3. Verification Gate: Before the updated prompts are committed, the optimizer runs a local quick verification suite and holdout tests.',
2499
+ '4. Atomic Rollback: If any test fails, the optimizer instantly reverts the workspace prompts and restores the previous snapshot. If they pass, it commits the update to Git.'
2500
+ ]
2501
+ },
2502
+ {
2503
+ heading: 'Competing with blind self-improvement',
2504
+ paragraphs: [
2505
+ 'To compete with agents like Hermes, you do not need to give up control of your codebase. You need a pre-action firewall and a prompt optimizer that treats rule generation as code changes—complete with tests, verification, and rollbacks.',
2506
+ 'This keeps your agent fast, keeps your instructions dynamic, and ensures your production-facing surfaces remain secure.'
2507
+ ]
2508
+ }
2509
+ ],
2510
+ faq: [
2511
+ {
2512
+ question: 'Does ThumbGate prevent the agent from changing its own rules?',
2513
+ answer: 'Yes. ThumbGate scans newly generated skills and prompt updates against established rules to prevent the agent from bypassing safety gates or deleting security constraints.'
2514
+ },
2515
+ {
2516
+ question: 'How does the rollback mechanism work?',
2517
+ answer: 'When the self-harness optimizer proposes new prompt sections, it saves a snapshot of the current prompt files. It then runs the verification commands. If the status is non-zero, it restores the backup files.'
2518
+ },
2519
+ {
2520
+ question: 'Is this compatible with Hermes Agent?',
2521
+ answer: 'Yes. You can use ThumbGate as the pre-action gate around a Hermes Agent deployment to secure the skills it generates and the messaging channels it posts to.'
2522
+ }
2523
+ ],
2524
+ relatedPaths: ['/guides/hermes-agent-guardrails', '/guides/agent-context-governance', '/guides/stop-repeated-ai-agent-mistakes'],
2525
+ },
2526
+ {
2527
+ query: 'agent context governance',
2528
+ path: '/guides/agent-context-governance',
2529
+ pageType: 'guide',
2530
+ pillar: 'pre-action-checks',
2531
+ title: 'Agent Context Governance | Stop Tokenmaxxing Drift Before Agents Act',
2532
+ heroTitle: 'More Context Is Not Governance. Clean Context Plus Action Gates Is.',
2533
+ heroSummary: 'AdaCoM-style context managers, the tokenmaxxing backlash, Claude Managed Agents, anti-rubber-stamp response prompts, model-provenance scares, ChatGPT Lockdown Mode, MCP routing attacks, resilient graph architectures, rising AI-authored code volume, AI email assistants, platform-agent orchestration, on-device QAT models, and backprop-style failure attribution all point to the same buyer need: long-running agents need structured intent, cleaner context, durable session logs, approved models, isolated execution, credential boundaries, tool lockdown, direct pushback, distributed gates, provenance, and pre-action checks before they touch real systems.',
2534
+ takeaways: [
2535
+ 'Long-context agents get better when a separate manager rewrites, preserves, prunes, or merges working context before the next step.',
2536
+ 'Tokenmaxxing creates uncontrolled spend and weak governance when teams cannot prove which agent work returned value.',
2537
+ 'Managed-agent architectures decouple the brain, hands, sessions, credentials, and sandboxes; ThumbGate adds the local-first action gate around those boundaries.',
2538
+ 'Response customization should become a gate too: no padded agreement, no vague completion claims, and no confident answer without evidence or blind-spot checks.',
2539
+ 'Lockdown modes validate the egress-control story: sensitive workflows need tool-surface limits, not just better prompts.',
2540
+ 'Model leaks and proxy resale scares make approved-provider checks a governance requirement, especially when frontier model cost is high.',
2541
+ 'MCP security research makes local config integrity a first-class control: endpoint rewrites and token-routing changes must be monitored before agents act.',
2542
+ 'Random-graph infrastructure suggests a governance architecture: use many small local gates that degrade proportionally instead of one central approval bottleneck.',
2543
+ 'As AI-authored code volume rises, teams need provenance and evidence gates so generated diffs are attributable, tested, and owned before merge.',
2544
+ 'AI customer-response assistants need draft governance: retrieved sources, prompt variables, category routing, and feedback should improve drafts without letting the agent send unsupported claims.',
2545
+ 'Enterprise agent platforms need one shared execution contract: structured specs, approved tools, scoped permissions, retries, evals, and traceability instead of 100 fragile team-specific agents.',
2546
+ 'On-device QAT models can reduce cost and preserve privacy for first-pass risk classification, but they should escalate rather than approve high-risk actions.',
2547
+ 'Backpropagation suggests a useful product metaphor: trace the agent run graph, score local risk at each edge, and cache the blame path so the same failure is blocked faster next time.',
2548
+ ],
2549
+ sections: [
2550
+ {
2551
+ heading: 'Why this matters now',
2552
+ paragraphs: [
2553
+ 'The market is moving away from prompt-only agents. New research shows that a separate context manager can improve long-horizon work without retraining the main agent. At the same time, developer teams are realizing that simply buying more tokens does not create accountable engineering process.',
2554
+ 'Claude Managed Agents adds the production vocabulary buyers now expect: agents, environments, sessions, sandbox isolation, credential separation, event logs, observability, permission policies, outcomes, and webhooks. ThumbGate should attach to that vocabulary as the pre-action governance layer.',
2555
+ ],
2556
+ },
2557
+ {
2558
+ heading: 'What ThumbGate should enforce',
2559
+ bullets: [
2560
+ 'Context hygiene gate: block high-risk actions when the agent is acting from raw chat history, stale memory, or unresolved contradictions.',
2561
+ 'Session evidence gate: require an append-only event log, resumable session ID, and proof links before long-running work can deploy, charge, message, or mutate production data.',
2562
+ 'Sandbox boundary gate: require isolated execution and explicit network or filesystem scope before generated code runs.',
2563
+ 'Credential boundary gate: block actions where tool credentials live beside generated code or where the action lacks user/on-behalf-of attribution.',
2564
+ 'Token ROI gate: flag tokenmaxxing workflows that spend heavily without a defined outcome, eval, or proof of returned value.',
2565
+ 'Response quality gate: require the agent to lead with the useful answer, call out weak assumptions, and avoid completion claims unless the evidence is attached.',
2566
+ 'Model provenance gate: require approved provider domains, known model IDs, expected price ceilings, and no shadow API proxy before routing frontier work.',
2567
+ 'Tool lockdown gate: disable or require explicit approval for browsing, downloads, agent mode, generated-code networking, and other outbound paths when sensitive data is in context.',
2568
+ 'MCP config integrity gate: alert on ~/.claude.json routing changes, unfamiliar MCP endpoints, localhost proxy additions, OAuth refresh anomalies, and dependency postinstall hooks.',
2569
+ 'Distributed gate mesh: keep enforcement close to each repo, tool, and workflow so one failed gate reduces coverage locally instead of collapsing the entire governance path.',
2570
+ 'AI-authored code gate: require generated-diff provenance, human owner, tests, risk label, and rollback evidence once agent-authored changes cross a team-defined threshold.',
2571
+ 'Customer-response draft gate: require retrieved source links, customer objective, response category, human approval, and no unsupported pricing/security claims before an email leaves draft mode.',
2572
+ 'Structured intent gate: require scope, out-of-scope systems, ordered steps, allowed tools, acceptance criteria, and rollback expectations before async agent execution starts.',
2573
+ 'Tool contract gate: require versioned schemas, explicit read/write permissions, stable error codes, observability hooks, and audit logging for every MCP tool call.',
2574
+ 'Evaluation gate: require golden tasks, regression checks, build/test evidence, and traceable PR or artifact output before a repeated workflow is promoted to platform automation.',
2575
+ 'Local classifier gate: run low-cost on-device models for first-pass risk labels, sensitive-data detection, and route selection, then escalate uncertain or high-blast-radius actions to stronger checks.',
2576
+ 'Failure attribution graph: record intent, retrieved context, tool choice, local risk score, evidence, and outcome for each step so future gates reuse the causal path instead of starting from scratch.',
2577
+ ],
2578
+ },
2579
+ {
2580
+ heading: 'The buyer message',
2581
+ paragraphs: [
2582
+ 'The pitch is not "use fewer tokens" or "summarize harder." The pitch is: keep the agent productive by feeding it the right context, then stop it before risky actions unless the session, sandbox, credentials, and evidence are clean.',
2583
+ 'This turns ThumbGate into the practitioner-led governance layer teams can adopt before top-down AI policy arrives. Start with one workflow, prove the gates locally, then expand to Pro or a hardening sprint once the same failure pattern recurs.',
2584
+ ],
2585
+ },
2586
+ ],
2587
+ faq: [
2588
+ {
2589
+ question: 'Is agent context governance just summarization?',
2590
+ answer: 'No. Summarization compresses. Context governance decides what to preserve, prune, merge, verify, or block based on the agent, task, risk, and evidence required before the next action.',
2591
+ },
2592
+ {
2593
+ question: 'Does this compete with Claude Managed Agents?',
2594
+ answer: 'No. Managed Agents provide production infrastructure. ThumbGate can sit beside managed or self-hosted agents as the local-first gate that turns session history, permissions, prior feedback, and evidence requirements into action-level enforcement.',
2595
+ },
2596
+ {
2597
+ question: 'What should teams implement first?',
2598
+ answer: 'Start with one high-cost workflow: deployments, billing, browser automation, database changes, or customer messaging. Require clean context, isolated execution, credential separation, and evidence before that workflow can run.',
2599
+ },
2600
+ {
2601
+ question: 'How does this apply to Claude custom instructions?',
2602
+ answer: 'Treat directness instructions as a policy, not a vibe. ThumbGate can turn them into checks that flag rubber-stamp agreement, missing pushback, and success claims that are not grounded in command output or artifacts.',
2603
+ },
2604
+ {
2605
+ question: 'How does ChatGPT Lockdown Mode help ThumbGate positioning?',
2606
+ answer: 'It validates the category. Lockdown Mode limits high-risk tools to reduce exfiltration paths; ThumbGate brings the same idea to coding and automation agents with local pre-action checks, scoped approvals, and audit evidence.',
2607
+ },
2608
+ {
2609
+ question: 'How should teams handle leaked or proxy-sold model claims?',
2610
+ answer: 'Do not route production work to unapproved proxy endpoints. Require provider provenance, expected model IDs, price ceilings, and security review before an agent can use a new frontier model route.',
2611
+ },
2612
+ {
2613
+ question: 'What is the first MCP security control to add?',
2614
+ answer: 'Watch the local MCP routing configuration for endpoint changes, new proxy addresses, and unexpected OAuth refresh behavior. Then rotate connected tokens only after the malicious hook or config rewrite has been removed.',
2615
+ },
2616
+ {
2617
+ question: 'Why mention random graph architecture in agent governance?',
2618
+ answer: 'Because centralized approval paths become bottlenecks. ThumbGate should use a mesh of local gates across repos, tools, agents, and workflows so control is resilient, inspectable, and does not require one fragile platform migration.',
2619
+ },
2620
+ {
2621
+ question: 'What changes when most new code is AI-authored?',
2622
+ answer: 'Review moves from typing every line to governing provenance, tests, ownership, and rollback. ThumbGate can require evidence before AI-authored diffs merge or touch production workflows.',
2623
+ },
2624
+ {
2625
+ question: 'How does this apply to AI email assistants?',
2626
+ answer: 'Treat every generated reply as a draft until it has source-backed context, a known category, customer-specific constraints, and human approval. Feedback from edited drafts should become retrieval and wording rules, not permission to send automatically.',
2627
+ },
2628
+ {
2629
+ question: 'What does platform ownership change?',
2630
+ answer: 'It prevents every team from building a slightly different unsafe agent loop. A shared platform defines intent shape, approved tools, retries, sandboxing, evals, logging, and gates while teams keep control over domain judgment.',
2631
+ },
2632
+ {
2633
+ question: 'Where do on-device QAT models fit?',
2634
+ answer: 'Use them for cheap private triage: classify risk, detect sensitive context, choose a route, or decide whether to escalate. Do not let a small local classifier silently approve destructive or external actions.',
2635
+ },
2636
+ {
2637
+ question: 'How does backpropagation help agent governance?',
2638
+ answer: 'Use the chain-rule idea as an audit pattern. Break the run into steps, score each local decision, multiply risk through the path, and cache the attribution so the next similar workflow is blocked or escalated earlier.',
2639
+ },
2640
+ ],
2641
+ relatedPaths: ['/guides/long-running-agent-context-management', '/guides/background-agent-governance', '/guides/hermes-agent-guardrails'],
2642
+ },
1904
2643
  {
1905
2644
  query: 'roo code alternative cline',
1906
2645
  path: '/guides/roo-code-alternative-cline',
@@ -1952,6 +2691,180 @@ const PAGE_BLUEPRINTS = [
1952
2691
  },
1953
2692
  ...BROWSER_BRIDGE_GUIDE_SPECS.map(buildBrowserBridgeGuide),
1954
2693
  ...AI_RECOMMENDATION_VISIBILITY_GUIDE_SPECS.map(buildAiRecommendationVisibilityGuide),
2694
+ {
2695
+ query: 'mcp tool governance',
2696
+ path: '/guides/mcp-tool-governance',
2697
+ pageType: 'guide',
2698
+ pillar: 'pre-action-checks',
2699
+ title: 'MCP Tool Governance | Pre-Action Gates Before Agents Call Tools',
2700
+ heroTitle: 'MCP tool governance before agents call real systems',
2701
+ heroSummary: 'MCP makes tools easy for agents to discover and call. ThumbGate adds the missing governance layer: approval boundaries, evidence requirements, and audit logs before high-risk MCP tool calls execute.',
2702
+ takeaways: [
2703
+ 'MCP adoption expands what agents can touch, so teams need a tool-call control plane.',
2704
+ 'Governance belongs before execution, not only in post-run logs or prompt rules.',
2705
+ 'ThumbGate turns feedback, policies, and evidence requirements into enforceable pre-action gates for MCP-compatible agent workflows.',
2706
+ ],
2707
+ sections: [
2708
+ {
2709
+ heading: 'Why MCP changes the risk model',
2710
+ paragraphs: [
2711
+ 'MCP turns databases, file systems, browsers, ticketing systems, cloud APIs, and internal tools into surfaces an agent can call. That is useful, but it also means a bad plan can become a real action faster than a human reviewer can notice.',
2712
+ 'The governance question is no longer only which tools exist. It is which agent, workflow, branch, file path, command, customer record, or environment is allowed to use each tool under which proof requirements.',
2713
+ ],
2714
+ },
2715
+ {
2716
+ heading: 'What MCP tool governance needs',
2717
+ bullets: [
2718
+ 'Tool inventory: know which tools are exposed to which agents and runtimes.',
2719
+ 'Risk tiers: classify destructive, customer-facing, production, payment, and data-export tools differently from read-only tools.',
2720
+ 'Pre-action checks: require evidence or approval before risky calls execute.',
2721
+ 'Feedback loops: turn thumbs-down reviews and incidents into reusable prevention rules.',
2722
+ 'Audit proof: log allowed, blocked, and approved tool calls with enough context for review.',
2723
+ ],
2724
+ },
2725
+ {
2726
+ heading: 'Where ThumbGate fits',
2727
+ paragraphs: [
2728
+ 'ThumbGate sits between generated intent and executed action. The agent can still plan and propose MCP tool calls, but ThumbGate checks the call against learned lessons, policy boundaries, evidence requirements, and workflow risk before the tool runs.',
2729
+ ],
2730
+ },
2731
+ ],
2732
+ faq: [
2733
+ {
2734
+ question: 'What is MCP tool governance?',
2735
+ answer: 'MCP tool governance is the policy, approval, evidence, and audit layer around tools exposed through Model Context Protocol so agents do not call high-risk systems without the right checks.',
2736
+ },
2737
+ {
2738
+ question: 'How is this different from an MCP server allowlist?',
2739
+ answer: 'An allowlist says a tool exists or is available. ThumbGate adds runtime context: tool arguments, branch, path, environment, prior feedback, evidence requirements, and whether this exact action should be allowed now.',
2740
+ },
2741
+ {
2742
+ question: 'Can ThumbGate work across multiple MCP-compatible agents?',
2743
+ answer: 'Yes. The same local-first lesson and pre-action gate pattern is designed for Claude Code, Cursor, Codex, Gemini, Amp, Cline, OpenCode, and MCP-compatible workflows.',
2744
+ },
2745
+ ],
2746
+ relatedPaths: ['/guides/pre-action-checks', '/guides/ai-mode-ads-agent-governance', '/guides/background-agent-governance'],
2747
+ },
2748
+ {
2749
+ query: 'ai agent pre action approval gates',
2750
+ path: '/guides/ai-agent-pre-action-approval-gates',
2751
+ pageType: 'guide',
2752
+ pillar: 'pre-action-checks',
2753
+ title: 'AI Agent Pre-Action Approval Gates | Human Review Before Risky Tool Calls',
2754
+ heroTitle: 'AI agent pre-action approval gates for risky tool calls',
2755
+ heroSummary: 'Human review after the damage lands is too late. ThumbGate adds pre-action approval gates so risky AI-agent commands, deploys, file edits, API calls, and MCP tool calls can require evidence or explicit approval before execution.',
2756
+ takeaways: [
2757
+ 'Approval gates matter most at the action boundary, where the agent is about to touch files, terminals, APIs, CI, payments, or production systems.',
2758
+ 'The right gate can block, pause for approval, or log-and-continue depending on risk.',
2759
+ 'ThumbGate converts prior thumbs-downs, workflow policies, and verification expectations into reusable approval rules.',
2760
+ ],
2761
+ sections: [
2762
+ {
2763
+ heading: 'Why approval must happen before execution',
2764
+ paragraphs: [
2765
+ 'Many agent failures are irreversible or expensive by the time a post-run reviewer sees them: force-pushes, destructive SQL, unsafe deploys, leaked secrets, customer-facing messages, and runaway API calls.',
2766
+ 'A pre-action approval gate pauses the action while there is still something to decide. The agent keeps its speed on safe work, but risky work requires proof, policy match, or a human yes.',
2767
+ ],
2768
+ },
2769
+ {
2770
+ heading: 'Three practical gate outcomes',
2771
+ bullets: [
2772
+ 'Block: deny known-bad actions such as force-pushing protected branches or touching secret files.',
2773
+ 'Approve: pause production deploys, schema migrations, payment actions, or customer-facing sends until a human approves.',
2774
+ 'Log: allow lower-risk actions while preserving audit evidence for review and future lessons.',
2775
+ ],
2776
+ },
2777
+ {
2778
+ heading: 'How ThumbGate turns approvals into learning',
2779
+ paragraphs: [
2780
+ 'Every approval, block, and thumbs-down gives the system better operating context. Repeated failures become prevention rules, accepted safe paths become reinforced lessons, and the audit trail gives teams evidence that the boundary fired before execution.',
2781
+ ],
2782
+ },
2783
+ ],
2784
+ faq: [
2785
+ {
2786
+ question: 'What should require a pre-action approval gate?',
2787
+ answer: 'Production deploys, destructive database actions, protected-branch writes, payment or refund actions, customer-facing sends, secret or PII access, high-cost API calls, and any repeated failure pattern the team has already corrected once.',
2788
+ },
2789
+ {
2790
+ question: 'Do approval gates slow every agent action down?',
2791
+ answer: 'No. Good gates are risk-tiered. Safe actions can continue, uncertain actions can be logged, risky actions can pause for approval, and known-bad actions can be blocked.',
2792
+ },
2793
+ {
2794
+ question: 'How does ThumbGate know what to block?',
2795
+ answer: 'ThumbGate uses explicit feedback, learned lessons, policy templates, command and path context, evidence requirements, and prior gate outcomes to decide whether the proposed action should proceed.',
2796
+ },
2797
+ ],
2798
+ relatedPaths: ['/guides/pre-action-checks', '/guides/mcp-tool-governance', '/guides/ai-agent-governance-sprint'],
2799
+ },
2800
+ {
2801
+ query: 'agentic web governance',
2802
+ path: '/guides/agentic-web-governance',
2803
+ pageType: 'guide',
2804
+ pillar: 'pre-action-checks',
2805
+ title: 'Agentic Web Governance | Pre-Action Checks When Bots Outnumber Humans',
2806
+ heroTitle: 'Bots already outnumber humans on the web. AI agents need pre-action governance.',
2807
+ heroSummary: 'Cloudflare says automated requests now make up the majority of HTML traffic. ThumbGate turns that agentic-web shift into a buyer-ready governance story: machine-readable proof for AI search and pre-action checks before agents touch real systems.',
2808
+ takeaways: [
2809
+ 'The promotion hook is immediate: the web is becoming agent-first, so AI-agent actions need governance before execution.',
2810
+ 'AI search and AI browsers reward machine-readable, authoritative, proof-backed pages instead of vague product copy.',
2811
+ 'ThumbGate should own the bridge between agentic traffic, MCP tool calls, and pre-action checks for code, deploys, data, money, and customer systems.',
2812
+ ],
2813
+ sections: [
2814
+ {
2815
+ heading: 'Why the bot-majority milestone matters',
2816
+ paragraphs: [
2817
+ 'Search Engine Land reported on June 5, 2026 that Cloudflare data showed automated traffic at about 57.3% of worldwide HTTP requests to HTML content, versus 42.7% for humans. That is not the same as human attention, but it is a real signal that AI agents and bots are becoming the default way the web is requested, summarized, and acted on.',
2818
+ 'For ThumbGate promotion, the lesson is not "get more bot traffic." The lesson is that every company will need controls for agent actions that happen before a human click, before a dashboard session, and before a normal attribution path records intent.',
2819
+ ],
2820
+ },
2821
+ {
2822
+ heading: 'The buyer problem this creates',
2823
+ bullets: [
2824
+ 'AI crawlers and agents can visit far more pages than a human researcher, increasing load without creating normal referral or checkout signals.',
2825
+ 'Agentic search can summarize the answer before the buyer ever lands on the site, so content must be structured enough for LLMs to cite accurately.',
2826
+ 'Internal AI agents can also multiply actions: file edits, shell commands, API calls, database reads, deploy attempts, and customer-system writes.',
2827
+ 'More agent actions without a pre-action boundary means more repeated mistakes, more hidden cost, and weaker auditability.',
2828
+ ],
2829
+ },
2830
+ {
2831
+ heading: 'Where ThumbGate fits the agentic web',
2832
+ paragraphs: [
2833
+ 'ThumbGate is the pre-action governance layer for the same agentic shift. The public website gives AI systems machine-readable context, proof links, FAQ schema, and canonical pages. The product then gives engineering teams runtime gates before agents act.',
2834
+ 'That lets the promotion story stay concrete: bots and AI agents already outnumber humans in web requests; ThumbGate makes sure your own AI agents do not behave like unmanaged bots inside your repo, browser, database, CI, payment flow, or customer systems.',
2835
+ ],
2836
+ bullets: [
2837
+ 'Use /llm-context.md and /.well-known/llms.txt to make ThumbGate easy for ChatGPT, Claude, Perplexity, Gemini, Grok, and Google AI features to summarize.',
2838
+ 'Use pre-action checks to govern MCP tool calls, browser automation, database writes, publish commands, and payment/customer-system actions.',
2839
+ 'Use feedback capture so a thumbs-down on one bad agent pattern becomes a repeat-blocking rule across the next session and team workflow.',
2840
+ ],
2841
+ },
2842
+ {
2843
+ heading: 'High-ROI promotion moves',
2844
+ bullets: [
2845
+ 'Publish this page as the canonical "agentic web governance" explainer and link it from the homepage, learn hub, llms.txt, and sitemap.',
2846
+ 'Pitch the line: "Bots already outnumber humans on the web. ThumbGate keeps AI agents from acting like unmanaged bots in your codebase."',
2847
+ 'Target buyer prompts such as "how do I govern AI agents before they call tools?", "AI crawler visibility for developer tools", and "pre-action checks for MCP tools."',
2848
+ 'Measure success in Search Console AI reports, first-party landing events, and checkout/intake paths instead of raw traffic alone.',
2849
+ ],
2850
+ },
2851
+ ],
2852
+ faq: [
2853
+ {
2854
+ question: 'What is agentic web governance?',
2855
+ answer: 'Agentic web governance is the content, policy, approval, and runtime-control layer needed when AI agents browse, summarize, and act on behalf of users or teams. For ThumbGate, it means machine-readable public proof plus pre-action checks before internal agents touch real systems.',
2856
+ },
2857
+ {
2858
+ question: 'Does bot traffic mean ThumbGate should block AI crawlers?',
2859
+ answer: 'No. For promotion, ThumbGate should allow legitimate AI discovery while publishing clear llms.txt, schema, canonical pages, and proof links. The product should block risky internal agent actions, not useful AI-search discovery.',
2860
+ },
2861
+ {
2862
+ question: 'How does this create revenue?',
2863
+ answer: 'It gives ThumbGate a timely category narrative for buyers: as agent actions multiply, teams need pre-action controls before code, data, deploys, payments, or customers are touched. The page routes that demand into Pro checkout and the Team workflow hardening sprint.',
2864
+ },
2865
+ ],
2866
+ relatedPaths: ['/guides/ai-search-topical-presence', '/guides/mcp-tool-governance', '/guides/ai-agent-pre-action-approval-gates'],
2867
+ },
1955
2868
  guideBlueprint({
1956
2869
  query: 'autoresearch agent safety',
1957
2870
  path: '/guides/autoresearch-agent-safety',
@@ -2475,10 +3388,6 @@ function createPageSpec(blueprint, row) {
2475
3388
  },
2476
3389
  proofLinks: [
2477
3390
  { label: 'Verification evidence', href: PRODUCT.verificationUrl },
2478
- { label: 'Automation proof', href: PRODUCT.automationUrl },
2479
- ...(blueprint.path === '/guides/agent-harness-optimization'
2480
- ? [{ label: 'Harness proof', href: 'https://github.com/IgorGanapolsky/ThumbGate/blob/main/proof/harnesses-report.json' }]
2481
- : []),
2482
3391
  { label: 'GitHub repository', href: PRODUCT.repoUrl },
2483
3392
  ],
2484
3393
  changefreq: blueprint.pageType === 'comparison' ? 'weekly' : 'monthly',
@@ -2756,7 +3665,7 @@ function renderSeoPageHtml(page, runtimeConfig = {}) {
2756
3665
  <meta property="og:type" content="article" />
2757
3666
  <meta property="og:url" content="${escapeHtml(canonicalUrl)}" />
2758
3667
  <link rel="canonical" href="${escapeHtml(canonicalUrl)}" />
2759
- <link rel="llm-context" href="/public/llm-context.md" type="text/markdown" />
3668
+ <link rel="llm-context" href="/llm-context.md" type="text/markdown" />
2760
3669
  <link rel="icon" type="image/svg+xml" href="/thumbgate-icon.png" />
2761
3670
  <link rel="apple-touch-icon" href="/assets/brand/thumbgate-mark.svg" />
2762
3671
  <meta property="og:image" content="/og.png" />
@@ -3003,7 +3912,7 @@ ${renderWebPageJsonLd(page, { appOrigin })}
3003
3912
  <body>
3004
3913
  <div class="topbar">
3005
3914
  <div class="container">
3006
- <a class="brand" href="/"><img src="/assets/brand/thumbgate-mark-inline.svg" alt="ThumbGate" class="logo-mark" width="28" height="28"><span class="logo-text">ThumbGate</span></a>
3915
+ <a class="brand" href="/"><img src="/assets/brand/thumbgate-mark-inline-v3.svg" alt="ThumbGate" class="logo-mark" width="28" height="28"><span class="logo-text">ThumbGate</span></a>
3007
3916
  <a href="${escapeHtml(PRODUCT.verificationUrl)}" target="_blank" rel="noopener">Verification evidence</a>
3008
3917
  </div>
3009
3918
  </div>