site_name: ThothII Docs
site_description: Functional, technical, and operational documentation for ThothII
site_url: https://git.tylconsulting.it/thothii-docs/
docs_dir: docs
site_dir: site
use_directory_urls: true
theme:
  name: windmill
  highlightjs: true
  hljs_languages:
  - yaml
  - sql
  - bash
  - python
  - json
  - typescript
plugins:
- search
- mermaid2
extra_css:
- stylesheets/extra.css
extra_javascript:
- javascripts/layout-init.js
markdown_extensions:
- admonition
- attr_list
- md_in_html
- tables
- toc:
    permalink: true
- pymdownx.details
- pymdownx.highlight:
    anchor_linenums: true
- pymdownx.inlinehilite
- pymdownx.snippets:
    base_path:
    - .
- pymdownx.superfences:
    custom_fences:
    - name: mermaid
      class: mermaid
      format: !!python/name:mermaid2.fence_mermaid
- pymdownx.tabbed:
    alternate_style: true
nav:
- Home: index.md
- Install and operate:
  - Install and first start: install/first-start.md
  - Local authentication: install/authentication-local.md
  - Generic OIDC: install/authentication-oidc.md
  - Authentik: install/authentik.md
  - Workspace operations: operations/workspaces.md
  - Pi model configuration: general/pi-configuration.md
  - Docker installation contexts: installazione-docker-4-contesti.md
- Use ThothII:
  - User guide: guida-utente.md
  - Database management: operations/database-management.md
  - Evidence authoring and publication: evidence.md
  - Workflow references:
    - Initial disambiguation: disambiguazione-iniziale.md
    - Memory management: gestione-memory.md
    - Operating skills: skills.md
- Architecture:
  - Overview: architecture/overview.md
  - Components, modules, and flows: architecture/components.md
  - Authentication and authorization: architecture/authentication.md
- Contracts and integration:
  - Catalog schema snapshot RPC: contracts/catalog-schema-snapshot.md
  - Workspace preprocessing CLI: contracts/workspace-preprocessing-cli.md
  - tht–DWH contract: contracts/tht-dwh.md
  - Workspace Evidence v3 contract: contracts/workspace-evidence-v3.md
  - DWH REST server: install/dwh-auth-server.md
  - DWH client enrollment: install/dwh-auth-client-enrollment.md
  - DWH REST TLS: install/dwh-auth-tls.md
- Decisions and acceptance:
  - Architecture decisions:
    - 0001 Metadata catalog: adr/0001-postgres-metadata-catalog.md
    - 0002 Workspace database secrets: adr/0002-workspace-database-secret-references.md
    - 0003 Installation-local bindings: adr/0003-installation-local-database-bindings.md
    - 0004 Fastify/Kysely catalog: adr/0004-fastify-kysely-metadata-catalog.md
    - 0005 Table deletion during synchronization: adr/0005-hard-delete-catalog-tables-during-synchronization.md
    - 0006 Physical and logical relationships: adr/0006-separate-physical-and-logical-relationships.md
    - 0007 Authoritative schema synchronization: adr/0007-durable-authoritative-schema-synchronization.md
    - 0008 Manual catalog cleanup: adr/0008-allow-manual-catalog-metadata-cleanup.md
    - 0009 Sequential description generation: adr/0009-use-one-sequential-description-generation-run.md
    - 0010 Bounded source samples: adr/0010-allow-bounded-real-source-samples-for-description-generation.md
    - 0011 Sensitive data flag: adr/0011-gate-source-samples-with-a-sensitive-data-flag.md
  - AI catalog description acceptance: testing/2026-08-29-ai-catalog-description-generation-acceptance.md
  - Design records:
    - Metadata catalog design: plans/2026-08-26-metadata-catalog-from-thothai.md
    - Description generation design: plans/2026-08-28-ai-catalog-description-generation.md
    - Description generation specification: plans/2026-08-28-ai-catalog-description-generation-spec.md