contextweaver/mkdocs.yml at main · dgenio/contextweaver · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
site_name: contextweaver
site_url: https://dgenio.github.io/contextweaver
site_description: >-
  Context firewall + tool router for MCP and tool-heavy AI agents.
  Phase-specific, budget-aware context engineering. Python ≥ 3.10.

repo_url: https://github.com/dgenio/contextweaver
repo_name: dgenio/contextweaver
edit_uri: edit/main/

theme:
  name: material
  palette:
    - scheme: default
      primary: indigo
      accent: indigo
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode
    - scheme: slate
      primary: indigo
      accent: indigo
      toggle:
        icon: material/brightness-4
        name: Switch to light mode
  features:
    - navigation.tabs
    - navigation.sections
    - navigation.top
    - navigation.indexes
    - search.suggest
    - search.highlight
    - content.code.copy
    - content.action.edit

plugins:
  - search
  - gen-files:
      scripts:
        - docs/gen_ref_pages.py
  - literate-nav:
      nav_file: SUMMARY.md
  - section-index
  - mkdocstrings:
      handlers:
        python:
          paths: [src]
          options:
            docstring_style: google
            show_source: true
            show_root_heading: true
            show_root_full_path: false
            members_order: source
            separate_signature: true
            show_signature_annotations: true
            unwrap_annotated: true
            filters:
              - "!^_"
            merge_init_into_class: true
            show_if_no_docstring: false

nav:
  - Home: index.md
  - Quickstart: quickstart.md
  - Daily Driver: daily_driver.md
  - Showcase: showcase.md
  - 60-second demo: killer_demo.md
  - Where it fits: comparison.md
  - Ecosystem Map: ecosystem.md
  - FAQ: faq.md
  - Which pattern fits?: which_pattern.md
  - Context Firewall: context_firewall.md
  - Firewall Boundary (Frame seam): context_firewall_boundary.md
  - Tool Router: tool_router.md
  - Concepts: concepts.md
  - How contextweaver Fits (deeper): interop.md
  - Skill Cards (interop): interop_skill_cards.md
  - Cookbook: cookbook.md
  - Architectures:
      - Overview: architectures/index.md
      - Catalog showcase: architectures/catalog_showcase.md
      - MCP Context Gateway: architectures/mcp_context_gateway.md
      - Slack ops bot: architectures/slack_ops_bot.md
      - Code-review bot: architectures/code_review_bot.md
      - Voice agent: architectures/voice_agent.md
      - LangGraph agent loop: architectures/langgraph_agent_loop.md
      - Evaluation-artifact profile: architectures/eval_artifact_profile.md
  - Recipes:
      - Overview: recipes/index.md
      - Claude Desktop: recipes/claude_desktop.md
      - Claude Code: recipes/claude_code.md
      - GitHub Copilot: recipes/github_copilot.md
      - Cursor: recipes/cursor.md
  - Gateway Spec: gateway_spec.md
  - HTTP Sidecar: sidecar.md
  - Security Model: security_model.md
  - Security Tooling: security_tooling.md
  - Guides:
      - Runtime Loop: guide_agent_loop.md
      - MCP Integration: integration_mcp.md
      - A2A Integration: integration_a2a.md
      - LlamaIndex: integration_llamaindex.md
      - LangChain + LangGraph: integration_langchain.md
      - OpenAI Agents SDK: integration_openai_adk.md
      - Google ADK / Vertex AI: integration_google_adk.md
      - Pipecat: integration_pipecat.md
      - CrewAI: integration_crewai.md
      - Pydantic AI: integration_pydantic_ai.md
      - smolagents: integration_smolagents.md
      - Agno: integration_agno.md
      - Microsoft Agent Framework: integration_agent_framework.md
      - OpenAPI: integration_openapi.md
      - Agent Skills: integration_agent_skills.md
      - External Memory: integration_memory.md
      - Persistent & Remote Stores: persistent_stores.md
      - Puppetmaster: integration_puppetmaster.md
  - Architecture: architecture.md
  - Benchmarks: benchmarks.md
  - Adopter Benchmark Report: benchmark_report.md
  - Token Calibration: token_calibration.md
  - Context Rot Demo: context_rot.md
  - Stability: stability.md
  - Upgrading: upgrading.md
  - Launch Kit: launch_kit.md
  - Contracts: contracts.md
  - Observability: integration_otel.md
  - Troubleshooting: troubleshooting.md
  - Error Reference: errors.md
  - Contribution Paths: contributing_paths.md
  - API Reference: reference/

exclude_docs: |
  agent-context/*
  gen_ref_pages.py
  schemas/**/*

not_in_nav: |
  agent-context/*
  gen_ref_pages.py