Files
authentik/locale/en/dictionaries/ignore.txt
Teffen Ellis 1bd17ab6ba website/docs: Agent Friendly Docs (#23361)
* docs: add llms architecture spec and Layer 1 plan

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* feat(llms-txt): scaffold plugin module, types, and deps

* test(llms-txt): cover empty sections guard; drop no-op assignment

* fix(llms-txt): restore type-narrowing sections assignment

The sections re-assignment in normalizeOptions is load-bearing for the
Required<Pick<...>> return type, not a no-op. Documented its purpose.

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* feat(llms-txt): add markdown file discovery

* fix(llms-txt): move test partial next to its importer

page-two.mdx imports ./_partial.mdx, which must resolve to a sibling in
topic-b/ for Task 5's partial-inlining test to pass.

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* feat(llms-txt): parse docs into title/description/path records

* test(llms-txt): assert parseDocFile non-null to satisfy strict null checks

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* test(llms-txt): cover draft-null and heading-fallback in parseDocFile

* feat(llms-txt): resolve page URLs from Docusaurus routes

* feat(llms-txt): clean MDX into Markdown (partials, directives)

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* fix(llms-txt): make cleanMdxToMarkdown non-throwing on bad frontmatter

Move parseFileContentFrontMatter and inlinePartials inside the try block
so malformed YAML frontmatter is caught and handled by the regex fallback
instead of propagating an unhandled exception. Strip leading frontmatter
in the regex fallback path and add a regression test for the contract.

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* feat(llms-txt): generate grouped llms.txt index

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* test(llms-txt): cover flat index path and buildHeader directly

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* feat(llms-txt): generate llms-full.txt and per-page payloads

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* feat(llms-txt): generate per-group third-level indexes

* test(llms-txt): cover ungrouped-skip and symmetric group isolation

* feat(llms-txt): orchestrate generation in postBuild

* feat(llms-txt): enable on the docs build

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* fix(llms-txt): strip admonition fences from .md payload, code-block-safe

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* fix(llms-txt): track fence char so nested code fences don't break admonition stripping

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* feat(llms-txt): enable on the integrations build with category grouping

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* fix(llms-txt): key per-group index by slug, display category label

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* fix(llms-txt): unescape Markdown-escaped underscores in partial import paths

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* docs: sync llms-txt plan with implemented test fixtures

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* Tidy names.

* docs: redesign Layer 3 around code-mode (search + execute/execute_write)

Replace the tool-per-endpoint MCP design with a code-mode server: search over
the live OpenAPI schema + a sandboxed execute/execute_write writing against an
authenticated ak.request() helper. Document local v1 (binding-is-the-boundary)
and the authentik-native OAuth v2 (RBAC-as-authorization, event-log audit).
Reconcile Layer 2 with the shipped ak-admin/ak-dev plugins and the L2->L1/L2->L3
seams.

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* docs: add Layer 3 v1 code-mode MCP server plan

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* Tidy naming.

* Use constants.

* fix(llms-txt): make docs build idempotent + quiet logging + index homepage

Root cause of the build failures: the docs content root is path:'.', which
includes build/. The plugin writes per-page .md into build/, so a second build
(dirty build/) re-ingested them as source -> 'Cannot find module @site/build/*.md'
(hundreds of fatal errors). Exclude build/ and out/ from the content scan.

Also: collapse the per-page 'no route'/'MDX fallback' warnings (dozens of lines
that read as errors) into one summary line; and resolve the root index page to
'/' (was dropped) with applyMdExtension emitting /index.md for the homepage.

Co-Authored-By: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>

* Format.

* feat(llms-txt): integrations overview + cleaner descriptions (Dominic feedback)

- overviewPages option: inline index + applications content as an '## Overview'
  section in the root llms.txt instead of listing them as links.
- Drop the scaffold template/ from integrations (ignoreFiles).
- Clean descriptions: strip blockquote '>' markers and trailing '-- <source>'
  attribution that many integration pages use for their intro citation.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* spellcheck.

* website: improve llms.txt index quality

Address documentation feedback on the generated llms.txt:

- Normalize section headings: top-level docs topics get display labels
  (docs/topics.mjs), and groupLabel title-cases any unmapped slug
  (e.g. "sys-mgmt" -> "System Management").
- Split the glossary out of "Core Concepts" into its own "Glossary"
  section via a new `regroup` option.
- Skip CVE "Reported by" attributions when extracting descriptions so
  the summary prose is used instead of the reporter's name.
- Clean extracted descriptions: drop bullet-list lead blocks, strip
  inline links/emphasis/code to plain text, and keep the first sentence.
- Resolve generated link URLs from the Netlify deploy context
  (DEPLOY_PRIME_URL) in previews instead of hardcoding the production
  subdomain.

Tests and fixtures cover the new extraction, grouping, labeling, and
deploy-preview URL behavior.

* Format.

---------

Co-authored-by: Playpen Agent <279763771+playpen-agent@users.noreply.github.com>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-24 21:03:57 +00:00

28 lines
243 B
Plaintext

# Ignored terms that should not be suggested by the spell checker.
aaguids
ASGI
asgi
azuread
Azuread
buildx
goauthentik
llmstxt
lxml
pässwörd
phlebotinum
qewr
quox
recategorize
reinject
tmpfs
trixie
XFCC
xghcr
xoxb
xoxe
xoxp
foo
bar
baz
qux