mkdocs.yml

site_name: "I³ — Implicit Interaction Intelligence"
site_description: >-
  Privacy-first, edge-ready adaptive AI companion that learns from how users
  interact. Custom TCN encoder, ~6.3M-parameter custom SLM with cross-attention
  conditioning, and a contextual Thompson-sampling router.
site_author: "Tamer Atesyakar"
site_url: "https://abailey81.github.io/implicit-interaction-intelligence/"

repo_url: "https://github.com/abailey81/implicit-interaction-intelligence"
repo_name: "abailey81/implicit-interaction-intelligence"
edit_uri: "edit/main/docs/"

copyright: "© 2026 Tamer Atesyakar — MIT License"

strict: false

# ──────────────────────────────────────────────────────────────────────────
# Validation — relax absolute/unrecognised-link failures because many docs
# page intentionally cross-reference source files (``../../i3/...``) and
# repository-root files (``../README.md``) that are not part of the mkdocs
# navigation tree.  These are useful on GitHub where the whole repo is
# browseable, and we leave them as plain text on the rendered site.
# Anchor mismatches and truly missing nav entries stay at warn/warn so
# ``mkdocs build --strict`` still fails on genuine link rot.
# ──────────────────────────────────────────────────────────────────────────
validation:
  nav:
    omitted_files: warn
    not_found: warn
    absolute_links: info
  links:
    not_found: info
    absolute_links: info
    unrecognized_links: info
    anchors: warn

# ──────────────────────────────────────────────────────────────────────────
# Theme
# ──────────────────────────────────────────────────────────────────────────
theme:
  name: material
  custom_dir: docs/overrides
  logo: assets/logo.svg
  favicon: assets/favicon.svg
  icon:
    repo: fontawesome/brands/github
    edit: material/pencil
    view: material/eye
  language: en
  font:
    text: Inter
    code: JetBrains Mono
  palette:
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: deep orange
      accent: amber
      toggle:
        icon: material/weather-sunny
        name: Switch to light mode
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: deep orange
      accent: amber
      toggle:
        icon: material/weather-night
        name: Switch to dark mode
  features:
    - navigation.instant
    - navigation.instant.progress
    - navigation.tracking
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.sections
    - navigation.indexes
    - navigation.top
    - navigation.footer
    - search.suggest
    - search.highlight
    - search.share
    - content.code.copy
    - content.code.annotate
    - content.tabs.link
    - content.action.edit
    - content.action.view
    - content.tooltips
    - toc.follow
    - toc.integrate
    - announce.dismiss

# ──────────────────────────────────────────────────────────────────────────
# Plugins
# ──────────────────────────────────────────────────────────────────────────
plugins:
  - search:
      lang: en
      separator: '[\s\-\.]+'
  - mkdocstrings:
      default_handler: python
      handlers:
        python:
          paths: ["."]
          options:
            docstring_style: google
            show_source: true
            show_root_heading: true
            show_root_full_path: false
            show_signature_annotations: true
            show_symbol_type_heading: true
            show_symbol_type_toc: true
            separate_signature: true
            merge_init_into_class: true
            docstring_section_style: table
            members_order: source
            filters: ["!^_"]
  - include-markdown
  - git-revision-date-localized:
      enable_creation_date: true
      type: timeago
      fallback_to_build_date: true
  - macros
  - mermaid2:
      arguments:
        theme: |
          ^(JSON.parse(__md_get("__palette").index == 1)) ? 'dark' : 'default'
  - minify:
      minify_html: true
      minify_js: true
      minify_css: true
  - glightbox:
      touchNavigation: true
      loop: false
      effect: zoom
      slide_effect: slide
      width: 100%
      height: auto
      zoomable: true
      draggable: true
  - social:
      cards_layout_options:
        background_color: "#1a1a1a"
        color: "#ffb300"

# ──────────────────────────────────────────────────────────────────────────
# Markdown extensions
# ──────────────────────────────────────────────────────────────────────────
markdown_extensions:
  - admonition
  - attr_list
  - def_list
  - footnotes
  - md_in_html
  - tables
  - toc:
      permalink: true
      permalink_title: "Permanent link"
      toc_depth: 4
  - pymdownx.arithmatex:
      generic: true
  - pymdownx.betterem
  - pymdownx.caret
  - pymdownx.critic
  - pymdownx.details
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
      linenums: true
  - pymdownx.inlinehilite
  - pymdownx.keys
  - pymdownx.magiclink:
      repo_url_shortener: true
      user: abailey81
      repo: implicit-interaction-intelligence
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:mermaid2.fence_mermaid_custom
  - pymdownx.tabbed:
      alternate_style: true
      slugify: !!python/object/apply:pymdownx.slugs.slugify {kwds: {case: lower}}
  - pymdownx.tasklist:
      custom_checkbox: true
      clickable_checkbox: false
  - pymdownx.tilde
  - pymdownx.snippets:
      check_paths: true
      base_path: ["."]

# ──────────────────────────────────────────────────────────────────────────
# Extras
# ──────────────────────────────────────────────────────────────────────────
extra:
  generator: false
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/abailey81/implicit-interaction-intelligence
      name: I³ on GitHub
  version:
    provider: mike
    default: latest

extra_css:
  - stylesheets/extra.css

extra_javascript:
  - javascripts/mathjax.js
  - https://polyfill.io/v3/polyfill.min.js?features=es6
  - https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js

# ──────────────────────────────────────────────────────────────────────────
# Navigation
# ──────────────────────────────────────────────────────────────────────────
nav:
  - Home: index.md
  - Getting Started:
      - getting-started/installation.md
      - getting-started/quickstart.md
      - getting-started/configuration.md
      - getting-started/training.md
  - Architecture:
      - Overview: architecture/overview.md
      - Full Reference: architecture/full-reference.md
      - Layers: architecture/layers.md
      - Cross-Attention Conditioning: architecture/cross-attention-conditioning.md
      - Router: architecture/router.md
      - Privacy: architecture/privacy.md
  - API:
      - Overview: api/overview.md
      - REST: api/rest.md
      - WebSocket: api/websocket.md
      - Python SDK: api/python.md
  - Research:
      - 2026 Landscape Survey: research/2026_landscape.md
      - Cross-Attention: research/cross_attention.md
      - Contrastive Loss: research/contrastive_loss.md
      - Bandit Theory: research/bandit_theory.md
      - Stretch Goals: research/stretch_goals.md
      - Browser Inference: research/browser_inference.md
      - Distributed Training: research/distributed_training.md
      - Differential Privacy: research/differential_privacy.md
      - Adaptive TTS: research/adaptive_tts.md
      - Adaptive Compute Router: research/adaptive_compute_router.md
      - ImplicitAdaptBench: research/implicit_adapt_bench.md
      - Mechanistic Interpretability: research/mechanistic_interpretability.md
      - Interpretability Quickstart: research/interpretability_quickstart.md
      - Sparse Autoencoders: research/sparse_autoencoders.md
      - Closed-Loop Evaluation: research/closed_loop_evaluation.md
      - Closed-Loop Quickstart: research/closed_loop_quickstart.md
      - Uncertainty + Counterfactuals: research/uncertainty_and_counterfactuals.md
      - Multimodal Extension: research/multimodal_extension.md
      - PPG HRV Integration: research/ppg_hrv_integration.md
      - PPG HRV Quickstart: research/ppg_hrv_quickstart.md
      - LLM-as-Judge: research/llm_as_judge.md
      - Active Preference Learning: research/active_preference_learning.md
      - Continual Learning EWC: research/continual_learning_ewc.md
      - Meta-Learning MAML: research/meta_learning_maml.md
      - Red-Team Results: research/redteam_results.md
      - Experiments Overview: experiments/README.md
      - Preregistration: experiments/preregistration.md
      - Ablation Report: experiments/ablation_report.md
  - Integration:
      - Model Context Protocol: integration/mcp.md
  - Cloud:
      - LLM Ecosystem: cloud/llm_ecosystem.md
  - Edge:
      - edge/README.md
      - Alternative Runtimes: edge/alternative_runtimes.md
  - Operations:
      - Deployment: operations/deployment.md
      - Observability: operations/observability.md
      - Docker: operations/docker.md
      - Kubernetes: operations/kubernetes.md
      - WSL2 on Windows: operations/wsl.md
      - Runbook: operations/runbook.md
      - Troubleshooting: operations/troubleshooting.md
      - Reproducibility: operations/reproducibility.md
      - Analytics: operations/analytics.md
      - Advanced Demo UI: operations/advanced_ui.md
      - Verification Harness: operations/verification_harness.md
      - Edge Profiling Report: edge/profiling-report.md
      - MLOps: mlops/README.md
  - Provider Layer:
      - cloud/provider_universality.md
  - Agentic Core:
      - huawei/agentic_core.md
  - Responsible AI:
      - responsible_ai/README.md
      - Model Card (SLM): responsible_ai/model_card_slm.md
      - Model Card (TCN): responsible_ai/model_card_tcn.md
      - Data Card: responsible_ai/data_card.md
      - Accessibility Statement: responsible_ai/accessibility_statement.md
      - EU AI Act Scope: responsible_ai/eu_ai_act_scope.md
  - Huawei:
      - huawei/README.md
      - JD → Repo Map: huawei/jd_to_repo_map.md
      - Feature Matrix (vs Apple / Pixel / Galaxy / Pangu / Qwen / DeepSeek / Gemma / Kimi): huawei/feature_matrix.md
      - Design Brief (persona + interaction principle): huawei/design_brief.md
      - Fine-tune Artefact (Qwen + Gemini side-by-side): huawei/finetune_artefact.md
      - Iteration Log (51-iter trajectory): huawei/iteration_log.md
      - Research Reading List (15 papers 2024-2026): huawei/research_reading_list.md
      - Forward Roadmap (next 6 months at HMI Lab): huawei/forward_roadmap.md
      - Onboarding a Teammate (1-day handover): huawei/onboarding_a_teammate.md
      - HarmonyOS + HMAF Integration: huawei/harmony_hmaf_integration.md
      - HarmonyOS 6 AI Glasses Alignment: huawei/harmonyos6_ai_glasses_alignment.md
      - Kirin Deployment: huawei/kirin_deployment.md
      - L1–L5 Framework: huawei/l1_l5_framework.md
      - Edinburgh Joint Lab: huawei/edinburgh_joint_lab.md
      - Smart Hanhan: huawei/smart_hanhan.md
      - Interview Talking Points: huawei/interview_talking_points.md
      - Agentic Core: huawei/agentic_core.md
  - Slides:
      - slides/README.md
      - Presentation: slides/presentation.md
      - Speaker Notes: slides/speaker_notes.md
      - Rehearsal Timings: slides/rehearsal_timings.md
      - Q&A Prep: slides/qa_prep.md
      - Closing Lines: slides/closing_lines.md
      - Demo Script: slides/demo-script.md
  - Paper:
      - paper/README.md
      - Research Paper: paper/I3_research_paper.md
      - Executive Summary: paper/executive-summary.md
      - Conference Poster: poster/conference_poster.md
      - Patent Disclosure: patent/provisional_disclosure.md
  - ADRs:
      - adr/index.md
      - Template: adr/template.md
      - 0001 — Custom SLM: adr/0001-custom-slm-over-huggingface.md
      - 0002 — TCN Encoder: adr/0002-tcn-over-lstm-transformer.md
      - 0003 — Thompson Sampling: adr/0003-thompson-sampling-over-ucb.md
      - 0004 — Privacy by Architecture: adr/0004-privacy-by-architecture.md
      - 0005 — FastAPI: adr/0005-fastapi-over-flask.md
      - 0006 — Poetry: adr/0006-poetry-over-pip-tools.md
      - 0007 — OpenTelemetry: adr/0007-opentelemetry-for-observability.md
      - 0008 — Fernet: adr/0008-fernet-over-custom-crypto.md
      - 0009 — SQLite: adr/0009-sqlite-over-redis.md
      - 0010 — Pydantic v2: adr/0010-pydantic-v2-config.md
  - Security:
      - security/index.md
      - Policy as Code: security/policy_as_code.md
      - SLSA Build Level 3: security/slsa.md
      - Supply Chain: security/supply-chain.md
  - Contributing: contributing/index.md
  - Reference:
      - Glossary: glossary.md
      - Changelog: changelog.md