> ## Documentation Index
> Fetch the complete documentation index at: https://doc.askmydocs.padosoft.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ADR index

> The numbered index of Architecture Decision Records — the durable record of every load-bearing decision, from the canonical layer to the Auto-Wiki tier.

## Motivation

Architecture Decision Records are the durable *why* of AskMyDocs: each one
captures a problem, the options weighed, the decision taken, and its
consequences. This page is the terse, numbered index; for the narrative that
groups them into dependency arcs, see
[architecture decisions](/architecture/decisions). The full records live in
`docs/adr/` in the repository.

## The records

Each row links to its full record in the repository.

| #                                                                                                                            | Title                                                                     |
| ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| [0001](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0001-canonical-knowledge-layer.md)                           | Canonical knowledge layer inside `knowledge_documents`                    |
| [0002](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0002-knowledge-graph-model.md)                               | Lightweight knowledge graph via `kb_nodes` / `kb_edges`                   |
| [0003](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0003-promotion-pipeline.md)                                  | Human-gated promotion pipeline (raw → curated → canonical)                |
| [0004](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0004-v42-sister-package-integration.md)                      | v4.2 sister-package integration                                           |
| [0005](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0005-v43-react-19-host-bump.md)                              | v4.3 React 19 host bump                                                   |
| [0006](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0006-v43-nightly-eval-cron.md)                               | v4.3 Nightly eval-harness regression cron                                 |
| [0007](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0007-v44-adversarial-nightly-opt-in.md)                      | v4.4 Adversarial nightly opt-in                                           |
| [0008](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0008-v45-universal-connectors-and-source-aware-ingestion.md) | v4.5 Universal connectors + source-aware ingestion + modern chat surface  |
| [0009](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0009-v46-connector-package-extraction.md)                    | v4.6 Connector package extraction + IoC bridge + composer-extra discovery |
| [0010](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0010-v47-tabular-review-and-workflows.md)                    | v4.7 Tabular Review + Workflows + AI-suggest                              |
| [0011](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0011-v60-ai-act-compliance-integration.md)                   | v6.0 AI Act compliance integration via extracted packages                 |
| [0012](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0012-v80-notification-system.md)                             | v8.0 Notification system (DB-backed, multi-channel)                       |
| [0013](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0013-v88-kb-lifecycle-intelligence-plus.md)                  | v8.8 KB lifecycle intelligence — Plus                                     |
| [0014](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0014-v811-auto-wiki-tier.md)                                 | v8.11 Auto-Wiki `auto` tier                                               |
| [0015](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0015-v816-provider-sdk-migration.md)                         | v8.16 All providers on the `laravel/ai` SDK (FinOps metering)             |
| [0016](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0016-v819-laravel-ai-0.8-platform-migration.md)              | v8.19 `laravel/ai` platform migrated to the 0.8 line                      |
| [0017](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0017-v820-multi-account-connectors.md)                       | v8.20 Multi-account & project-scoped connectors                           |
| [0018](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0018-v821-ingestion-sync-observability.md)                   | v8.21 Ingestion & sync observability + queue baseline                     |
| [0019](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0019-v822-runtime-config-governance.md)                      | v8.22 Runtime configuration governance                                    |
| [0020](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0020-v823-pii-safe-ingestion-reversible-vault.md)            | v8.23 PII-safe ingestion + reversible vault                               |
| [0021](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0021-v824-imap-folder-selection.md)                          | v8.24 IMAP folder selection + email-ingest harness                        |
| [0022](https://github.com/lopadova/AskMyDocs/blob/main/docs/adr/0022-v825-schema-driven-connector-settings.md)               | v8.25 Schema-driven connector sync settings + folder discovery            |

## How ADRs are used here

* A **new architectural decision** ships its own record in `docs/adr/` and a row
  in this index — in the same PR that introduces the change.
* A decision is **never silently reversed**: a later ADR that supersedes an
  earlier one says so explicitly, and the earlier record stays for the trail.
* Load-bearing constraints called out across the docs — no AI SDKs (raw
  `Http::`), the human-gated promotion boundary, canonical-markdown-as-source-of-truth
  — trace back to these records.

<CardGroup cols={2}>
  <Card title="Architecture decisions" icon="scroll" href="/architecture/decisions">
    The narrative grouping these records into arcs.
  </Card>

  <Card title="Architecture overview" icon="sitemap" href="/architecture/overview">
    The system spine that connects the subsystems.
  </Card>
</CardGroup>