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
  - Manual standalone installation (Italian): install/standalone-manual-it.md
  - Manual standalone installation (English): install/standalone-manual-en.md
  - Server upgrade from legacy release: operations/server-upgrade-gitea-workspace-v2.md
  - Preprocessing-complete server handoff: operations/server-handoff-260906-preprocessing-complete.md
  - Local authentication: install/authentication-local.md
  - Generic OIDC: install/authentication-oidc.md
  - Portal upstream authentication: install/authentication-upstream.md
  - Authentik: install/authentik.md
  - Workspace operations: operations/workspaces.md
  - Shell and localization: operations/shell-and-localization.md
  - Codex server handoff: operations/server-codex-handoff.md
  - Full shell verification: reports/2026-09-13-full-shell-implementation.md
  - Local sensitivity analysis: operations/sensitivity-analysis.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
  - Full and embedded rendering: architecture/application-shell.md
- Contracts and integration:
  - Portal Shell Adapter v1: contracts/portal-shell-adapter-v1.md
  - 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 contract: contracts/workspace-evidence-v3.md
  - Editable Curated Evidence v4: contracts/curated-evidence-v4.md
  - Session archive corrections: contracts/archive-repair.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:
  - Shell and authentication acceptance: testing/authentication-manual-acceptance.md
  - 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
    - 0012 Effective relationship authority: adr/0012-use-the-catalog-as-the-logical-relationship-authority.md
    - 0013 Installation model catalog: adr/0013-use-one-installation-model-catalog-with-runtime-projections.md
    - 0014 Local sensitive-column assessment: adr/0014-assess-sensitive-columns-locally-from-source-content.md
    - 0015 Progressive sensitive-column sampling: adr/0015-use-progressive-sampling-for-sensitive-columns.md
    - 0016 PostgreSQL metadata for all core consumers: adr/0016-use-postgres-metadata-for-all-core-consumers.md
    - 0017 Separate reference vectors from runtime memory: adr/0017-separate-reference-vectors-from-runtime-memory.md
    - 0018 PostgreSQL Memory authority and Qdrant retrieval: adr/0018-use-postgres-for-memory-and-qdrant-for-retrieval.md
    - 0019 Evidence editing and manual consolidation: adr/0019-author-evidence-in-app-with-automatic-activation.md
    - 0021 Shell modes and replaceable portal adapter: adr/0021-separate-shell-modes-and-replaceable-portal-adapter.md
    - 0022 UI locale and session interaction language: adr/0022-separate-ui-locale-from-session-interaction-language.md
  - AI catalog description acceptance: testing/2026-08-29-ai-catalog-description-generation-acceptance.md
  - Sensitivity NER license inventory: reports/2026-09-02-sensitivity-ner-license-inventory.md
  - PSD sensitivity shadow evaluation: reports/2026-09-02-psd-sensitivity-shadow.md
  - PSD progressive sensitivity shadow evaluation: reports/2026-09-03-psd-progressive-sensitivity-shadow.md
  - Design records:
    - Security hardening PRD (draft): plans/2026-09-08-security-hardening-prd.md
    - Security hardening session prompt: plans/2026-09-08-security-hardening-resume-prompt.md
    - Memory and Evidence administration: plans/2026-09-08-memory-evidence-administration.md
    - Memory management project: plans/2026-09-08-memory-management.md
    - Memory M1 specification: plans/2026-09-08-memory-m1-spec.md
    - Memory M2 implementation and validation: plans/2026-09-09-memory-m2-validation.md
    - Evidence management project: plans/2026-09-08-evidence-management.md
    - Evidence E1 validation: plans/2026-09-09-evidence-e1-validation.md
    - Evidence E2 validation: plans/2026-09-09-evidence-e2-validation.md
    - Evidence E3 validation: plans/2026-09-09-evidence-e3-validation.md
    - Archive repair X1 validation: plans/2026-09-09-archive-repair-x1-validation.md
    - Memory and Evidence simplification review: plans/2026-09-08-memory-evidence-simplification-review.md
    - 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
    - Full shell and portal integration: plans/2026-09-13-full-shell-and-portal-integration.md
    - Full shell specification: plans/2026-09-13-full-shell-spec.md