openapi.yaml

openapi: 3.1.0
info:
  title: WikiMind Gateway
  description: Local LLM Knowledge OS — Personal API
  version: 0.1.0
paths:
  /metrics:
    get:
      summary: Metrics
      description: Endpoint that serves Prometheus metrics.
      operationId: metrics_metrics_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /api/ingest/url:
    post:
      tags:
      - Ingest
      summary: Ingest Url
      description: Ingest a web URL or YouTube video.
      operationId: ingest_url_api_ingest_url_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IngestURLRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Source'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ingest/pdf:
    post:
      tags:
      - Ingest
      summary: Ingest Pdf
      description: 'Upload and ingest a PDF.


        The ``auto_compile`` query parameter (default ``True``) controls whether the

        source is enqueued for background compilation immediately after upload.'
      operationId: ingest_pdf_api_ingest_pdf_post
      parameters:
      - name: auto_compile
        in: query
        required: false
        schema:
          type: boolean
          default: true
          title: Auto Compile
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_ingest_pdf_api_ingest_pdf_post'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Source'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ingest/text:
    post:
      tags:
      - Ingest
      summary: Ingest Text
      description: Ingest raw text or a note.
      operationId: ingest_text_api_ingest_text_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IngestTextRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Source'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ingest/sources:
    get:
      tags:
      - Ingest
      summary: List Sources
      description: List all ingested sources.
      operationId: list_sources_api_ingest_sources_get
      parameters:
      - name: status
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Status
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Source'
                title: Response List Sources Api Ingest Sources Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ingest/sources/{source_id}:
    get:
      tags:
      - Ingest
      summary: Get Source
      description: Get source by ID.
      operationId: get_source_api_ingest_sources__source_id__get
      parameters:
      - name: source_id
        in: path
        required: true
        schema:
          type: string
          title: Source Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Source'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - Ingest
      summary: Delete Source
      description: Delete a source by ID.
      operationId: delete_source_api_ingest_sources__source_id__delete
      parameters:
      - name: source_id
        in: path
        required: true
        schema:
          type: string
          title: Source Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteConfirmation'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ingest/sources/{source_id}/detail:
    get:
      tags:
      - Ingest
      summary: Get Source Detail
      description: Get full source detail with pipeline steps, images, and linked
        articles.
      operationId: get_source_detail_api_ingest_sources__source_id__detail_get
      parameters:
      - name: source_id
        in: path
        required: true
        schema:
          type: string
          title: Source Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SourceDetailResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ingest/sources/{source_id}/content:
    get:
      tags:
      - Ingest
      summary: Get Source Content
      description: Return the raw text content of a source for side-by-side reading.
      operationId: get_source_content_api_ingest_sources__source_id__content_get
      parameters:
      - name: source_id
        in: path
        required: true
        schema:
          type: string
          title: Source Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SourceContentResponse'
        '404':
          description: Source not found or has no content
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ingest/sources/{source_id}/spans:
    get:
      tags:
      - Ingest
      summary: List Source Spans
      description: 'Return all source spans for a source document.


        Each span anchors a verbatim text excerpt to a precise location in the

        original source (PDF page, byte range, HTML paragraph).'
      operationId: list_source_spans_api_ingest_sources__source_id__spans_get
      parameters:
      - name: source_id
        in: path
        required: true
        schema:
          type: string
          title: Source Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SourceSpanResponse'
                title: Response List Source Spans Api Ingest Sources  Source Id  Spans
                  Get
        '404':
          description: Source not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ingest/sources/{source_id}/original:
    get:
      tags:
      - Ingest
      summary: Get Source Original
      description: 'Stream the original source document (PDF, HTML, etc.).


        Returns the raw binary stored during ingest — not the extracted text.

        Sources that have no original (text, YouTube) return 404.'
      operationId: get_source_original_api_ingest_sources__source_id__original_get
      parameters:
      - name: source_id
        in: path
        required: true
        schema:
          type: string
          title: Source Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ingest/sources/{source_id}/images:
    get:
      tags:
      - Ingest
      summary: List Source Images
      description: 'List extracted images for a PDF source.


        Reads from the ``source_image`` table first (DB-backed storage),

        falling back to the filesystem for pre-migration sources.'
      operationId: list_source_images_api_ingest_sources__source_id__images_get
      parameters:
      - name: source_id
        in: path
        required: true
        schema:
          type: string
          title: Source Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  additionalProperties:
                    type: string
                title: Response List Source Images Api Ingest Sources  Source Id  Images
                  Get
        '404':
          description: Source not found or no images available
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ingest/sources/{source_id}/images/{filename}:
    get:
      tags:
      - Ingest
      summary: Get Source Image
      description: 'Serve an extracted image file for a PDF source.


        Reads from the ``source_image`` table first (DB-backed storage),

        falling back to the filesystem for pre-migration sources.'
      operationId: get_source_image_api_ingest_sources__source_id__images__filename__get
      parameters:
      - name: source_id
        in: path
        required: true
        schema:
          type: string
          title: Source Id
      - name: filename
        in: path
        required: true
        schema:
          type: string
          title: Filename
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '404':
          description: Image not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/capture/ambient/configure:
    post:
      tags:
      - Capture
      summary: Configure Ambient Adapter
      description: Enable or disable an ambient capture adapter.
      operationId: configure_ambient_adapter_api_capture_ambient_configure_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AmbientAdapterConfigureRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AmbientAdapterStatusResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/capture/ambient/adapters:
    get:
      tags:
      - Capture
      summary: List Ambient Adapters
      description: List all configured ambient adapters.
      operationId: list_ambient_adapters_api_capture_ambient_adapters_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AmbientAdapterListResponse'
  /api/capture/ambient/adapters/{adapter_type}/poll:
    post:
      tags:
      - Capture
      summary: Poll Ambient Adapter
      description: Manually trigger a poll for a specific ambient adapter.
      operationId: poll_ambient_adapter_api_capture_ambient_adapters__adapter_type__poll_post
      parameters:
      - name: adapter_type
        in: path
        required: true
        schema:
          type: string
          title: Adapter Type
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AmbientPollResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/capture:
    get:
      tags:
      - Capture
      summary: List Captures
      description: List captures (the capture inbox).
      operationId: list_captures_api_capture_get
      parameters:
      - name: status
        in: query
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/CaptureStatus'
          - type: 'null'
          title: Status
      - name: kind
        in: query
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/CaptureKind'
          - type: 'null'
          title: Kind
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CaptureListResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/capture/{capture_id}/ingest:
    post:
      tags:
      - Capture
      summary: Ingest Capture
      description: Promote a capture to a full source for compilation.
      operationId: ingest_capture_api_capture__capture_id__ingest_post
      parameters:
      - name: capture_id
        in: path
        required: true
        schema:
          type: string
          title: Capture Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CaptureIngestResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/capture/{capture_id}/discard:
    post:
      tags:
      - Capture
      summary: Discard Capture
      description: Mark a capture as not-worth-keeping.
      operationId: discard_capture_api_capture__capture_id__discard_post
      parameters:
      - name: capture_id
        in: path
        required: true
        schema:
          type: string
          title: Capture Id
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - $ref: '#/components/schemas/DiscardCaptureRequest'
              - type: 'null'
              title: Request
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CaptureDiscardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/capture/{kind}:
    post:
      tags:
      - Capture
      summary: Create Capture
      description: Push a raw capture from an ambient adapter.
      operationId: create_capture_api_capture__kind__post
      parameters:
      - name: kind
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/CaptureKind'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CaptureRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CaptureResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/capture/rss/feeds:
    get:
      tags:
      - Capture
      summary: List Rss Feeds
      description: List all RSS feed subscriptions.
      operationId: list_rss_feeds_api_capture_rss_feeds_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RssFeedListResponse'
    post:
      tags:
      - Capture
      summary: Subscribe Rss Feed
      description: Subscribe to an RSS/Atom feed.
      operationId: subscribe_rss_feed_api_capture_rss_feeds_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RssFeedRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RssFeedResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/capture/rss/feeds/{feed_id}:
    patch:
      tags:
      - Capture
      summary: Toggle Rss Feed
      description: Enable or disable an RSS feed.
      operationId: toggle_rss_feed_api_capture_rss_feeds__feed_id__patch
      parameters:
      - name: feed_id
        in: path
        required: true
        schema:
          type: string
          title: Feed Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RssFeedToggleRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RssFeedResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - Capture
      summary: Delete Rss Feed
      description: Delete an RSS feed subscription.
      operationId: delete_rss_feed_api_capture_rss_feeds__feed_id__delete
      parameters:
      - name: feed_id
        in: path
        required: true
        schema:
          type: string
          title: Feed Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteConfirmation'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/capture/rss/feeds/{feed_id}/poll:
    post:
      tags:
      - Capture
      summary: Poll Rss Feed
      description: Manually trigger a poll for a single RSS feed.
      operationId: poll_rss_feed_api_capture_rss_feeds__feed_id__poll_post
      parameters:
      - name: feed_id
        in: path
        required: true
        schema:
          type: string
          title: Feed Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RssPollResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ingest/sources/{source_id}/draft:
    get:
      tags:
      - Ingest
      summary: Get Draft
      description: Get the pending compilation draft for a source.
      operationId: get_draft_api_ingest_sources__source_id__draft_get
      parameters:
      - name: source_id
        in: path
        required: true
        schema:
          type: string
          title: Source Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompilationDraftResponse'
        '404':
          description: No pending draft for this source
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ingest/sources/{source_id}/draft/approve:
    post:
      tags:
      - Ingest
      summary: Approve Draft
      description: 'Approve a compilation draft, optionally with focus guidance.


        When ``guidance`` is provided, the source is re-compiled with the

        user''s direction. Otherwise the original draft is saved as-is.'
      operationId: approve_draft_api_ingest_sources__source_id__draft_approve_post
      parameters:
      - name: source_id
        in: path
        required: true
        schema:
          type: string
          title: Source Id
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - $ref: '#/components/schemas/ApproveDraftRequest'
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApproveDraftResponse'
        '404':
          description: No pending draft for this source
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/ingest/sources/{source_id}/draft/reject:
    post:
      tags:
      - Ingest
      summary: Reject Draft
      description: Reject a compilation draft and reset the source to pending.
      operationId: reject_draft_api_ingest_sources__source_id__draft_reject_post
      parameters:
      - name: source_id
        in: path
        required: true
        schema:
          type: string
          title: Source Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RejectDraftResponse'
        '404':
          description: No pending draft for this source
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/contradiction-resolutions:
    get:
      tags:
      - Wiki
      summary: List Contradiction Resolutions
      description: Return the valid contradiction resolution options.
      operationId: list_contradiction_resolutions_api_wiki_contradiction_resolutions_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ContradictionResolutionOption'
                type: array
                title: Response List Contradiction Resolutions Api Wiki Contradiction
                  Resolutions Get
  /api/wiki/contradictions:
    get:
      tags:
      - Wiki
      summary: List Contradictions
      description: List all contradictions for the user, optionally filtered by status.
      operationId: list_contradictions_api_wiki_contradictions_get
      parameters:
      - name: status
        in: query
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/ContradictionStatus'
          - type: 'null'
          title: Status
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ContradictionResponse'
                title: Response List Contradictions Api Wiki Contradictions Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/contradictions/{contradiction_id}:
    get:
      tags:
      - Wiki
      summary: Get Contradiction
      description: Get a single contradiction with article details.
      operationId: get_contradiction_api_wiki_contradictions__contradiction_id__get
      parameters:
      - name: contradiction_id
        in: path
        required: true
        schema:
          type: string
          title: Contradiction Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContradictionResponse'
        '404':
          description: Contradiction not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    patch:
      tags:
      - Wiki
      summary: Resolve Persisted Contradiction
      description: Resolve or dismiss a contradiction.
      operationId: resolve_persisted_contradiction_api_wiki_contradictions__contradiction_id__patch
      parameters:
      - name: contradiction_id
        in: path
        required: true
        schema:
          type: string
          title: Contradiction Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResolveContradictionBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContradictionResponse'
        '404':
          description: Contradiction not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/articles:
    get:
      tags:
      - Wiki
      summary: List Articles
      description: List wiki articles with optional filtering and source provenance.
      operationId: list_articles_api_wiki_articles_get
      parameters:
      - name: concept
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Concept
      - name: confidence
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Confidence
      - name: page_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Page Type
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ArticleSummaryResponse'
                title: Response List Articles Api Wiki Articles Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/articles/stub:
    post:
      tags:
      - Wiki
      summary: Create Stub Article
      description: Create a stub wiki article — a placeholder page for a concept not
        yet compiled.
      operationId: create_stub_article_api_wiki_articles_stub_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateStubRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateStubResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/wikilinks/resolve:
    get:
      tags:
      - Wiki
      summary: Resolve Wikilinks
      description: Search articles by partial title for wikilink autocomplete.
      operationId: resolve_wikilinks_api_wiki_wikilinks_resolve_get
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
          minLength: 1
          title: Q
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 50
          minimum: 1
          default: 10
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/WikilinkMatch'
                title: Response Resolve Wikilinks Api Wiki Wikilinks Resolve Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/articles/random:
    get:
      tags:
      - Wiki
      summary: Get Random Article
      description: Return a random article belonging to the current user.
      operationId: get_random_article_api_wiki_articles_random_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArticleSummaryResponse'
        '404':
          description: No articles found
  /api/wiki/articles/{id_or_slug}:
    get:
      tags:
      - Wiki
      summary: Get Article
      description: Get full article by ID or slug, with content, backlinks, and source
        provenance.
      operationId: get_article_api_wiki_articles__id_or_slug__get
      parameters:
      - name: id_or_slug
        in: path
        required: true
        schema:
          type: string
          title: Id Or Slug
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArticleResponse'
        '404':
          description: Article not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    patch:
      tags:
      - Wiki
      summary: Edit Article
      description: 'Manually edit an article''s content and/or title.


        Sets ``manually_edited=True`` so that recompilation respects user edits.

        Only the article owner can edit.'
      operationId: edit_article_api_wiki_articles__id_or_slug__patch
      parameters:
      - name: id_or_slug
        in: path
        required: true
        schema:
          type: string
          title: Id Or Slug
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ArticleEditRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArticleResponse'
        '404':
          description: Article not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/graph:
    get:
      tags:
      - Wiki
      summary: Get Graph
      description: 'Full knowledge graph -- nodes and edges.


        Optional query parameters filter the returned edge set:


        * ``relation_type`` — keep only edges of one semantic relation type.

        * ``from_article`` — id or slug of the source article.

        * ``to_article`` — id or slug of the target article.


        Filters compose with AND. Filtering is pushed down into SQL.'
      operationId: get_graph_api_wiki_graph_get
      parameters:
      - name: relation_type
        in: query
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/RelationType'
          - type: 'null'
          title: Relation Type
      - name: from_article
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: From Article
      - name: to_article
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: To Article
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GraphResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/articles/{id_or_slug}/relationships:
    get:
      tags:
      - Wiki
      summary: Get Article Relationships
      description: Return typed relationships for an article, grouped by direction
        and type.
      operationId: get_article_relationships_api_wiki_articles__id_or_slug__relationships_get
      parameters:
      - name: id_or_slug
        in: path
        required: true
        schema:
          type: string
          title: Id Or Slug
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArticleRelationshipsResponse'
        '404':
          description: Article not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/search:
    get:
      tags:
      - Wiki
      summary: Search
      description: 'Full-text search across wiki articles with optional facet filters.


        Supports filtering by source_kind, page_type, concept, tag,

        date_range (7d, 30d, 365d), and staleness (low, medium, high).

        Sort by ``relevance`` (default) or ``recency``.'
      operationId: search_api_wiki_search_get
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
          minLength: 2
          title: Q
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          default: 20
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      - name: source_kind
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Kind
      - name: page_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Page Type
      - name: concept
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Concept
      - name: tag
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Tag
      - name: date_range
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Date Range
      - name: staleness
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Staleness
      - name: sort
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Sort
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/search/facets:
    get:
      tags:
      - Wiki
      summary: Search Facets
      description: 'Compute facet counts for the current search query.


        Returns counts grouped by: page_type, source_kind, concept,

        tag, date, and staleness.'
      operationId: search_facets_api_wiki_search_facets_get
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
          minLength: 2
          title: Q
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FacetResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/concepts:
    get:
      tags:
      - Wiki
      summary: Get Concepts
      description: Concept taxonomy tree.
      operationId: get_concepts_api_wiki_concepts_get
      parameters:
      - name: include_empty
        in: query
        required: false
        schema:
          type: boolean
          default: true
          title: Include Empty
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Concept'
                title: Response Get Concepts Api Wiki Concepts Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/concepts/rebuild:
    post:
      tags:
      - Wiki
      summary: Rebuild Concepts
      description: Trigger LLM-powered taxonomy hierarchy rebuild.
      operationId: rebuild_concepts_api_wiki_concepts_rebuild_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RebuildConceptsResponse'
  /api/wiki/concepts/{name}:
    get:
      tags:
      - Wiki
      summary: Get Concept
      description: Concept detail with linked articles.
      operationId: get_concept_api_wiki_concepts__name__get
      parameters:
      - name: name
        in: path
        required: true
        schema:
          type: string
          title: Name
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConceptDetailResponse'
        '404':
          description: Concept not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/concepts/{name}/articles:
    get:
      tags:
      - Wiki
      summary: Get Concept Articles
      description: Articles tagged with this concept.
      operationId: get_concept_articles_api_wiki_concepts__name__articles_get
      parameters:
      - name: name
        in: path
        required: true
        schema:
          type: string
          title: Name
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ArticleSummaryResponse'
                title: Response Get Concept Articles Api Wiki Concepts  Name  Articles
                  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/health:
    get:
      tags:
      - Wiki
      summary: Get Health
      description: 'Latest wiki health report from linter.


        DEPRECATED: Use GET /lint/reports/latest instead. This endpoint

        delegates to the new LinterService for backward compatibility.'
      operationId: get_health_api_wiki_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthSummaryResponse'
  /api/wiki/backlinks/{source_id}/{target_id}/resolve:
    post:
      tags:
      - Wiki
      summary: Resolve Contradiction
      description: 'Resolve a contradiction between two articles.


        DEPRECATED: Use ``PATCH /wiki/contradictions/{id}`` instead. This endpoint

        updates the Backlink for backward compatibility AND forwards the resolution

        to the Contradiction table (single source of truth).'
      operationId: resolve_contradiction_api_wiki_backlinks__source_id___target_id__resolve_post
      deprecated: true
      parameters:
      - name: source_id
        in: path
        required: true
        schema:
          type: string
          title: Source Id
      - name: target_id
        in: path
        required: true
        schema:
          type: string
          title: Target Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResolveContradictionRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResolveContradictionResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/articles/{id_or_slug}/refresh:
    post:
      tags:
      - Wiki
      summary: Refresh Article
      description: 'Mark an article as ''still current'' without recompiling.


        Creates a manual_refresh reinforcement event and resets the article''s

        staleness score. Use this when you have reviewed an article and

        confirmed its content is still accurate.'
      operationId: refresh_article_api_wiki_articles__id_or_slug__refresh_post
      parameters:
      - name: id_or_slug
        in: path
        required: true
        schema:
          type: string
          title: Id Or Slug
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefreshArticleResponse'
        '404':
          description: Article not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/articles/{article_id}/recompile:
    post:
      tags:
      - Wiki
      summary: Recompile Article
      description: 'Schedule an async recompilation job for an article.


        If the article has been manually edited (``manually_edited=True``),

        returns 409 Conflict unless ``force=true`` is passed. When forced,

        the manual edits flag is cleared before recompilation.'
      operationId: recompile_article_api_wiki_articles__article_id__recompile_post
      parameters:
      - name: article_id
        in: path
        required: true
        schema:
          type: string
          title: Article Id
      - name: mode
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mode
      - name: force
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Force
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecompileResponse'
        '409':
          description: Article has manual edits
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/articles/{id_or_slug}/citations:
    get:
      tags:
      - Wiki
      summary: Get Article Citations
      description: 'Return claims for an article with their linked source spans.


        Each claim includes the verbatim source spans that anchor it to

        specific paragraphs in the original source documents.'
      operationId: get_article_citations_api_wiki_articles__id_or_slug__citations_get
      parameters:
      - name: id_or_slug
        in: path
        required: true
        schema:
          type: string
          title: Id Or Slug
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArticleCitationsResponse'
        '404':
          description: Article not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/articles/{id_or_slug}/claims:
    get:
      tags:
      - Wiki
      summary: Get Article Claims
      description: 'Return persisted claims for an article with per-claim confidence
        scores.


        Each claim includes a numeric ``confidence_score`` computed from its

        categorical confidence label and the number of backing sources.

        The ``article_confidence_score`` is the aggregate (weighted mean) of

        all claim scores.'
      operationId: get_article_claims_api_wiki_articles__id_or_slug__claims_get
      parameters:
      - name: id_or_slug
        in: path
        required: true
        schema:
          type: string
          title: Id Or Slug
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArticleClaimsResponse'
        '404':
          description: Article not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/articles/{article_id}/tags:
    post:
      tags:
      - Wiki
      summary: Tag Article
      description: Apply a tag to an article.
      operationId: tag_article_api_wiki_articles__article_id__tags_post
      parameters:
      - name: article_id
        in: path
        required: true
        schema:
          type: string
          title: Article Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TagArticleRequest'
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArticleTagResponse'
        '404':
          description: Article or tag not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - Wiki
      summary: Get Article Tags
      description: Get all tags applied to an article.
      operationId: get_article_tags_api_wiki_articles__article_id__tags_get
      parameters:
      - name: article_id
        in: path
        required: true
        schema:
          type: string
          title: Article Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TagResponse'
                title: Response Get Article Tags Api Wiki Articles  Article Id  Tags
                  Get
        '404':
          description: Article not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/articles/{article_id}/tags/{tag_id}:
    delete:
      tags:
      - Wiki
      summary: Untag Article
      description: Remove a tag from an article.
      operationId: untag_article_api_wiki_articles__article_id__tags__tag_id__delete
      parameters:
      - name: article_id
        in: path
        required: true
        schema:
          type: string
          title: Article Id
      - name: tag_id
        in: path
        required: true
        schema:
          type: string
          title: Tag Id
      responses:
        '204':
          description: Successful Response
        '404':
          description: Tag association not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/articles/{article_id}/discuss:
    post:
      tags:
      - Wiki
      summary: Post Discussion Message
      description: Send a message about an article's sources and get an LLM response.
      operationId: post_discussion_message_api_wiki_articles__article_id__discuss_post
      parameters:
      - name: article_id
        in: path
        required: true
        schema:
          type: string
          title: Article Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DiscussionMessageRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DiscussionMessageResponse'
        '404':
          description: Article not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/articles/{article_id}/discussion:
    get:
      tags:
      - Wiki
      summary: Get Discussion Thread
      description: Get the full discussion thread for an article.
      operationId: get_discussion_thread_api_wiki_articles__article_id__discussion_get
      parameters:
      - name: article_id
        in: path
        required: true
        schema:
          type: string
          title: Article Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DiscussionThreadResponse'
        '404':
          description: Article not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/articles/{article_id}/compile-with-guidance:
    post:
      tags:
      - Wiki
      summary: Compile With Guidance
      description: Trigger recompilation incorporating the discussion as guidance.
      operationId: compile_with_guidance_api_wiki_articles__article_id__compile_with_guidance_post
      parameters:
      - name: article_id
        in: path
        required: true
        schema:
          type: string
          title: Article Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompileWithGuidanceResponse'
        '404':
          description: Article not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/query:
    post:
      tags:
      - Query
      summary: Ask
      description: 'Ask a question against the wiki and receive an answer with citations.


        If request.conversation_id is None, a new conversation is created.

        Otherwise the question is appended as a new turn in the existing

        conversation.'
      operationId: ask_api_query_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QueryRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AskResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/query/stream:
    post:
      tags:
      - Query
      summary: Ask Stream
      description: 'Stream an answer token-by-token via Server-Sent Events.


        Returns SSE events: ``chunk`` (text deltas), ``done`` (final AskResponse),

        or ``error``. The Query row is persisted only after the stream completes

        successfully. Client disconnect aborts without persisting.'
      operationId: ask_stream_api_query_stream_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QueryRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/query/history:
    get:
      tags:
      - Query
      summary: Query History
      description: List past queries (legacy endpoint — UI uses /conversations instead).
      operationId: query_history_api_query_history_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          default: 50
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Query'
                title: Response Query History Api Query History Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/query/conversations:
    get:
      tags:
      - Query
      summary: List Conversations
      description: List conversations ordered by most recently updated first.
      operationId: list_conversations_api_query_conversations_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          default: 50
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ConversationSummary'
                title: Response List Conversations Api Query Conversations Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/query/conversations/{conversation_id}:
    get:
      tags:
      - Query
      summary: Get Conversation
      description: Return a single conversation with all its turns.
      operationId: get_conversation_api_query_conversations__conversation_id__get
      parameters:
      - name: conversation_id
        in: path
        required: true
        schema:
          type: string
          title: Conversation Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationDetail'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/query/conversations/{conversation_id}/export:
    get:
      tags:
      - Query
      summary: Export Conversation
      description: Export a conversation as standalone markdown. Pure read, no DB
        writes.
      operationId: export_conversation_api_query_conversations__conversation_id__export_get
      parameters:
      - name: conversation_id
        in: path
        required: true
        schema:
          type: string
          title: Conversation Id
      responses:
        '200':
          description: Successful Response
          content:
            text/markdown:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/query/conversations/file-back:
    post:
      tags:
      - Query
      summary: File Back Selection
      description: File selected turns from one or more conversations back to the
        wiki as a single article.
      operationId: file_back_selection_api_query_conversations_file_back_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FileBackSelectionRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileBackResult'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/query/conversations/{conversation_id}/file-back:
    post:
      tags:
      - Query
      summary: File Back Conversation
      description: File the entire conversation back to the wiki as a single article.
      operationId: file_back_conversation_api_query_conversations__conversation_id__file_back_post
      parameters:
      - name: conversation_id
        in: path
        required: true
        schema:
          type: string
          title: Conversation Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileBackResult'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/query/conversations/{conversation_id}/crystallize:
    post:
      tags:
      - Query
      summary: Crystallize
      description: Distill a conversation into a new wiki article with page_type synthesis.
      operationId: crystallize_api_query_conversations__conversation_id__crystallize_post
      parameters:
      - name: conversation_id
        in: path
        required: true
        schema:
          type: string
          title: Conversation Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CrystallizeResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/query/conversations/{conversation_id}/fork:
    post:
      tags:
      - Query
      summary: Fork Conversation
      description: 'Fork a conversation at a specific turn with a new question.


        Creates a new conversation that shares turns 0..turn_index-1 with the

        parent by reference. The original branch is preserved immutably.'
      operationId: fork_conversation_api_query_conversations__conversation_id__fork_post
      parameters:
      - name: conversation_id
        in: path
        required: true
        schema:
          type: string
          title: Conversation Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ForkRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AskResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/jobs:
    get:
      tags:
      - Jobs
      summary: List Jobs
      description: List jobs with optional status filter.
      operationId: list_jobs_api_jobs_get
      parameters:
      - name: status
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Status
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 20
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Job'
                title: Response List Jobs Api Jobs Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/jobs/{job_id}:
    get:
      tags:
      - Jobs
      summary: Get Job
      description: Get job by ID.
      operationId: get_job_api_jobs__job_id__get
      parameters:
      - name: job_id
        in: path
        required: true
        schema:
          type: string
          title: Job Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                anyOf:
                - $ref: '#/components/schemas/Job'
                - type: 'null'
                title: Response Get Job Api Jobs  Job Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/jobs/compile/{source_id}:
    post:
      tags:
      - Jobs
      summary: Trigger Compile
      description: Trigger compilation for a source.
      operationId: trigger_compile_api_jobs_compile__source_id__post
      parameters:
      - name: source_id
        in: path
        required: true
        schema:
          type: string
          title: Source Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobTriggerResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/jobs/lint:
    post:
      tags:
      - Jobs
      summary: Trigger Lint
      description: 'Trigger wiki linting.


        DEPRECATED: Use POST /lint/run instead. This endpoint delegates

        to the new LinterService for backward compatibility.'
      operationId: trigger_lint_api_jobs_lint_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobTriggerResponse'
  /api/jobs/reindex:
    post:
      tags:
      - Jobs
      summary: Trigger Reindex
      description: Trigger wiki reindexing.
      operationId: trigger_reindex_api_jobs_reindex_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobTriggerResponse'
  /api/lint/run:
    post:
      tags:
      - Lint
      summary: Run Lint
      description: Trigger a new lint run. Returns immediately with status.
      operationId: run_lint_api_lint_run_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LintRunResponse'
  /api/lint/reports:
    get:
      tags:
      - Lint
      summary: List Reports
      description: List lint reports ordered by most recent first.
      operationId: list_reports_api_lint_reports_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          default: 20
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/LintReport'
                title: Response List Reports Api Lint Reports Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/lint/reports/latest:
    get:
      tags:
      - Lint
      summary: Get Latest Report
      description: Get the most recent lint report with all non-dismissed findings.
      operationId: get_latest_report_api_lint_reports_latest_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LintReportDetail'
  /api/lint/reports/{report_id}:
    get:
      tags:
      - Lint
      summary: Get Report
      description: Get a specific lint report with findings.
      operationId: get_report_api_lint_reports__report_id__get
      parameters:
      - name: report_id
        in: path
        required: true
        schema:
          type: string
          title: Report Id
      - name: include_dismissed
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Include Dismissed
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LintReportDetail'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/lint/findings/{kind}/{finding_id}/dismiss:
    post:
      tags:
      - Lint
      summary: Dismiss Finding
      description: Dismiss a finding. Persists across future lint runs via content
        hash.
      operationId: dismiss_finding_api_lint_findings__kind___finding_id__dismiss_post
      parameters:
      - name: kind
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/LintFindingKind'
      - name: finding_id
        in: path
        required: true
        schema:
          type: string
          title: Finding Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DismissFindingResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/settings:
    get:
      tags:
      - Settings
      summary: Get All Settings
      description: Return all application settings, with DB overrides applied.
      operationId: get_all_settings_api_settings_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AllSettingsResponse'
    patch:
      tags:
      - Settings
      summary: Update Settings
      description: Update runtime settings. Changes persist to DB across restarts.
      operationId: update_settings_api_settings_patch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SettingsUpdateRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SettingsUpdateResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/settings/llm/default-provider:
    post:
      tags:
      - Settings
      summary: Set Default Provider
      description: Set the default LLM provider. Persists to DB, survives restarts.
      operationId: set_default_provider_api_settings_llm_default_provider_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DefaultProviderRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultProviderResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/settings/llm/test:
    post:
      tags:
      - Settings
      summary: Test Llm Connection
      description: Test if a provider is configured and reachable.
      operationId: test_llm_connection_api_settings_llm_test_post
      parameters:
      - name: provider
        in: query
        required: true
        schema:
          type: string
          title: Provider
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LLMTestResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/settings/llm/cost/breakdown:
    get:
      tags:
      - Settings
      summary: Get Llm Cost Breakdown
      description: Cost breakdown by provider and task type for current month.
      operationId: get_llm_cost_breakdown_api_settings_llm_cost_breakdown_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CostBreakdownResponse'
  /api/settings/llm/cost:
    get:
      tags:
      - Settings
      summary: Get Llm Cost
      description: Cost summary for current month.
      operationId: get_llm_cost_api_settings_llm_cost_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CostSummaryResponse'
  /api/settings/onboarding-status:
    get:
      tags:
      - Settings
      summary: Get Onboarding Status
      description: 'Return onboarding wizard progress for the current user.


        If the user has never explicitly completed onboarding but already has

        articles in the wiki, treat onboarding as implicitly complete — they

        are clearly past the first-run stage.'
      operationId: get_onboarding_status_api_settings_onboarding_status_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OnboardingStatusResponse'
    post:
      tags:
      - Settings
      summary: Complete Onboarding
      description: Mark onboarding as complete for the current user.
      operationId: complete_onboarding_api_settings_onboarding_status_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OnboardingStatusResponse'
  /api/settings/api-keys/{provider}:
    put:
      tags:
      - Settings
      summary: Set Api Key
      description: Store or update an API key for a provider.
      operationId: set_api_key_api_settings_api_keys__provider__put
      parameters:
      - name: provider
        in: path
        required: true
        schema:
          type: string
          title: Provider
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetApiKeyRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiKeySetResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - Settings
      summary: Delete Api Key
      description: Delete a stored API key for a provider.
      operationId: delete_api_key_api_settings_api_keys__provider__delete
      parameters:
      - name: provider
        in: path
        required: true
        schema:
          type: string
          title: Provider
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiKeyDeleteResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/settings/api-keys:
    get:
      tags:
      - Settings
      summary: List Api Keys
      description: List configured providers with masked key hints.
      operationId: list_api_keys_api_settings_api_keys_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiKeyListResponse'
  /api/settings/mcp-tokens:
    get:
      tags:
      - Settings
      summary: List Mcp Tokens
      description: List all MCP tokens for the current user (never returns plaintext).
      operationId: list_mcp_tokens_api_settings_mcp_tokens_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/MCPTokenResponse'
                type: array
                title: Response List Mcp Tokens Api Settings Mcp Tokens Get
    post:
      tags:
      - Settings
      summary: Create Mcp Token
      description: 'Generate a new MCP personal access token.


        The plaintext token is returned ONCE in the response. It is never

        stored — only the SHA-256 hash is persisted.'
      operationId: create_mcp_token_api_settings_mcp_tokens_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MCPTokenCreateRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MCPTokenCreateResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/settings/mcp-tokens/{token_id}:
    delete:
      tags:
      - Settings
      summary: Revoke Mcp Token
      description: Revoke an MCP token (soft delete — sets revoked=True).
      operationId: revoke_mcp_token_api_settings_mcp_tokens__token_id__delete
      parameters:
      - name: token_id
        in: path
        required: true
        schema:
          type: string
          title: Token Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MCPTokenRevokeResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/admin/stats:
    get:
      tags:
      - Admin
      summary: Get Stats
      description: Aggregate system-wide statistics (admin only).
      operationId: get_stats_api_admin_stats_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SystemStats'
  /api/admin/orphans:
    get:
      tags:
      - Admin
      summary: Get Orphans
      description: Articles with missing wiki files.
      operationId: get_orphans_api_admin_orphans_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/OrphanArticle'
                type: array
                title: Response Get Orphans Api Admin Orphans Get
  /api/admin/concepts/eligible:
    get:
      tags:
      - Admin
      summary: Get Eligible Concepts
      description: Concepts eligible for page generation.
      operationId: get_eligible_concepts_api_admin_concepts_eligible_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/EligibleConcept'
                type: array
                title: Response Get Eligible Concepts Api Admin Concepts Eligible
                  Get
  /api/admin/stuck-sources:
    get:
      tags:
      - Admin
      summary: Get Stuck Sources
      description: Sources stuck in processing for >10 minutes.
      operationId: get_stuck_sources_api_admin_stuck_sources_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/StuckSource'
                type: array
                title: Response Get Stuck Sources Api Admin Stuck Sources Get
  /api/admin/retry-stuck/{source_id}:
    post:
      tags:
      - Admin
      summary: Retry Stuck Source
      description: Reset a stuck source to pending and re-queue compilation.
      operationId: retry_stuck_source_api_admin_retry_stuck__source_id__post
      parameters:
      - name: source_id
        in: path
        required: true
        schema:
          type: string
          title: Source Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdminActionResult'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/admin/sweep:
    post:
      tags:
      - Admin
      summary: Trigger Sweep
      description: Trigger wikilink sweep manually.
      operationId: trigger_sweep_api_admin_sweep_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdminActionResult'
  /api/admin/reindex:
    post:
      tags:
      - Admin
      summary: Trigger Reindex
      description: Rebuild search index.
      operationId: trigger_reindex_api_admin_reindex_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdminActionResult'
  /api/admin/docling-status:
    get:
      tags:
      - Admin
      summary: Get Docling Status
      description: Check connectivity to the Docling-serve PDF extraction sidecar.
      operationId: get_docling_status_api_admin_docling_status_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DoclingStatusResponse'
  /api/admin/users:
    get:
      tags:
      - Admin
      summary: List Users
      description: List all users with summary metrics (admin only).
      operationId: list_users_api_admin_users_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/AdminUserSummary'
                type: array
                title: Response List Users Api Admin Users Get
  /api/admin/users/{user_id}:
    get:
      tags:
      - Admin
      summary: Get User Detail
      description: Full stats breakdown for a single user (admin only).
      operationId: get_user_detail_api_admin_users__user_id__get
      parameters:
      - name: user_id
        in: path
        required: true
        schema:
          type: string
          title: User Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdminUserDetail'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/admin/traces:
    get:
      tags:
      - Admin
      summary: Get Traces
      description: Paginated LLM traces (most recent first, admin only).
      operationId: get_traces_api_admin_traces_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LLMTraceListResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/admin/billing/subscriptions:
    get:
      tags:
      - Admin
      summary: Admin List Subscriptions
      description: List all subscriptions with user info (admin only).
      operationId: admin_list_subscriptions_api_admin_billing_subscriptions_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  additionalProperties: true
                  type: object
                type: array
                title: Response Admin List Subscriptions Api Admin Billing Subscriptions
                  Get
  /api/admin/billing/subscriptions/{user_id}:
    get:
      tags:
      - Admin
      summary: Admin Get User Subscription
      description: Get subscription details for a specific user (admin only).
      operationId: admin_get_user_subscription_api_admin_billing_subscriptions__user_id__get
      parameters:
      - name: user_id
        in: path
        required: true
        schema:
          type: string
          title: User Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  additionalProperties: true
                title: Response Admin Get User Subscription Api Admin Billing Subscriptions  User
                  Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/admin/billing/subscriptions/{user_id}/override:
    post:
      tags:
      - Admin
      summary: Admin Override Plan
      description: Override a user's plan (admin only). Used for manual fixes.
      operationId: admin_override_plan_api_admin_billing_subscriptions__user_id__override_post
      parameters:
      - name: user_id
        in: path
        required: true
        schema:
          type: string
          title: User Id
      - name: plan_name
        in: query
        required: true
        schema:
          type: string
          title: Plan Name
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: string
                title: Response Admin Override Plan Api Admin Billing Subscriptions  User
                  Id  Override Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/admin/billing/subscriptions/{user_id}/sync:
    post:
      tags:
      - Admin
      summary: Admin Sync Subscription
      description: Force-sync a user's subscription with Lemon Squeezy (admin only).
      operationId: admin_sync_subscription_api_admin_billing_subscriptions__user_id__sync_post
      parameters:
      - name: user_id
        in: path
        required: true
        schema:
          type: string
          title: User Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: string
                title: Response Admin Sync Subscription Api Admin Billing Subscriptions  User
                  Id  Sync Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/admin/billing/webhook-events:
    get:
      tags:
      - Admin
      summary: Admin List Webhook Events
      description: List recent webhook events (admin only).
      operationId: admin_list_webhook_events_api_admin_billing_webhook_events_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          default: 50
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  additionalProperties: true
                title: Response Admin List Webhook Events Api Admin Billing Webhook
                  Events Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/admin/billing/plans:
    get:
      tags:
      - Admin
      summary: Admin List Plans
      description: List all billing plans with their LLM model/provider (admin only).
      operationId: admin_list_plans_api_admin_billing_plans_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/AdminPlanResponse'
                type: array
                title: Response Admin List Plans Api Admin Billing Plans Get
  /api/admin/billing/plans/{plan_id}:
    patch:
      tags:
      - Admin
      summary: Admin Update Plan Model
      description: 'Update LLM model and/or provider on a billing plan (admin only).


        Used when an LLM provider deprecates a model and all affected plans

        need to be migrated to a replacement.'
      operationId: admin_update_plan_model_api_admin_billing_plans__plan_id__patch
      parameters:
      - name: plan_id
        in: path
        required: true
        schema:
          type: string
          title: Plan Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdminPlanUpdateRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdminPlanResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/articles/{id_or_slug}/export:
    post:
      tags:
      - Export
      summary: Export Article
      description: 'Export a wiki article in the requested format.


        - **pdf**: Returns styled HTML (text/html) suitable for browser print-to-PDF.

        - **linkedin**: Returns a LinkedIn post draft (JSON with content field).

        - **slides**: Returns a Marp-compatible markdown slide deck (JSON with content
        field).'
      operationId: export_article_api_wiki_articles__id_or_slug__export_post
      parameters:
      - name: id_or_slug
        in: path
        required: true
        schema:
          type: string
          title: Id Or Slug
      - name: format
        in: query
        required: true
        schema:
          $ref: '#/components/schemas/ExportFormat'
          description: 'Export format: pdf, linkedin, or slides'
        description: 'Export format: pdf, linkedin, or slides'
      responses:
        '200':
          description: Export result (JSON for linkedin/slides, HTML for pdf)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExportResponse'
            text/html: {}
        '404':
          description: Article not found
        '422':
          description: Invalid export format
    get:
      tags:
      - Export
      summary: Download Article
      description: "Download a single article as a markdown file or structured JSON.\n\
        \n- **markdown**: Returns the article content as a downloadable ``.md`` file\n\
        \  with a ``Content-Disposition: attachment`` header.\n- **json**: Returns\
        \ structured JSON with article metadata, content,\n  sources, and concepts."
      operationId: download_article_api_wiki_articles__id_or_slug__export_get
      parameters:
      - name: id_or_slug
        in: path
        required: true
        schema:
          type: string
          title: Id Or Slug
      - name: format
        in: query
        required: true
        schema:
          $ref: '#/components/schemas/ArticleDownloadFormat'
          description: 'Download format: markdown or json'
        description: 'Download format: markdown or json'
      responses:
        '200':
          description: Downloadable article file (markdown or JSON)
          content:
            application/json:
              schema: {}
            text/markdown: {}
        '404':
          description: Article not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/export/wiki:
    post:
      tags:
      - Export
      summary: Export Wiki
      description: 'Export the full wiki as a ZIP archive.


        - **obsidian**: Obsidian-flavored markdown with YAML frontmatter and tags.

        - **markdown_json**: Plain markdown files with a metadata.json sidecar.'
      operationId: export_wiki_api_wiki_export_wiki_post
      parameters:
      - name: format
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/WikiExportFormat'
          description: 'Export format: obsidian or markdown_json'
          default: obsidian
        description: 'Export format: obsidian or markdown_json'
      responses:
        '200':
          description: ZIP archive of the full wiki
          content:
            application/json:
              schema: {}
            application/zip: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/tags:
    get:
      tags:
      - Tags
      summary: List Tags
      description: List all tags for the current user.
      operationId: list_tags_api_tags_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/TagResponse'
                type: array
                title: Response List Tags Api Tags Get
    post:
      tags:
      - Tags
      summary: Create Tag
      description: Create a new user tag.
      operationId: create_tag_api_tags_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateTagRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TagResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/tags/{tag_id}:
    delete:
      tags:
      - Tags
      summary: Delete Tag
      description: Delete a tag and all its article associations.
      operationId: delete_tag_api_tags__tag_id__delete
      parameters:
      - name: tag_id
        in: path
        required: true
        schema:
          type: string
          title: Tag Id
      responses:
        '204':
          description: Successful Response
        '404':
          description: Tag not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/tags/{tag_id}/articles:
    get:
      tags:
      - Tags
      summary: Get Articles By Tag
      description: Get articles tagged with a specific tag.
      operationId: get_articles_by_tag_api_tags__tag_id__articles_get
      parameters:
      - name: tag_id
        in: path
        required: true
        schema:
          type: string
          title: Tag Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items: {}
                title: Response Get Articles By Tag Api Tags  Tag Id  Articles Get
        '404':
          description: Tag not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/saved-searches:
    get:
      tags:
      - SavedSearches
      summary: List Saved Searches
      description: List all saved searches for the current user.
      operationId: list_saved_searches_api_saved_searches_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/SavedSearchResponse'
                type: array
                title: Response List Saved Searches Api Saved Searches Get
    post:
      tags:
      - SavedSearches
      summary: Create Saved Search
      description: Create a new saved search.
      operationId: create_saved_search_api_saved_searches_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSavedSearchRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SavedSearchResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/saved-searches/{search_id}:
    delete:
      tags:
      - SavedSearches
      summary: Delete Saved Search
      description: Delete a saved search.
      operationId: delete_saved_search_api_saved_searches__search_id__delete
      parameters:
      - name: search_id
        in: path
        required: true
        schema:
          type: string
          title: Search Id
      responses:
        '204':
          description: Successful Response
        '404':
          description: Saved search not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/saved-searches/{search_id}/execute:
    post:
      tags:
      - SavedSearches
      summary: Execute Saved Search
      description: Execute a saved search and return matching articles.
      operationId: execute_saved_search_api_saved_searches__search_id__execute_post
      parameters:
      - name: search_id
        in: path
        required: true
        schema:
          type: string
          title: Search Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SavedSearchExecuteResponse'
        '404':
          description: Saved search not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/share-links:
    post:
      tags:
      - Sharing
      summary: Create Share Link
      description: 'Create a new share link for an article.


        The returned token can be used to construct a public URL for

        read-only access to the article content.'
      operationId: create_share_link_api_wiki_share_links_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateShareLinkRequest'
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ShareLinkResponse'
        '404':
          description: Article not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - Sharing
      summary: List Share Links
      description: List all share links for the current user, optionally filtered
        by article.
      operationId: list_share_links_api_wiki_share_links_get
      parameters:
      - name: article_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Article Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ShareLinkResponse'
                title: Response List Share Links Api Wiki Share Links Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/share-links/{link_id}:
    delete:
      tags:
      - Sharing
      summary: Revoke Share Link
      description: Revoke a share link so it can no longer be accessed.
      operationId: revoke_share_link_api_wiki_share_links__link_id__delete
      parameters:
      - name: link_id
        in: path
        required: true
        schema:
          type: string
          title: Link Id
      responses:
        '204':
          description: Successful Response
        '404':
          description: Share link not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/synthesis/preview:
    post:
      tags:
      - Synthesis
      summary: Preview Synthesis
      description: 'Generate a synthesis draft without saving it.


        Returns draft content, suggested title, and key themes for user review.

        The draft can be refined with feedback or confirmed to save.'
      operationId: preview_synthesis_api_wiki_synthesis_preview_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SynthesisPreviewRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SynthesisPreviewResponse'
        '422':
          description: Not enough articles or synthesis failed
  /api/wiki/synthesis/refine:
    post:
      tags:
      - Synthesis
      summary: Refine Synthesis
      description: 'Refine a synthesis draft with user feedback.


        Takes a previous draft and user guidance, regenerates the synthesis

        incorporating the feedback. Can be called multiple times for iterative

        refinement before confirming.'
      operationId: refine_synthesis_api_wiki_synthesis_refine_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SynthesisRefineRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SynthesisRefineResponse'
        '422':
          description: Refinement failed
  /api/wiki/synthesis/confirm:
    post:
      tags:
      - Synthesis
      summary: Confirm Synthesis
      description: 'Save a confirmed synthesis draft as a real wiki article.


        Takes the final draft content and title from a preview/refine cycle

        and persists it as a synthesis article in the wiki.'
      operationId: confirm_synthesis_api_wiki_synthesis_confirm_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SynthesisConfirmRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SynthesisConfirmResponse'
        '422':
          description: Could not save synthesis
  /api/wiki/synthesize:
    post:
      tags:
      - Synthesis
      summary: Create Synthesis
      description: 'Create a synthesis page that analyzes across multiple source articles.


        Takes a topic or question and produces a cross-cutting analysis identifying

        themes, contradictions, timelines, and knowledge gaps.


        Requires at least 2 relevant articles in the wiki.'
      operationId: create_synthesis_api_wiki_synthesize_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSynthesisRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SynthesisResponse'
        '422':
          description: Not enough relevant articles for synthesis
  /api/wiki/synthesis:
    get:
      tags:
      - Synthesis
      summary: List Synthesis Pages
      description: List all synthesis pages for the current user.
      operationId: list_synthesis_pages_api_wiki_synthesis_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ArticleSummaryResponse'
                title: Response List Synthesis Pages Api Wiki Synthesis Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/wiki/synthesis/suggestions:
    get:
      tags:
      - Synthesis
      summary: Get Synthesis Suggestions
      description: 'Return auto-detected synthesis opportunities.


        Identifies clusters of articles that would benefit from synthesis:

        - Articles sharing 3+ concepts

        - Articles with contradictions between them

        - Articles on the same topic from different sources'
      operationId: get_synthesis_suggestions_api_wiki_synthesis_suggestions_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 50
          minimum: 1
          default: 10
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SynthesisSuggestion'
                title: Response Get Synthesis Suggestions Api Wiki Synthesis Suggestions
                  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/compilation-schemas:
    get:
      tags:
      - CompilationSchemas
      summary: List Schemas
      description: List all compilation schemas for the current user.
      operationId: list_schemas_api_compilation_schemas_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/CompilationSchemaResponse'
                type: array
                title: Response List Schemas Api Compilation Schemas Get
    post:
      tags:
      - CompilationSchemas
      summary: Create Schema
      description: Create a new compilation schema.
      operationId: create_schema_api_compilation_schemas_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCompilationSchemaRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompilationSchemaResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/compilation-schemas/{schema_id}:
    get:
      tags:
      - CompilationSchemas
      summary: Get Schema
      description: Get a compilation schema by ID.
      operationId: get_schema_api_compilation_schemas__schema_id__get
      parameters:
      - name: schema_id
        in: path
        required: true
        schema:
          type: string
          title: Schema Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompilationSchemaResponse'
        '404':
          description: Schema not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    patch:
      tags:
      - CompilationSchemas
      summary: Update Schema
      description: Update a compilation schema.
      operationId: update_schema_api_compilation_schemas__schema_id__patch
      parameters:
      - name: schema_id
        in: path
        required: true
        schema:
          type: string
          title: Schema Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateCompilationSchemaRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompilationSchemaResponse'
        '404':
          description: Schema not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - CompilationSchemas
      summary: Delete Schema
      description: Delete a compilation schema.
      operationId: delete_schema_api_compilation_schemas__schema_id__delete
      parameters:
      - name: schema_id
        in: path
        required: true
        schema:
          type: string
          title: Schema Id
      responses:
        '204':
          description: Successful Response
        '404':
          description: Schema not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/billing/plans:
    get:
      tags:
      - Billing
      summary: List Plans
      description: List all active billing plans (public, no auth required).
      operationId: list_plans_api_billing_plans_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/PlanResponse'
                type: array
                title: Response List Plans Api Billing Plans Get
  /api/billing/usage:
    get:
      tags:
      - Billing
      summary: Get Usage
      description: Get current resource usage vs plan limits.
      operationId: get_usage_api_billing_usage_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsageResponse'
  /api/billing/checkout:
    post:
      tags:
      - Billing
      summary: Create Checkout
      description: Create a Lemon Squeezy checkout session for plan upgrade.
      operationId: create_checkout_api_billing_checkout_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CheckoutRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/billing/portal:
    get:
      tags:
      - Billing
      summary: Get Portal
      description: Get Lemon Squeezy customer portal URL for subscription management.
      operationId: get_portal_api_billing_portal_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PortalResponse'
  /api/billing/webhook:
    post:
      tags:
      - Billing
      summary: Handle Webhook
      description: Process Lemon Squeezy webhook with insert-first idempotency.
      operationId: handle_webhook_api_billing_webhook_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /public/articles/{token}:
    get:
      tags:
      - Sharing
      summary: Get Public Article
      description: 'Render a publicly shared article as a minimal HTML page.


        No authentication required. The article is identified by its

        cryptographically random share token.'
      operationId: get_public_article_public_articles__token__get
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
        '404':
          description: Share link not found or revoked
        '410':
          description: Share link has expired
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /public/articles/{token}/json:
    get:
      tags:
      - Sharing
      summary: Get Public Article Json
      description: Return a publicly shared article as JSON (for API consumers).
      operationId: get_public_article_json_public_articles__token__json_get
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicArticleResponse'
        '404':
          description: Share link not found or revoked
        '410':
          description: Share link has expired
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /health/deep:
    get:
      tags:
      - Admin
      summary: Deep Health Check
      description: Deep health check — verifies database, migrations, LLM provider,
        and stuck sources.
      operationId: deep_health_check_health_deep_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Deep Health Check Health Deep Get
  /health/job-ping:
    get:
      tags:
      - Admin
      summary: Job Ping
      description: 'Enqueue a lightweight ping job and wait for its result.


        Proves the full background job pipeline works end-to-end:

        API -> Redis -> ARQ worker -> result.  Requires authentication

        because it enqueues a real job (side effect).


        Returns ``{"status": "ok", ...}`` when the job completes within the

        timeout, or ``{"status": "error", ...}`` on failure or timeout.

        In dev mode (no Redis), returns ``{"status": "skipped"}`` since

        there is no ARQ worker to verify.'
      operationId: job_ping_health_job_ping_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Job Ping Health Job Ping Get
  /auth/login/{provider}:
    get:
      tags:
      - Auth
      summary: Login
      description: Redirect to OAuth2 provider's authorize URL.
      operationId: login_auth_login__provider__get
      parameters:
      - name: provider
        in: path
        required: true
        schema:
          type: string
          title: Provider
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /auth/callback:
    get:
      tags:
      - Auth
      summary: Auth Callback
      description: Handle OAuth2 callback — exchange code for token, upsert user,
        set cookie.
      operationId: auth_callback_auth_callback_get
      parameters:
      - name: code
        in: query
        required: true
        schema:
          type: string
          title: Code
      - name: state
        in: query
        required: true
        schema:
          type: string
          title: State
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /auth/me:
    get:
      tags:
      - Auth
      summary: Me
      description: Return current user profile, auto-provisioning if needed.
      operationId: me_auth_me_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserProfileResponse'
  /auth/magic-link:
    post:
      tags:
      - Auth
      summary: Request Magic Link
      description: 'Request a magic link for passwordless email login.


        Generates an HMAC-signed token encoding the email and timestamp.

        In non-production mode, the token is returned in the response for

        CLI/testing use. In production, an email would be sent (not yet

        implemented).'
      operationId: request_magic_link_auth_magic_link_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MagicLinkRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MagicLinkResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /auth/magic-link/verify:
    post:
      tags:
      - Auth
      summary: Verify Magic Link
      description: 'Verify a magic link token and create a session JWT.


        Decodes and verifies the HMAC-signed token, looks up or creates

        the user, and returns a JWT access token.'
      operationId: verify_magic_link_auth_magic_link_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MagicLinkVerifyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MagicLinkVerifyResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /auth/tokens:
    get:
      tags:
      - Auth
      summary: Token Page
      description: 'Serve the API token generation page.


        This is a self-contained HTML page that lets authenticated users

        create API tokens for the browser extension or other API clients.

        Authentication is handled client-side via the session cookie.'
      operationId: token_page_auth_tokens_get
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
  /auth/tokens.js:
    get:
      tags:
      - Auth
      summary: Token Page Js
      description: 'Serve the JavaScript for the token generation page.


        Extracted from the HTML page so that Content-Security-Policy can

        use ``script-src ''self''`` without ``''unsafe-inline''``.'
      operationId: token_page_js_auth_tokens_js_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /auth/token:
    post:
      tags:
      - Auth
      summary: Create Api Token
      description: 'Create a long-lived API token for CLI/automation use.


        Requires an existing session (cookie or Bearer token). Users must

        authenticate first via OAuth or magic link, then create API tokens.


        The raw JWT is returned only once in the response. The caller must

        store it securely. The token includes a ``token_use: api`` claim to

        distinguish it from session JWTs.'
      operationId: create_api_token_auth_token_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TokenCreateRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TokenCreateResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /auth/logout:
    post:
      tags:
      - Auth
      summary: Logout
      description: Clear the session cookie.
      operationId: logout_auth_logout_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /auth/account:
    delete:
      tags:
      - Auth
      summary: Delete Account
      description: Delete the current user's account and all owned data.
      operationId: delete_account_auth_account_delete
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteAccountResponse'
  /.well-known/oauth-authorization-server:
    get:
      tags:
      - Auth
      summary: Oauth Metadata
      description: Return OAuth 2.1 Authorization Server Metadata per RFC 8414.
      operationId: oauth_metadata__well_known_oauth_authorization_server_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /mcp/authorize:
    get:
      tags:
      - Auth
      summary: Authorize
      description: 'Handle OAuth 2.1 authorization request.


        Validates the authorization request parameters, stores them, and

        either shows the consent screen (if logged in) or redirects to login.'
      operationId: authorize_mcp_authorize_get
      parameters:
      - name: response_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Response Type
      - name: client_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Client Id
      - name: redirect_uri
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Redirect Uri
      - name: code_challenge
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Code Challenge
      - name: code_challenge_method
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Code Challenge Method
      - name: state
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: State
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /mcp/authorize/resume:
    get:
      tags:
      - Auth
      summary: Authorize Resume
      description: 'Resume authorization flow after login.


        The user was redirected to login, and after successful login they

        are sent back here. We now show the consent screen.'
      operationId: authorize_resume_mcp_authorize_resume_get
      parameters:
      - name: rid
        in: query
        required: true
        schema:
          type: string
          title: Rid
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /mcp/authorize/decide:
    post:
      tags:
      - Auth
      summary: Authorize Decide
      description: 'Handle consent decision (approve or deny).


        On approval, generates an authorization code, stores it, and

        redirects to the client''s redirect_uri with the code and state.'
      operationId: authorize_decide_mcp_authorize_decide_post
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_authorize_decide_mcp_authorize_decide_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /mcp/token:
    post:
      tags:
      - Auth
      summary: Token Exchange
      description: 'Exchange an authorization code for an access token (PKCE).


        Validates the grant type, code, redirect_uri match, PKCE verifier,

        and that the code hasn''t expired or been used. Returns a short-lived

        access token with ``wmk_`` prefix.'
      operationId: token_exchange_mcp_token_post
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_token_exchange_mcp_token_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /mcp/revoke:
    post:
      tags:
      - Auth
      summary: Revoke Token
      description: 'Revoke an access token.


        Per RFC 7009, always returns 200 even if the token is not found.'
      operationId: revoke_token_mcp_revoke_post
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_revoke_token_mcp_revoke_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /health:
    get:
      summary: Health Check
      description: Health check — used by Electron to confirm daemon is ready.
      operationId: health_check_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
components:
  schemas:
    AdminActionResult:
      properties:
        action:
          type: string
          title: Action
        status:
          type: string
          title: Status
        job_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Job Id
      type: object
      required:
      - action
      - status
      title: AdminActionResult
      description: Result of an admin action.
    AdminPlanResponse:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        display_name:
          type: string
          title: Display Name
        llm_provider:
          type: string
          title: Llm Provider
        llm_model:
          type: string
          title: Llm Model
        is_active:
          type: boolean
          title: Is Active
        updated_at:
          type: string
          format: date-time
          title: Updated At
      type: object
      required:
      - id
      - name
      - display_name
      - llm_provider
      - llm_model
      - is_active
      - updated_at
      title: AdminPlanResponse
      description: API response for a billing plan (admin view).
    AdminPlanUpdateRequest:
      properties:
        llm_model:
          anyOf:
          - type: string
          - type: 'null'
          title: Llm Model
        llm_provider:
          anyOf:
          - type: string
          - type: 'null'
          title: Llm Provider
      type: object
      title: AdminPlanUpdateRequest
      description: Request to update LLM model/provider on a billing plan.
    AdminUserDetail:
      properties:
        id:
          type: string
          title: Id
        email:
          type: string
          title: Email
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
        avatar_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Avatar Url
        article_count:
          type: integer
          title: Article Count
          default: 0
        source_count:
          type: integer
          title: Source Count
          default: 0
        total_cost_usd:
          type: number
          title: Total Cost Usd
          default: 0.0
        last_active_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Last Active At
        articles_by_type:
          additionalProperties:
            type: integer
          type: object
          title: Articles By Type
          default: {}
        sources_by_status:
          additionalProperties:
            type: integer
          type: object
          title: Sources By Status
          default: {}
        cost_by_provider:
          additionalProperties:
            type: number
          type: object
          title: Cost By Provider
          default: {}
        recent_sources:
          items:
            $ref: '#/components/schemas/RecentSourceEntry'
          type: array
          title: Recent Sources
          default: []
      type: object
      required:
      - id
      - email
      - name
      - avatar_url
      title: AdminUserDetail
      description: Full per-user detail for the admin user detail endpoint.
    AdminUserSummary:
      properties:
        id:
          type: string
          title: Id
        email:
          type: string
          title: Email
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
        avatar_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Avatar Url
        article_count:
          type: integer
          title: Article Count
          default: 0
        source_count:
          type: integer
          title: Source Count
          default: 0
        total_cost_usd:
          type: number
          title: Total Cost Usd
          default: 0.0
        last_active_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Last Active At
      type: object
      required:
      - id
      - email
      - name
      - avatar_url
      title: AdminUserSummary
      description: Summary metrics for a single user in the admin users list.
    AllSettingsResponse:
      properties:
        data_dir:
          type: string
          title: Data Dir
        gateway_port:
          type: integer
          title: Gateway Port
        llm:
          $ref: '#/components/schemas/LLMSettingsResponse'
        sync:
          $ref: '#/components/schemas/SyncSettingsResponse'
        deployment_mode:
          type: string
          title: Deployment Mode
          default: self_hosted
        user_plan:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: User Plan
      type: object
      required:
      - data_dir
      - gateway_port
      - llm
      - sync
      title: AllSettingsResponse
      description: Full application settings response.
    AmbientAdapterConfigureRequest:
      properties:
        adapter_type:
          type: string
          maxLength: 100
          minLength: 1
          title: Adapter Type
        enabled:
          type: boolean
          title: Enabled
          default: true
        settings:
          additionalProperties:
            type: string
          type: object
          title: Settings
      type: object
      required:
      - adapter_type
      title: AmbientAdapterConfigureRequest
      description: Request to configure an ambient capture adapter.
    AmbientAdapterListResponse:
      properties:
        adapters:
          items:
            $ref: '#/components/schemas/AmbientAdapterStatusResponse'
          type: array
          title: Adapters
      type: object
      required:
      - adapters
      title: AmbientAdapterListResponse
      description: List of configured ambient adapters.
    AmbientAdapterStatusResponse:
      properties:
        adapter_type:
          type: string
          title: Adapter Type
        enabled:
          type: boolean
          title: Enabled
        last_polled_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Last Polled At
        settings:
          additionalProperties:
            type: string
          type: object
          title: Settings
      type: object
      required:
      - adapter_type
      - enabled
      title: AmbientAdapterStatusResponse
      description: API response for an ambient adapter's status.
    AmbientPollResponse:
      properties:
        adapter_type:
          type: string
          title: Adapter Type
        new_captures:
          type: integer
          title: New Captures
        status:
          type: string
          title: Status
          default: polled
      type: object
      required:
      - adapter_type
      - new_captures
      title: AmbientPollResponse
      description: Response after triggering an ambient adapter poll.
    ApiKeyDeleteResponse:
      properties:
        provider:
          type: string
          title: Provider
        status:
          type: string
          title: Status
      type: object
      required:
      - provider
      - status
      title: ApiKeyDeleteResponse
      description: Response after deleting an API key.
    ApiKeyInfo:
      properties:
        provider:
          type: string
          title: Provider
        key_hint:
          type: string
          title: Key Hint
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
      type: object
      required:
      - provider
      - key_hint
      - created_at
      - updated_at
      title: ApiKeyInfo
      description: Summary of a configured API key (no raw key exposed).
    ApiKeyListResponse:
      properties:
        keys:
          items:
            $ref: '#/components/schemas/ApiKeyInfo'
          type: array
          title: Keys
      type: object
      required:
      - keys
      title: ApiKeyListResponse
      description: List of configured API key providers.
    ApiKeySetResponse:
      properties:
        provider:
          type: string
          title: Provider
        key_hint:
          type: string
          title: Key Hint
        status:
          type: string
          title: Status
      type: object
      required:
      - provider
      - key_hint
      - status
      title: ApiKeySetResponse
      description: Response after setting an API key.
    ApproveDraftRequest:
      properties:
        guidance:
          anyOf:
          - type: string
          - type: 'null'
          title: Guidance
      type: object
      title: ApproveDraftRequest
      description: Request to approve a draft, optionally with user guidance.
    ApproveDraftResponse:
      properties:
        status:
          type: string
          title: Status
        article_slug:
          type: string
          title: Article Slug
        article_title:
          type: string
          title: Article Title
      type: object
      required:
      - status
      - article_slug
      - article_title
      title: ApproveDraftResponse
      description: Response after approving a compilation draft.
    ArticleCitationsResponse:
      properties:
        article_id:
          type: string
          title: Article Id
        article_title:
          type: string
          title: Article Title
        claims:
          items:
            $ref: '#/components/schemas/ClaimCitationResponse'
          type: array
          title: Claims
          default: []
      type: object
      required:
      - article_id
      - article_title
      title: ArticleCitationsResponse
      description: All claims for an article with their source spans.
    ArticleClaimsResponse:
      properties:
        article_id:
          type: string
          title: Article Id
        article_title:
          type: string
          title: Article Title
        article_confidence_score:
          type: number
          title: Article Confidence Score
        claims:
          items:
            $ref: '#/components/schemas/ClaimConfidenceResponse'
          type: array
          title: Claims
          default: []
      type: object
      required:
      - article_id
      - article_title
      - article_confidence_score
      title: ArticleClaimsResponse
      description: All persisted claims for an article with their confidence scores.
    ArticleDownloadFormat:
      type: string
      enum:
      - markdown
      - json
      title: ArticleDownloadFormat
      description: Supported single-article download formats (GET endpoint).
    ArticleEditRequest:
      properties:
        content:
          anyOf:
          - type: string
            minLength: 1
          - type: 'null'
          title: Content
        title:
          anyOf:
          - type: string
            minLength: 1
          - type: 'null'
          title: Title
      type: object
      title: ArticleEditRequest
      description: Request to manually edit an article's content or title.
    ArticleRelationshipsResponse:
      properties:
        incoming:
          additionalProperties:
            items:
              $ref: '#/components/schemas/RelationshipEdge'
            type: array
          type: object
          title: Incoming
          default: {}
        outgoing:
          additionalProperties:
            items:
              $ref: '#/components/schemas/RelationshipEdge'
            type: array
          type: object
          title: Outgoing
          default: {}
      type: object
      title: ArticleRelationshipsResponse
      description: 'Typed relationships for one article, grouped by direction and
        relation_type.


        ``incoming`` are edges where this article is the *target*.

        ``outgoing`` are edges where this article is the *source*.

        Each direction maps a :class:`RelationType` value (string) to the list

        of edges of that type.'
    ArticleResponse:
      properties:
        id:
          type: string
          title: Id
        slug:
          type: string
          title: Slug
        title:
          type: string
          title: Title
        summary:
          anyOf:
          - type: string
          - type: 'null'
          title: Summary
        confidence:
          anyOf:
          - $ref: '#/components/schemas/ConfidenceLevel'
          - type: 'null'
        linter_score:
          anyOf:
          - type: number
          - type: 'null'
          title: Linter Score
        confidence_score:
          type: number
          title: Confidence Score
          default: 0.5
        effective_confidence:
          type: number
          title: Effective Confidence
          default: 0.5
        staleness_score:
          anyOf:
          - type: number
          - type: 'null'
          title: Staleness Score
        concepts:
          items:
            type: string
          type: array
          title: Concepts
          default: []
        tags:
          items:
            $ref: '#/components/schemas/TagResponse'
          type: array
          title: Tags
          default: []
        backlinks_in:
          items:
            $ref: '#/components/schemas/BacklinkEntry'
          type: array
          title: Backlinks In
          default: []
        backlinks_out:
          items:
            $ref: '#/components/schemas/BacklinkEntry'
          type: array
          title: Backlinks Out
          default: []
        content:
          type: string
          title: Content
        sources:
          items:
            $ref: '#/components/schemas/SourceResponse'
          type: array
          title: Sources
          default: []
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        page_type:
          $ref: '#/components/schemas/PageType'
          default: source
        manually_edited:
          type: boolean
          title: Manually Edited
          default: false
        edited_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Edited At
        is_stub:
          type: boolean
          title: Is Stub
          default: false
      type: object
      required:
      - id
      - slug
      - title
      - summary
      - confidence
      - linter_score
      - content
      - created_at
      - updated_at
      title: ArticleResponse
      description: Full article response with content, backlinks, and source provenance.
    ArticleSourceSummary:
      properties:
        id:
          type: string
          title: Id
        source_type:
          $ref: '#/components/schemas/SourceType'
        title:
          anyOf:
          - type: string
          - type: 'null'
          title: Title
      type: object
      required:
      - id
      - source_type
      - title
      title: ArticleSourceSummary
      description: 'Minimal source descriptor returned with listing/search endpoints.


        A lightweight summary used when the full :class:`SourceResponse` is

        overkill — e.g. article list and search result payloads.'
    ArticleSummaryResponse:
      properties:
        id:
          type: string
          title: Id
        slug:
          type: string
          title: Slug
        title:
          type: string
          title: Title
        summary:
          anyOf:
          - type: string
          - type: 'null'
          title: Summary
        confidence:
          anyOf:
          - $ref: '#/components/schemas/ConfidenceLevel'
          - type: 'null'
        linter_score:
          anyOf:
          - type: number
          - type: 'null'
          title: Linter Score
        confidence_score:
          type: number
          title: Confidence Score
          default: 0.5
        effective_confidence:
          type: number
          title: Effective Confidence
          default: 0.5
        staleness_score:
          anyOf:
          - type: number
          - type: 'null'
          title: Staleness Score
        sources:
          items:
            $ref: '#/components/schemas/ArticleSourceSummary'
          type: array
          title: Sources
          default: []
        source_count:
          type: integer
          title: Source Count
          default: 0
        backlink_count:
          type: integer
          title: Backlink Count
          default: 0
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        page_type:
          $ref: '#/components/schemas/PageType'
          default: source
        concepts:
          items:
            type: string
          type: array
          title: Concepts
          default: []
        tags:
          items:
            $ref: '#/components/schemas/TagResponse'
          type: array
          title: Tags
          default: []
        source_ids:
          items:
            type: string
          type: array
          title: Source Ids
          default: []
        user_id:
          anyOf:
          - type: string
          - type: 'null'
          title: User Id
        manually_edited:
          type: boolean
          title: Manually Edited
          default: false
        is_stub:
          type: boolean
          title: Is Stub
          default: false
      type: object
      required:
      - id
      - slug
      - title
      - summary
      - confidence
      - linter_score
      - created_at
      - updated_at
      title: ArticleSummaryResponse
      description: 'Summary article response for list and search endpoints.


        Includes a lightweight list of sources so that callers can surface

        provenance directly in search/listing views without fetching the full

        article content.'
    ArticleTagResponse:
      properties:
        article_id:
          type: string
          title: Article Id
        tag_id:
          type: string
          title: Tag Id
      type: object
      required:
      - article_id
      - tag_id
      title: ArticleTagResponse
      description: Confirmation that a tag was applied to an article.
    AskResponse:
      properties:
        query:
          $ref: '#/components/schemas/QueryResponse'
        conversation:
          $ref: '#/components/schemas/ConversationResponse'
      type: object
      required:
      - query
      - conversation
      title: AskResponse
      description: Response shape for POST /query — wraps both the new query and its
        parent conversation.
    BacklinkEntry:
      properties:
        id:
          type: string
          title: Id
        title:
          type: string
          title: Title
        slug:
          type: string
          title: Slug
        relation_type:
          anyOf:
          - $ref: '#/components/schemas/RelationType'
          - type: 'null'
        resolution:
          anyOf:
          - type: string
          - type: 'null'
          title: Resolution
      type: object
      required:
      - id
      - title
      - slug
      title: BacklinkEntry
      description: A backlink entry with human-readable metadata for the frontend.
    Body_authorize_decide_mcp_authorize_decide_post:
      properties:
        request_id:
          type: string
          title: Request Id
        decision:
          type: string
          title: Decision
      type: object
      required:
      - request_id
      - decision
      title: Body_authorize_decide_mcp_authorize_decide_post
    Body_ingest_pdf_api_ingest_pdf_post:
      properties:
        file:
          type: string
          contentMediaType: application/octet-stream
          title: File
      type: object
      required:
      - file
      title: Body_ingest_pdf_api_ingest_pdf_post
    Body_revoke_token_mcp_revoke_post:
      properties:
        token:
          type: string
          title: Token
      type: object
      required:
      - token
      title: Body_revoke_token_mcp_revoke_post
    Body_token_exchange_mcp_token_post:
      properties:
        grant_type:
          type: string
          title: Grant Type
        code:
          type: string
          title: Code
        redirect_uri:
          type: string
          title: Redirect Uri
        code_verifier:
          type: string
          title: Code Verifier
        client_id:
          type: string
          title: Client Id
      type: object
      required:
      - grant_type
      - code
      - redirect_uri
      - code_verifier
      - client_id
      title: Body_token_exchange_mcp_token_post
    CaptureDiscardResponse:
      properties:
        capture_id:
          type: string
          title: Capture Id
        status:
          type: string
          title: Status
          default: discarded
      type: object
      required:
      - capture_id
      title: CaptureDiscardResponse
      description: Response after discarding a capture.
    CaptureIngestResponse:
      properties:
        capture_id:
          type: string
          title: Capture Id
        source_id:
          type: string
          title: Source Id
        status:
          type: string
          title: Status
          default: ingested
      type: object
      required:
      - capture_id
      - source_id
      title: CaptureIngestResponse
      description: Response after promoting a capture to a full source.
    CaptureKind:
      type: string
      enum:
      - share_target
      - rss
      - email
      - clipboard
      - voice
      - screenshot
      - slack
      - discord
      - browser_history
      title: CaptureKind
      description: Kind of ambient capture adapter that produced a CaptureSource.
    CaptureListResponse:
      properties:
        items:
          items:
            $ref: '#/components/schemas/CaptureResponse'
          type: array
          title: Items
        total:
          type: integer
          title: Total
      type: object
      required:
      - items
      - total
      title: CaptureListResponse
      description: Paginated list of captures.
    CaptureRequest:
      properties:
        title:
          anyOf:
          - type: string
          - type: 'null'
          title: Title
        content:
          type: string
          maxLength: 500000
          title: Content
        source_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Url
        external_id:
          anyOf:
          - type: string
          - type: 'null'
          title: External Id
      type: object
      required:
      - content
      title: CaptureRequest
      description: Request to capture content from an ambient adapter.
    CaptureResponse:
      properties:
        id:
          type: string
          title: Id
        kind:
          $ref: '#/components/schemas/CaptureKind'
        title:
          anyOf:
          - type: string
          - type: 'null'
          title: Title
        source_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Url
        status:
          $ref: '#/components/schemas/CaptureStatus'
        external_id:
          anyOf:
          - type: string
          - type: 'null'
          title: External Id
        received_at:
          type: string
          format: date-time
          title: Received At
        triaged_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Triaged At
        ingested_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Ingested At
        discarded_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Discarded At
        discard_reason:
          anyOf:
          - type: string
          - type: 'null'
          title: Discard Reason
        source_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Id
      type: object
      required:
      - id
      - kind
      - title
      - source_url
      - status
      - received_at
      title: CaptureResponse
      description: API response for a captured item.
    CaptureStatus:
      type: string
      enum:
      - captured
      - triaged
      - ingested
      - discarded
      title: CaptureStatus
      description: Lifecycle status of a captured item.
    CheckoutRequest:
      properties:
        plan_id:
          type: string
          title: Plan Id
      type: object
      required:
      - plan_id
      title: CheckoutRequest
      description: Request body for creating a checkout session.
    CheckoutResponse:
      properties:
        checkout_url:
          type: string
          title: Checkout Url
      type: object
      required:
      - checkout_url
      title: CheckoutResponse
      description: Checkout URL response.
    CitationArticleRef:
      properties:
        slug:
          type: string
          title: Slug
        title:
          type: string
          title: Title
      type: object
      required:
      - slug
      - title
      title: CitationArticleRef
      description: Minimal reference to an article used inside a :class:`CitationResponse`.
    CitationResponse:
      properties:
        article:
          $ref: '#/components/schemas/CitationArticleRef'
        sources:
          items:
            $ref: '#/components/schemas/SourceResponse'
          type: array
          title: Sources
          default: []
        confidence_score:
          type: number
          title: Confidence Score
          default: 0.5
        effective_confidence:
          type: number
          title: Effective Confidence
          default: 0.5
      type: object
      required:
      - article
      title: CitationResponse
      description: 'A single Q&A citation: an article plus the sources it was compiled
        from.'
    ClaimCitationResponse:
      properties:
        id:
          type: string
          title: Id
        text:
          type: string
          title: Text
        confidence_level:
          type: string
          title: Confidence Level
        confidence_score:
          anyOf:
          - type: number
          - type: 'null'
          title: Confidence Score
        source_ids:
          items:
            type: string
          type: array
          title: Source Ids
          default: []
        source_spans:
          items:
            $ref: '#/components/schemas/SourceSpanResponse'
          type: array
          title: Source Spans
          default: []
      type: object
      required:
      - id
      - text
      - confidence_level
      title: ClaimCitationResponse
      description: A compiled claim with its linked source spans for citation display.
    ClaimConfidenceResponse:
      properties:
        id:
          type: string
          title: Id
        text:
          type: string
          title: Text
        confidence_level:
          type: string
          title: Confidence Level
        confidence_score:
          anyOf:
          - type: number
          - type: 'null'
          title: Confidence Score
        source_ids:
          items:
            type: string
          type: array
          title: Source Ids
          default: []
        last_reinforced_at:
          type: string
          format: date-time
          title: Last Reinforced At
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
      - id
      - text
      - confidence_level
      - last_reinforced_at
      - created_at
      title: ClaimConfidenceResponse
      description: A compiled claim with its confidence score and source attribution.
    CompilationDraftResponse:
      properties:
        id:
          type: string
          title: Id
        source_id:
          type: string
          title: Source Id
        title:
          type: string
          title: Title
        summary:
          type: string
          title: Summary
        key_takeaways:
          items:
            type: string
          type: array
          title: Key Takeaways
        draft_body:
          type: string
          title: Draft Body
        status:
          type: string
          title: Status
        created_at:
          type: string
          format: date-time
          title: Created At
        reviewed_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Reviewed At
      type: object
      required:
      - id
      - source_id
      - title
      - summary
      - key_takeaways
      - draft_body
      - status
      - created_at
      title: CompilationDraftResponse
      description: API response for a compilation draft awaiting review.
    CompilationSchemaResponse:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        is_active:
          type: boolean
          title: Is Active
        article_max_length:
          anyOf:
          - type: integer
          - type: 'null'
          title: Article Max Length
        required_sections:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Required Sections
        style:
          anyOf:
          - type: string
          - type: 'null'
          title: Style
        focus:
          anyOf:
          - type: string
          - type: 'null'
          title: Focus
        concept_max_depth:
          anyOf:
          - type: integer
          - type: 'null'
          title: Concept Max Depth
        concept_naming:
          anyOf:
          - type: string
          - type: 'null'
          title: Concept Naming
        extraction_always_note:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Extraction Always Note
        extraction_ignore:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Extraction Ignore
        custom_directives:
          anyOf:
          - type: string
          - type: 'null'
          title: Custom Directives
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
      type: object
      required:
      - id
      - name
      - description
      - is_active
      - article_max_length
      - required_sections
      - style
      - focus
      - concept_max_depth
      - concept_naming
      - extraction_always_note
      - extraction_ignore
      - custom_directives
      - created_at
      - updated_at
      title: CompilationSchemaResponse
      description: API response for a compilation schema.
    CompileWithGuidanceResponse:
      properties:
        status:
          type: string
          title: Status
        job_id:
          type: string
          title: Job Id
      type: object
      required:
      - status
      - job_id
      title: CompileWithGuidanceResponse
      description: Response after triggering recompilation with discussion guidance.
    Concept:
      properties:
        id:
          type: string
          title: Id
        user_id:
          type: string
          title: User Id
        name:
          type: string
          title: Name
        parent_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Id
        article_count:
          type: integer
          title: Article Count
          default: 0
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        created_at:
          type: string
          format: date-time
          title: Created At
        concept_kind:
          type: string
          title: Concept Kind
          default: topic
      type: object
      required:
      - user_id
      - name
      title: Concept
      description: Auto-generated concept taxonomy node.
    ConceptDetailResponse:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        article_count:
          type: integer
          title: Article Count
          default: 0
        parent_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Id
        concept_kind:
          type: string
          title: Concept Kind
          default: topic
        created_at:
          type: string
          format: date-time
          title: Created At
        articles:
          items:
            $ref: '#/components/schemas/ArticleSummaryResponse'
          type: array
          title: Articles
          default: []
      type: object
      required:
      - id
      - name
      - created_at
      title: ConceptDetailResponse
      description: Full concept with linked articles.
    ConfidenceLevel:
      type: string
      enum:
      - sourced
      - mixed
      - inferred
      - opinion
      title: ConfidenceLevel
      description: Confidence level for claims.
    ContradictionFinding:
      properties:
        id:
          type: string
          title: Id
        user_id:
          type: string
          title: User Id
        report_id:
          type: string
          title: Report Id
        severity:
          $ref: '#/components/schemas/LintSeverity'
          default: warn
        description:
          type: string
          title: Description
        created_at:
          type: string
          format: date-time
          title: Created At
        dismissed:
          type: boolean
          title: Dismissed
          default: false
        dismissed_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Dismissed At
        content_hash:
          type: string
          title: Content Hash
        kind:
          $ref: '#/components/schemas/LintFindingKind'
          default: contradiction
        article_a_id:
          type: string
          title: Article A Id
        article_b_id:
          type: string
          title: Article B Id
        article_a_claim:
          type: string
          title: Article A Claim
        article_b_claim:
          type: string
          title: Article B Claim
        llm_confidence:
          type: string
          title: Llm Confidence
        shared_concept_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Shared Concept Id
        contradiction_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Contradiction Id
      type: object
      required:
      - user_id
      - report_id
      - description
      - content_hash
      - article_a_id
      - article_b_id
      - article_a_claim
      - article_b_claim
      - llm_confidence
      title: ContradictionFinding
      description: A contradiction between key claims of two articles that share a
        concept.
    ContradictionResolutionOption:
      properties:
        value:
          type: string
          title: Value
        label:
          type: string
          title: Label
      type: object
      required:
      - value
      - label
      title: ContradictionResolutionOption
      description: A valid resolution option for contradictions.
    ContradictionResponse:
      properties:
        id:
          type: string
          title: Id
        claim_a:
          type: string
          title: Claim A
        claim_b:
          type: string
          title: Claim B
        article_a_id:
          type: string
          title: Article A Id
        article_b_id:
          type: string
          title: Article B Id
        article_a_title:
          anyOf:
          - type: string
          - type: 'null'
          title: Article A Title
        article_b_title:
          anyOf:
          - type: string
          - type: 'null'
          title: Article B Title
        detected_at:
          type: string
          format: date-time
          title: Detected At
        status:
          type: string
          title: Status
        resolution:
          anyOf:
          - type: string
          - type: 'null'
          title: Resolution
        resolved_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Resolved At
        resolved_by:
          anyOf:
          - type: string
          - type: 'null'
          title: Resolved By
      type: object
      required:
      - id
      - claim_a
      - claim_b
      - article_a_id
      - article_b_id
      - detected_at
      - status
      title: ContradictionResponse
      description: API response for a single persisted contradiction.
    ContradictionStatus:
      type: string
      enum:
      - active
      - resolved
      - dismissed
      title: ContradictionStatus
      description: Lifecycle status of a persisted contradiction.
    ConversationDetail:
      properties:
        conversation:
          $ref: '#/components/schemas/ConversationResponse'
        queries:
          items:
            $ref: '#/components/schemas/QueryResponse'
          type: array
          title: Queries
      type: object
      required:
      - conversation
      - queries
      title: ConversationDetail
      description: Full conversation thread with all queries ordered by turn_index.
    ConversationResponse:
      properties:
        id:
          type: string
          title: Id
        title:
          type: string
          title: Title
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        filed_article_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Filed Article Id
        crystallized_article_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Crystallized Article Id
        parent_conversation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Conversation Id
        forked_at_turn_index:
          anyOf:
          - type: integer
          - type: 'null'
          title: Forked At Turn Index
        fork_count:
          type: integer
          title: Fork Count
          default: 0
      type: object
      required:
      - id
      - title
      - created_at
      - updated_at
      title: ConversationResponse
      description: Conversation metadata exposed via API.
    ConversationSummary:
      properties:
        id:
          type: string
          title: Id
        title:
          type: string
          title: Title
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        filed_article_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Filed Article Id
        crystallized_article_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Crystallized Article Id
        parent_conversation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Conversation Id
        forked_at_turn_index:
          anyOf:
          - type: integer
          - type: 'null'
          title: Forked At Turn Index
        fork_count:
          type: integer
          title: Fork Count
          default: 0
        turn_count:
          type: integer
          title: Turn Count
      type: object
      required:
      - id
      - title
      - created_at
      - updated_at
      - turn_count
      title: ConversationSummary
      description: Conversation summary for the history sidebar — adds turn count.
    CostBreakdownEntry:
      properties:
        cost_usd:
          type: number
          title: Cost Usd
        call_count:
          type: integer
          title: Call Count
      type: object
      required:
      - cost_usd
      - call_count
      title: CostBreakdownEntry
      description: Cost and call count for a single category.
    CostBreakdownResponse:
      properties:
        month:
          type: string
          title: Month
        total_usd:
          type: number
          title: Total Usd
        budget_usd:
          type: number
          title: Budget Usd
        budget_pct:
          type: number
          title: Budget Pct
        by_provider:
          additionalProperties:
            $ref: '#/components/schemas/CostBreakdownEntry'
          type: object
          title: By Provider
        by_task_type:
          additionalProperties:
            $ref: '#/components/schemas/CostBreakdownEntry'
          type: object
          title: By Task Type
      type: object
      required:
      - month
      - total_usd
      - budget_usd
      - budget_pct
      - by_provider
      - by_task_type
      title: CostBreakdownResponse
      description: Full cost breakdown for current month.
    CostSummaryResponse:
      properties:
        cost_this_month_usd:
          type: number
          title: Cost This Month Usd
        budget_usd:
          type: number
          title: Budget Usd
        budget_remaining_usd:
          type: number
          title: Budget Remaining Usd
      type: object
      required:
      - cost_this_month_usd
      - budget_usd
      - budget_remaining_usd
      title: CostSummaryResponse
      description: Simple cost summary for current month.
    CreateCompilationSchemaRequest:
      properties:
        name:
          type: string
          maxLength: 200
          minLength: 1
          title: Name
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        is_active:
          type: boolean
          title: Is Active
          default: false
        article_max_length:
          anyOf:
          - type: integer
            maximum: 50000.0
            minimum: 100.0
          - type: 'null'
          title: Article Max Length
        required_sections:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Required Sections
        style:
          anyOf:
          - type: string
            maxLength: 500
          - type: 'null'
          title: Style
        focus:
          anyOf:
          - type: string
            maxLength: 500
          - type: 'null'
          title: Focus
        concept_max_depth:
          anyOf:
          - type: integer
            maximum: 10.0
            minimum: 1.0
          - type: 'null'
          title: Concept Max Depth
        concept_naming:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          title: Concept Naming
        extraction_always_note:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Extraction Always Note
        extraction_ignore:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Extraction Ignore
        custom_directives:
          anyOf:
          - type: string
            maxLength: 2000
          - type: 'null'
          title: Custom Directives
      type: object
      required:
      - name
      title: CreateCompilationSchemaRequest
      description: Request to create a user-defined compilation schema.
    CreateSavedSearchRequest:
      properties:
        name:
          type: string
          maxLength: 200
          minLength: 1
          title: Name
        query:
          type: string
          title: Query
          default: ''
        filters_json:
          type: string
          title: Filters Json
          default: '{}'
      type: object
      required:
      - name
      title: CreateSavedSearchRequest
      description: Request to create a saved search.
    CreateShareLinkRequest:
      properties:
        article_id:
          type: string
          title: Article Id
        expires_in_days:
          anyOf:
          - type: integer
            maximum: 365.0
            minimum: 1.0
          - type: 'null'
          title: Expires In Days
      type: object
      required:
      - article_id
      title: CreateShareLinkRequest
      description: Request to create a share link for an article.
    CreateStubRequest:
      properties:
        title:
          type: string
          minLength: 1
          title: Title
        body_markdown:
          type: string
          title: Body Markdown
          default: ''
      type: object
      required:
      - title
      title: CreateStubRequest
      description: 'Request to create a stub wiki article (issue #451).'
    CreateStubResponse:
      properties:
        id:
          type: string
          title: Id
        slug:
          type: string
          title: Slug
        title:
          type: string
          title: Title
        is_stub:
          type: boolean
          title: Is Stub
          default: true
      type: object
      required:
      - id
      - slug
      - title
      title: CreateStubResponse
      description: Response after creating a stub article.
    CreateSynthesisRequest:
      properties:
        query:
          type: string
          minLength: 3
          title: Query
        article_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Article Ids
      type: object
      required:
      - query
      title: CreateSynthesisRequest
      description: Request to create a synthesis page from a topic/question.
    CreateTagRequest:
      properties:
        name:
          type: string
          maxLength: 100
          minLength: 1
          title: Name
        color:
          type: string
          title: Color
          default: '#6366f1'
      type: object
      required:
      - name
      title: CreateTagRequest
      description: Request to create a new tag.
    CrystallizeResponse:
      properties:
        article_id:
          type: string
          title: Article Id
        article_slug:
          type: string
          title: Article Slug
        title:
          type: string
          title: Title
        turns_distilled:
          type: integer
          title: Turns Distilled
      type: object
      required:
      - article_id
      - article_slug
      - title
      - turns_distilled
      title: CrystallizeResponse
      description: Response after crystallizing a conversation into a wiki article.
    DefaultProviderRequest:
      properties:
        provider:
          type: string
          title: Provider
      type: object
      required:
      - provider
      title: DefaultProviderRequest
      description: Request to set the default LLM provider.
    DefaultProviderResponse:
      properties:
        provider:
          type: string
          title: Provider
        status:
          type: string
          title: Status
      type: object
      required:
      - provider
      - status
      title: DefaultProviderResponse
      description: Response after setting default provider.
    DeleteAccountResponse:
      properties:
        deleted:
          type: string
          title: Deleted
      type: object
      required:
      - deleted
      title: DeleteAccountResponse
      description: Confirmation of account deletion.
    DeleteConfirmation:
      properties:
        deleted:
          type: string
          title: Deleted
      type: object
      required:
      - deleted
      title: DeleteConfirmation
      description: Confirmation of a resource deletion.
    DiscardCaptureRequest:
      properties:
        reason:
          anyOf:
          - type: string
          - type: 'null'
          title: Reason
      type: object
      title: DiscardCaptureRequest
      description: Optional request body when discarding a capture.
    DiscussionMessageRequest:
      properties:
        message:
          type: string
          maxLength: 10000
          minLength: 1
          title: Message
      type: object
      required:
      - message
      title: DiscussionMessageRequest
      description: Request to post a message in an article's discussion thread.
    DiscussionMessageResponse:
      properties:
        id:
          type: string
          title: Id
        article_id:
          type: string
          title: Article Id
        role:
          type: string
          title: Role
        content:
          type: string
          title: Content
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
      - id
      - article_id
      - role
      - content
      - created_at
      title: DiscussionMessageResponse
      description: API response for a single discussion message.
    DiscussionThreadResponse:
      properties:
        article_id:
          type: string
          title: Article Id
        messages:
          items:
            $ref: '#/components/schemas/DiscussionMessageResponse'
          type: array
          title: Messages
      type: object
      required:
      - article_id
      - messages
      title: DiscussionThreadResponse
      description: Full discussion thread for an article.
    DismissFindingResponse:
      properties:
        dismissed:
          type: boolean
          title: Dismissed
        kind:
          type: string
          title: Kind
        finding_id:
          type: string
          title: Finding Id
      type: object
      required:
      - dismissed
      - kind
      - finding_id
      title: DismissFindingResponse
      description: Response after dismissing a lint finding.
    DoclingStatusResponse:
      properties:
        status:
          type: string
          title: Status
        url:
          type: string
          title: Url
        latency_ms:
          anyOf:
          - type: number
          - type: 'null'
          title: Latency Ms
      type: object
      required:
      - status
      - url
      title: DoclingStatusResponse
      description: Response model for Docling sidecar health check.
    EligibleConcept:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        article_count:
          type: integer
          title: Article Count
        has_existing_page:
          type: boolean
          title: Has Existing Page
          default: false
      type: object
      required:
      - id
      - name
      - article_count
      title: EligibleConcept
      description: Concept eligible for concept-page generation.
    ExportFormat:
      type: string
      enum:
      - pdf
      - linkedin
      - slides
      title: ExportFormat
      description: Supported article export formats.
    ExportResponse:
      properties:
        format:
          $ref: '#/components/schemas/ExportFormat'
        content:
          type: string
          title: Content
        article_id:
          type: string
          title: Article Id
        article_title:
          type: string
          title: Article Title
      type: object
      required:
      - format
      - content
      - article_id
      - article_title
      title: ExportResponse
      description: Response for text-based exports (LinkedIn, slides).
    FacetBucket:
      properties:
        value:
          type: string
          title: Value
        count:
          type: integer
          title: Count
      type: object
      required:
      - value
      - count
      title: FacetBucket
      description: A single bucket within a facet (e.g. source_kind=pdf, count=12).
    FacetGroup:
      properties:
        name:
          type: string
          title: Name
        buckets:
          items:
            $ref: '#/components/schemas/FacetBucket'
          type: array
          title: Buckets
      type: object
      required:
      - name
      - buckets
      title: FacetGroup
      description: A named facet with its buckets.
    FacetResponse:
      properties:
        facets:
          items:
            $ref: '#/components/schemas/FacetGroup'
          type: array
          title: Facets
        total:
          type: integer
          title: Total
        query:
          type: string
          title: Query
      type: object
      required:
      - facets
      - total
      - query
      title: FacetResponse
      description: All facet groups for a search query.
    FileBackArticleRef:
      properties:
        id:
          type: string
          title: Id
        slug:
          type: string
          title: Slug
        title:
          type: string
          title: Title
      type: object
      required:
      - id
      - slug
      - title
      title: FileBackArticleRef
      description: Minimal article reference returned by file-back operations.
    FileBackResult:
      properties:
        article:
          $ref: '#/components/schemas/FileBackArticleRef'
        was_update:
          type: boolean
          title: Was Update
          default: false
      type: object
      required:
      - article
      title: FileBackResult
      description: Result of filing a conversation or selection back to the wiki.
    FileBackSelectionRequest:
      properties:
        selections:
          items:
            $ref: '#/components/schemas/TurnSelection'
          type: array
          title: Selections
        title:
          anyOf:
          - type: string
          - type: 'null'
          title: Title
      type: object
      required:
      - selections
      title: FileBackSelectionRequest
      description: Request to file back selected turns from one or more conversations.
    ForkRequest:
      properties:
        turn_index:
          type: integer
          title: Turn Index
        new_question:
          type: string
          title: New Question
      type: object
      required:
      - turn_index
      - new_question
      title: ForkRequest
      description: Request to fork a conversation at a specific turn with a new question.
    GraphEdge:
      properties:
        source:
          type: string
          title: Source
        target:
          type: string
          title: Target
        context:
          anyOf:
          - type: string
          - type: 'null'
          title: Context
        relation_type:
          $ref: '#/components/schemas/RelationType'
          default: references
        resolution:
          anyOf:
          - type: string
          - type: 'null'
          title: Resolution
      type: object
      required:
      - source
      - target
      - context
      title: GraphEdge
      description: An edge in the knowledge graph.
    GraphNode:
      properties:
        id:
          type: string
          title: Id
        label:
          type: string
          title: Label
        concept_cluster:
          anyOf:
          - type: string
          - type: 'null'
          title: Concept Cluster
        concepts:
          items:
            type: string
          type: array
          title: Concepts
          default: []
        connection_count:
          type: integer
          title: Connection Count
        confidence:
          anyOf:
          - $ref: '#/components/schemas/ConfidenceLevel'
          - type: 'null'
        confidence_score:
          type: number
          title: Confidence Score
          default: 0.5
        effective_confidence:
          type: number
          title: Effective Confidence
          default: 0.5
      type: object
      required:
      - id
      - label
      - concept_cluster
      - connection_count
      - confidence
      title: GraphNode
      description: A node in the knowledge graph.
    GraphResponse:
      properties:
        nodes:
          items:
            $ref: '#/components/schemas/GraphNode'
          type: array
          title: Nodes
        edges:
          items:
            $ref: '#/components/schemas/GraphEdge'
          type: array
          title: Edges
      type: object
      required:
      - nodes
      - edges
      title: GraphResponse
      description: Full knowledge graph response.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    HealthSummaryResponse:
      properties:
        generated_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Generated At
        total_articles:
          type: integer
          title: Total Articles
          default: 0
        total_findings:
          anyOf:
          - type: integer
          - type: 'null'
          title: Total Findings
        contradictions_count:
          anyOf:
          - type: integer
          - type: 'null'
          title: Contradictions Count
        orphans_count:
          anyOf:
          - type: integer
          - type: 'null'
          title: Orphans Count
        status:
          anyOf:
          - type: string
          - type: 'null'
          title: Status
        message:
          anyOf:
          - type: string
          - type: 'null'
          title: Message
      type: object
      title: HealthSummaryResponse
      description: Lightweight health summary from latest lint report.
    IngestStatus:
      type: string
      enum:
      - pending
      - processing
      - review_pending
      - compiled
      - failed
      title: IngestStatus
      description: Status of source ingestion.
    IngestTextRequest:
      properties:
        content:
          type: string
          maxLength: 500000
          title: Content
        title:
          anyOf:
          - type: string
          - type: 'null'
          title: Title
        auto_compile:
          type: boolean
          title: Auto Compile
          default: true
      type: object
      required:
      - content
      title: IngestTextRequest
      description: Request to ingest raw text.
    IngestURLRequest:
      properties:
        url:
          type: string
          minLength: 1
          format: uri
          title: Url
        auto_compile:
          type: boolean
          title: Auto Compile
          default: true
      type: object
      required:
      - url
      title: IngestURLRequest
      description: 'Request to ingest a URL.


        Only ``http`` and ``https`` schemes are accepted (enforced by ``AnyHttpUrl``).'
    Job:
      properties:
        id:
          type: string
          title: Id
        user_id:
          type: string
          title: User Id
        job_type:
          $ref: '#/components/schemas/JobType'
        status:
          $ref: '#/components/schemas/JobStatus'
          default: queued
        source_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Id
        article_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Article Id
        priority:
          type: integer
          title: Priority
          default: 5
        queued_at:
          type: string
          format: date-time
          title: Queued At
        started_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Started At
        completed_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Completed At
        error:
          anyOf:
          - type: string
          - type: 'null'
          title: Error
        result_summary:
          anyOf:
          - type: string
          - type: 'null'
          title: Result Summary
      type: object
      required:
      - user_id
      - job_type
      title: Job
      description: Async job record.
    JobStatus:
      type: string
      enum:
      - queued
      - running
      - complete
      - failed
      title: JobStatus
      description: Status of an async job.
    JobTriggerResponse:
      properties:
        status:
          type: string
          title: Status
        job_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Job Id
        message:
          anyOf:
          - type: string
          - type: 'null'
          title: Message
      type: object
      required:
      - status
      title: JobTriggerResponse
      description: Response after triggering an async job.
    JobType:
      type: string
      enum:
      - compile_source
      - lint_wiki
      - sweep_wikilinks
      - reindex
      - embed_chunks
      - recompile_article
      - sync_push
      - sync_pull
      - poll_rss_feeds
      - ping
      title: JobType
      description: Type of async job.
    LLMSettingsResponse:
      properties:
        default_provider:
          type: string
          title: Default Provider
        fallback_enabled:
          type: boolean
          title: Fallback Enabled
        monthly_budget_usd:
          type: number
          title: Monthly Budget Usd
        providers:
          additionalProperties:
            $ref: '#/components/schemas/ProviderDetail'
          type: object
          title: Providers
      type: object
      required:
      - default_provider
      - fallback_enabled
      - monthly_budget_usd
      - providers
      title: LLMSettingsResponse
      description: LLM configuration section.
    LLMTestResponse:
      properties:
        provider:
          type: string
          title: Provider
        status:
          type: string
          title: Status
        latency_ms:
          anyOf:
          - type: number
          - type: 'null'
          title: Latency Ms
        error:
          anyOf:
          - type: string
          - type: 'null'
          title: Error
      type: object
      required:
      - provider
      - status
      title: LLMTestResponse
      description: Response from LLM connection test.
    LLMTraceListResponse:
      properties:
        items:
          items:
            $ref: '#/components/schemas/LLMTraceResponse'
          type: array
          title: Items
        total:
          type: integer
          title: Total
      type: object
      required:
      - items
      - total
      title: LLMTraceListResponse
      description: Paginated list of LLM traces.
    LLMTraceResponse:
      properties:
        id:
          type: string
          title: Id
        user_id:
          type: string
          title: User Id
        model:
          type: string
          title: Model
        prompt_tokens:
          type: integer
          title: Prompt Tokens
        completion_tokens:
          type: integer
          title: Completion Tokens
        total_tokens:
          type: integer
          title: Total Tokens
        latency_ms:
          type: number
          title: Latency Ms
        created_at:
          type: string
          format: date-time
          title: Created At
        prompt_text:
          anyOf:
          - type: string
          - type: 'null'
          title: Prompt Text
        completion_text:
          anyOf:
          - type: string
          - type: 'null'
          title: Completion Text
        source_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Id
        operation:
          type: string
          title: Operation
      type: object
      required:
      - id
      - user_id
      - model
      - prompt_tokens
      - completion_tokens
      - total_tokens
      - latency_ms
      - created_at
      - operation
      title: LLMTraceResponse
      description: API response for a single LLM trace entry.
    LinkedArticleSummary:
      properties:
        id:
          type: string
          title: Id
        slug:
          type: string
          title: Slug
        title:
          type: string
          title: Title
        page_type:
          $ref: '#/components/schemas/PageType'
          default: source
      type: object
      required:
      - id
      - slug
      - title
      title: LinkedArticleSummary
      description: Minimal article info for the source detail view.
    LintFindingKind:
      type: string
      enum:
      - contradiction
      - orphan
      - structural
      title: LintFindingKind
      description: 'Kind of lint finding — maps 1:1 to a detection function AND a
        table.


        Used as the content_hash prefix (so dismiss state is keyed by kind + content)

        and as the discriminator field in the frontend API response union.'
    LintReport:
      properties:
        id:
          type: string
          title: Id
        user_id:
          type: string
          title: User Id
        generated_at:
          type: string
          format: date-time
          title: Generated At
        completed_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Completed At
        status:
          $ref: '#/components/schemas/LintReportStatus'
          default: in_progress
        article_count:
          type: integer
          title: Article Count
          default: 0
        total_findings:
          type: integer
          title: Total Findings
          default: 0
        contradictions_count:
          type: integer
          title: Contradictions Count
          default: 0
        orphans_count:
          type: integer
          title: Orphans Count
          default: 0
        structural_count:
          type: integer
          title: Structural Count
          default: 0
        checked_articles:
          anyOf:
          - type: integer
          - type: 'null'
          title: Checked Articles
        missing_pages_count:
          type: integer
          title: Missing Pages Count
          default: 0
        dismissed_count:
          type: integer
          title: Dismissed Count
          default: 0
        total_pairs:
          type: integer
          title: Total Pairs
          default: 0
        checked_pairs:
          type: integer
          title: Checked Pairs
          default: 0
        error_message:
          anyOf:
          - type: string
          - type: 'null'
          title: Error Message
        job_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Job Id
      type: object
      required:
      - user_id
      title: LintReport
      description: One run of the linter. All findings from a run FK back to this
        row via report_id.
    LintReportDetail:
      properties:
        report:
          $ref: '#/components/schemas/LintReport'
        contradictions:
          items:
            $ref: '#/components/schemas/ContradictionFinding'
          type: array
          title: Contradictions
        orphans:
          items:
            $ref: '#/components/schemas/OrphanFinding'
          type: array
          title: Orphans
        resolutions:
          additionalProperties:
            type: string
          type: object
          title: Resolutions
          default: {}
        structurals:
          items:
            $ref: '#/components/schemas/StructuralFinding'
          type: array
          title: Structurals
          default: []
      type: object
      required:
      - report
      - contradictions
      - orphans
      title: LintReportDetail
      description: API response shape for a single report with all findings.
    LintReportStatus:
      type: string
      enum:
      - in_progress
      - complete
      - failed
      title: LintReportStatus
      description: Lifecycle of a lint report.
    LintRunResponse:
      properties:
        status:
          type: string
          title: Status
      type: object
      required:
      - status
      title: LintRunResponse
      description: Response after triggering a lint run.
    LintSeverity:
      type: string
      enum:
      - info
      - warn
      - error
      title: LintSeverity
      description: Severity level for a lint finding.
    LocatorKind:
      type: string
      enum:
      - pdf-page-rect
      - html-paragraph-offset
      - text-byte-range
      - youtube-timestamp
      title: LocatorKind
      description: 'Type of anchor locator for a source span (issue #450).'
    MCPTokenCreateRequest:
      properties:
        name:
          type: string
          maxLength: 100
          minLength: 1
          title: Name
      type: object
      required:
      - name
      title: MCPTokenCreateRequest
      description: Request to generate a new MCP personal access token.
    MCPTokenCreateResponse:
      properties:
        id:
          type: string
          title: Id
        token:
          type: string
          title: Token
        name:
          type: string
          title: Name
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
      - id
      - token
      - name
      - created_at
      title: MCPTokenCreateResponse
      description: Response after creating an MCP token (plaintext shown ONCE).
    MCPTokenResponse:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        token_prefix:
          type: string
          title: Token Prefix
        created_at:
          type: string
          format: date-time
          title: Created At
        last_used_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Last Used At
        revoked:
          type: boolean
          title: Revoked
      type: object
      required:
      - id
      - name
      - token_prefix
      - created_at
      - last_used_at
      - revoked
      title: MCPTokenResponse
      description: API response for an existing MCP token (never includes plaintext).
    MCPTokenRevokeResponse:
      properties:
        status:
          type: string
          title: Status
      type: object
      required:
      - status
      title: MCPTokenRevokeResponse
      description: Response after revoking an MCP token.
    MagicLinkRequest:
      properties:
        email:
          type: string
          title: Email
      type: object
      required:
      - email
      title: MagicLinkRequest
      description: Request to send a magic link login email.
    MagicLinkResponse:
      properties:
        status:
          type: string
          title: Status
        message:
          type: string
          title: Message
        dev_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Dev Token
      type: object
      required:
      - status
      - message
      title: MagicLinkResponse
      description: Response after requesting a magic link.
    MagicLinkVerifyRequest:
      properties:
        token:
          type: string
          title: Token
      type: object
      required:
      - token
      title: MagicLinkVerifyRequest
      description: Request to verify a magic link token.
    MagicLinkVerifyResponse:
      properties:
        access_token:
          type: string
          title: Access Token
        token_type:
          type: string
          title: Token Type
          default: bearer
        user:
          additionalProperties: true
          type: object
          title: User
      type: object
      required:
      - access_token
      - user
      title: MagicLinkVerifyResponse
      description: Response after successfully verifying a magic link token.
    OnboardingStatusResponse:
      properties:
        completed:
          type: boolean
          title: Completed
        step:
          type: integer
          title: Step
      type: object
      required:
      - completed
      - step
      title: OnboardingStatusResponse
      description: Onboarding wizard progress.
    OrphanArticle:
      properties:
        id:
          type: string
          title: Id
        slug:
          type: string
          title: Slug
        title:
          type: string
          title: Title
        file_path:
          type: string
          title: File Path
      type: object
      required:
      - id
      - slug
      - title
      - file_path
      title: OrphanArticle
      description: Article whose wiki file is missing from disk.
    OrphanFinding:
      properties:
        id:
          type: string
          title: Id
        user_id:
          type: string
          title: User Id
        report_id:
          type: string
          title: Report Id
        severity:
          $ref: '#/components/schemas/LintSeverity'
          default: warn
        description:
          type: string
          title: Description
        created_at:
          type: string
          format: date-time
          title: Created At
        dismissed:
          type: boolean
          title: Dismissed
          default: false
        dismissed_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Dismissed At
        content_hash:
          type: string
          title: Content Hash
        kind:
          $ref: '#/components/schemas/LintFindingKind'
          default: orphan
        article_id:
          type: string
          title: Article Id
        article_title:
          type: string
          title: Article Title
      type: object
      required:
      - user_id
      - report_id
      - description
      - content_hash
      - article_id
      - article_title
      title: OrphanFinding
      description: An article with zero inbound AND zero outbound backlinks.
    PageType:
      type: string
      enum:
      - source
      - concept
      - answer
      - index
      - meta
      - synthesis
      title: PageType
      description: Type of wiki page — determines compilation pipeline and validation
        rules.
    PipelineStep:
      properties:
        name:
          type: string
          title: Name
        status:
          type: string
          title: Status
        description:
          type: string
          title: Description
      type: object
      required:
      - name
      - status
      - description
      title: PipelineStep
      description: A single step in the source processing pipeline.
    PlanResponse:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        display_name:
          type: string
          title: Display Name
        price_cents:
          type: integer
          title: Price Cents
        billing_interval:
          anyOf:
          - type: string
          - type: 'null'
          title: Billing Interval
        max_sources:
          anyOf:
          - type: integer
          - type: 'null'
          title: Max Sources
        max_articles:
          anyOf:
          - type: integer
          - type: 'null'
          title: Max Articles
        max_queries_per_day:
          anyOf:
          - type: integer
          - type: 'null'
          title: Max Queries Per Day
        max_storage_bytes:
          anyOf:
          - type: integer
          - type: 'null'
          title: Max Storage Bytes
        max_active_shares:
          anyOf:
          - type: integer
          - type: 'null'
          title: Max Active Shares
        allowed_exports:
          items:
            type: string
          type: array
          title: Allowed Exports
        mcp_enabled:
          type: boolean
          title: Mcp Enabled
        byok_allowed:
          type: boolean
          title: Byok Allowed
        sort_order:
          type: integer
          title: Sort Order
      type: object
      required:
      - id
      - name
      - display_name
      - price_cents
      - billing_interval
      - max_sources
      - max_articles
      - max_queries_per_day
      - max_storage_bytes
      - max_active_shares
      - allowed_exports
      - mcp_enabled
      - byok_allowed
      - sort_order
      title: PlanResponse
      description: Public billing plan details.
    PortalResponse:
      properties:
        portal_url:
          type: string
          title: Portal Url
      type: object
      required:
      - portal_url
      title: PortalResponse
      description: Customer portal URL response.
    ProviderDetail:
      properties:
        enabled:
          type: boolean
          title: Enabled
        model:
          type: string
          title: Model
        configured:
          type: boolean
          title: Configured
        base_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Base Url
      type: object
      required:
      - enabled
      - model
      - configured
      title: ProviderDetail
      description: Provider status.
    PublicArticleResponse:
      properties:
        title:
          type: string
          title: Title
        content_html:
          type: string
          title: Content Html
        summary:
          anyOf:
          - type: string
          - type: 'null'
          title: Summary
        sources:
          items:
            $ref: '#/components/schemas/SourceResponse'
          type: array
          title: Sources
          default: []
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
      type: object
      required:
      - title
      - content_html
      - summary
      - created_at
      - updated_at
      title: PublicArticleResponse
      description: Read-only public article content for share links.
    Query:
      properties:
        id:
          type: string
          title: Id
        user_id:
          type: string
          title: User Id
        question:
          type: string
          title: Question
        answer:
          type: string
          title: Answer
        confidence:
          anyOf:
          - type: string
          - type: 'null'
          title: Confidence
        source_article_ids:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Article Ids
        related_article_ids:
          anyOf:
          - type: string
          - type: 'null'
          title: Related Article Ids
        filed_back:
          type: boolean
          title: Filed Back
          default: false
        filed_article_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Filed Article Id
        created_at:
          type: string
          format: date-time
          title: Created At
        conversation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Conversation Id
        turn_index:
          type: integer
          title: Turn Index
          default: 0
      type: object
      required:
      - user_id
      - question
      - answer
      title: Query
      description: Q&A history entry.
    QueryRequest:
      properties:
        question:
          type: string
          maxLength: 10000
          title: Question
        file_back:
          type: boolean
          title: File Back
          default: false
        conversation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Conversation Id
      type: object
      required:
      - question
      title: QueryRequest
      description: Request to query the wiki.
    QueryResponse:
      properties:
        id:
          type: string
          title: Id
        question:
          type: string
          title: Question
        answer:
          type: string
          title: Answer
        confidence:
          anyOf:
          - type: string
          - type: 'null'
          title: Confidence
        source_article_ids:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Article Ids
        related_article_ids:
          anyOf:
          - type: string
          - type: 'null'
          title: Related Article Ids
        filed_back:
          type: boolean
          title: Filed Back
        filed_article_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Filed Article Id
        created_at:
          type: string
          format: date-time
          title: Created At
        conversation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Conversation Id
        turn_index:
          type: integer
          title: Turn Index
          default: 0
        citations:
          items:
            $ref: '#/components/schemas/CitationResponse'
          type: array
          title: Citations
          default: []
        wiki_worthiness:
          anyOf:
          - $ref: '#/components/schemas/WikiWorthinessScore'
          - type: 'null'
      type: object
      required:
      - id
      - question
      - answer
      - confidence
      - source_article_ids
      - related_article_ids
      - filed_back
      - filed_article_id
      - created_at
      title: QueryResponse
      description: 'Q&A response enriched with a full Answer -> Article -> Source
        citation chain.


        Mirrors the persisted :class:`Query` record fields while adding a

        resolved ``citations`` list so clients can see which articles were

        used and which original sources those articles came from.'
    RebuildConceptsResponse:
      properties:
        status:
          type: string
          title: Status
      type: object
      required:
      - status
      title: RebuildConceptsResponse
      description: Response after triggering taxonomy rebuild.
    RecentSourceEntry:
      properties:
        id:
          type: string
          title: Id
        title:
          anyOf:
          - type: string
          - type: 'null'
          title: Title
        source_type:
          type: string
          title: Source Type
        status:
          type: string
          title: Status
        ingested_at:
          type: string
          format: date-time
          title: Ingested At
      type: object
      required:
      - id
      - title
      - source_type
      - status
      - ingested_at
      title: RecentSourceEntry
      description: A recently ingested source entry for the admin user detail view.
    RecompileResponse:
      properties:
        status:
          type: string
          title: Status
        job_id:
          type: string
          title: Job Id
      type: object
      required:
      - status
      - job_id
      title: RecompileResponse
      description: Response after scheduling an article recompile.
    RefreshArticleResponse:
      properties:
        status:
          type: string
          title: Status
        staleness_score:
          type: number
          title: Staleness Score
      type: object
      required:
      - status
      - staleness_score
      title: RefreshArticleResponse
      description: 'Response after marking an article as manually refreshed (issue
        #425).'
    RejectDraftResponse:
      properties:
        status:
          type: string
          title: Status
        source_id:
          type: string
          title: Source Id
      type: object
      required:
      - status
      - source_id
      title: RejectDraftResponse
      description: Response after rejecting a compilation draft.
    RelationType:
      type: string
      enum:
      - references
      - contradicts
      - extends
      - supersedes
      - synthesizes
      - related_to
      title: RelationType
      description: Semantic relationship between two linked articles.
    RelationshipEdge:
      properties:
        article_id:
          type: string
          title: Article Id
        slug:
          type: string
          title: Slug
        title:
          type: string
          title: Title
        relation_type:
          $ref: '#/components/schemas/RelationType'
          default: references
        context:
          anyOf:
          - type: string
          - type: 'null'
          title: Context
        resolution:
          anyOf:
          - type: string
          - type: 'null'
          title: Resolution
      type: object
      required:
      - article_id
      - slug
      - title
      title: RelationshipEdge
      description: 'One end of a typed relationship to another article.


        Used by ``GET /wiki/articles/{id_or_slug}/relationships`` to describe

        the article on the *other* side of a backlink, plus any context or

        resolution metadata recorded on the edge.'
    ResolveContradictionBody:
      properties:
        status:
          $ref: '#/components/schemas/ContradictionStatus'
        resolution:
          anyOf:
          - type: string
          - type: 'null'
          title: Resolution
      type: object
      required:
      - status
      title: ResolveContradictionBody
      description: Request body for resolving or dismissing a persisted contradiction.
    ResolveContradictionRequest:
      properties:
        resolution:
          type: string
          title: Resolution
        resolution_note:
          anyOf:
          - type: string
          - type: 'null'
          title: Resolution Note
      type: object
      required:
      - resolution
      title: ResolveContradictionRequest
      description: Request to resolve a contradiction between two articles.
    ResolveContradictionResponse:
      properties:
        resolved:
          type: boolean
          title: Resolved
        source_id:
          type: string
          title: Source Id
        target_id:
          type: string
          title: Target Id
        resolution:
          type: string
          title: Resolution
      type: object
      required:
      - resolved
      - source_id
      - target_id
      - resolution
      title: ResolveContradictionResponse
      description: Response after resolving a contradiction.
    RssFeedListResponse:
      properties:
        feeds:
          items:
            $ref: '#/components/schemas/RssFeedResponse'
          type: array
          title: Feeds
      type: object
      required:
      - feeds
      title: RssFeedListResponse
      description: List of RSS feed subscriptions.
    RssFeedRequest:
      properties:
        feed_url:
          type: string
          title: Feed Url
        title:
          anyOf:
          - type: string
          - type: 'null'
          title: Title
      type: object
      required:
      - feed_url
      title: RssFeedRequest
      description: Request to subscribe to an RSS feed.
    RssFeedResponse:
      properties:
        id:
          type: string
          title: Id
        feed_url:
          type: string
          title: Feed Url
        title:
          anyOf:
          - type: string
          - type: 'null'
          title: Title
        enabled:
          type: boolean
          title: Enabled
        last_polled_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Last Polled At
        error_message:
          anyOf:
          - type: string
          - type: 'null'
          title: Error Message
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
      - id
      - feed_url
      - title
      - enabled
      - created_at
      title: RssFeedResponse
      description: API response for an RSS feed subscription.
    RssFeedToggleRequest:
      properties:
        enabled:
          type: boolean
          title: Enabled
      type: object
      required:
      - enabled
      title: RssFeedToggleRequest
      description: Request to enable or disable an RSS feed.
    RssPollResponse:
      properties:
        feed_id:
          type: string
          title: Feed Id
        new_captures:
          type: integer
          title: New Captures
        status:
          type: string
          title: Status
          default: polled
      type: object
      required:
      - feed_id
      - new_captures
      title: RssPollResponse
      description: Response after triggering an RSS poll.
    SavedSearchExecuteResponse:
      properties:
        saved_search:
          $ref: '#/components/schemas/SavedSearchResponse'
        articles:
          items:
            $ref: '#/components/schemas/ArticleSummaryResponse'
          type: array
          title: Articles
      type: object
      required:
      - saved_search
      - articles
      title: SavedSearchExecuteResponse
      description: Response when executing a saved search.
    SavedSearchResponse:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        query:
          type: string
          title: Query
        filters_json:
          type: string
          title: Filters Json
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
      - id
      - name
      - query
      - filters_json
      - created_at
      title: SavedSearchResponse
      description: API response for a saved search.
    SearchResponse:
      properties:
        results:
          items:
            $ref: '#/components/schemas/SearchResult'
          type: array
          title: Results
        total:
          type: integer
          title: Total
        query:
          type: string
          title: Query
      type: object
      required:
      - results
      - total
      - query
      title: SearchResponse
      description: Paginated full-text search response.
    SearchResult:
      properties:
        article_id:
          type: string
          title: Article Id
        slug:
          type: string
          title: Slug
        title:
          type: string
          title: Title
        snippet:
          type: string
          title: Snippet
        rank:
          type: number
          title: Rank
      type: object
      required:
      - article_id
      - slug
      - title
      - snippet
      - rank
      title: SearchResult
      description: A single full-text search result with snippet and relevance score.
    SetApiKeyRequest:
      properties:
        api_key:
          type: string
          title: Api Key
      type: object
      required:
      - api_key
      title: SetApiKeyRequest
      description: Request to store an API key for a provider.
    SettingsUpdateRequest:
      properties:
        monthly_budget_usd:
          anyOf:
          - type: number
          - type: 'null'
          title: Monthly Budget Usd
        default_provider:
          anyOf:
          - type: string
          - type: 'null'
          title: Default Provider
        fallback_enabled:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Fallback Enabled
        openai_compatible_base_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Openai Compatible Base Url
        openai_compatible_model:
          anyOf:
          - type: string
          - type: 'null'
          title: Openai Compatible Model
        openai_compatible_supports_json_response_format:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Openai Compatible Supports Json Response Format
        openai_compatible_supports_stream_usage:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Openai Compatible Supports Stream Usage
        openai_compatible_supports_reasoning_effort:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Openai Compatible Supports Reasoning Effort
        openai_compatible_max_tokens_field:
          anyOf:
          - type: string
          - type: 'null'
          title: Openai Compatible Max Tokens Field
        openai_compatible_reasoning_format:
          anyOf:
          - type: string
          - type: 'null'
          title: Openai Compatible Reasoning Format
      type: object
      title: SettingsUpdateRequest
      description: Request to update settings.
    SettingsUpdateResponse:
      properties:
        status:
          type: string
          title: Status
      type: object
      required:
      - status
      title: SettingsUpdateResponse
      description: Response after updating settings.
    ShareLinkResponse:
      properties:
        id:
          type: string
          title: Id
        article_id:
          type: string
          title: Article Id
        token:
          type: string
          title: Token
        created_at:
          type: string
          format: date-time
          title: Created At
        expires_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Expires At
        revoked:
          type: boolean
          title: Revoked
        view_count:
          type: integer
          title: View Count
        last_viewed_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Last Viewed At
        article_title:
          anyOf:
          - type: string
          - type: 'null'
          title: Article Title
      type: object
      required:
      - id
      - article_id
      - token
      - created_at
      - expires_at
      - revoked
      - view_count
      - last_viewed_at
      title: ShareLinkResponse
      description: API response for a share link.
    Source:
      properties:
        id:
          type: string
          title: Id
        user_id:
          type: string
          title: User Id
        source_type:
          $ref: '#/components/schemas/SourceType'
        source_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Url
        title:
          anyOf:
          - type: string
          - type: 'null'
          title: Title
        author:
          anyOf:
          - type: string
          - type: 'null'
          title: Author
        published_date:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Published Date
        status:
          $ref: '#/components/schemas/IngestStatus'
          default: pending
        ingested_at:
          type: string
          format: date-time
          title: Ingested At
        compiled_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Compiled At
        token_count:
          anyOf:
          - type: integer
          - type: 'null'
          title: Token Count
        error_message:
          anyOf:
          - type: string
          - type: 'null'
          title: Error Message
        file_path:
          anyOf:
          - type: string
          - type: 'null'
          title: File Path
        content_hash:
          anyOf:
          - type: string
          - type: 'null'
          title: Content Hash
        has_original:
          type: boolean
          title: Has Original
          description: Whether the original document (PDF, HTML) exists alongside
            the .txt.
          readOnly: true
      type: object
      required:
      - user_id
      - source_type
      - has_original
      title: Source
      description: Raw ingested source — before compilation.
    SourceContentResponse:
      properties:
        content:
          type: string
          title: Content
        source_type:
          $ref: '#/components/schemas/SourceType'
        title:
          anyOf:
          - type: string
          - type: 'null'
          title: Title
        truncated:
          type: boolean
          title: Truncated
          default: false
      type: object
      required:
      - content
      - source_type
      - title
      title: SourceContentResponse
      description: Raw text content of an ingested source for side-by-side reading.
    SourceDetailResponse:
      properties:
        id:
          type: string
          title: Id
        source_type:
          $ref: '#/components/schemas/SourceType'
        source_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Url
        title:
          anyOf:
          - type: string
          - type: 'null'
          title: Title
        author:
          anyOf:
          - type: string
          - type: 'null'
          title: Author
        published_date:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Published Date
        status:
          $ref: '#/components/schemas/IngestStatus'
        ingested_at:
          type: string
          format: date-time
          title: Ingested At
        compiled_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Compiled At
        token_count:
          anyOf:
          - type: integer
          - type: 'null'
          title: Token Count
        error_message:
          anyOf:
          - type: string
          - type: 'null'
          title: Error Message
        has_original:
          type: boolean
          title: Has Original
        pipeline_steps:
          items:
            $ref: '#/components/schemas/PipelineStep'
          type: array
          title: Pipeline Steps
        images:
          items:
            $ref: '#/components/schemas/SourceImageEntry'
          type: array
          title: Images
        linked_articles:
          items:
            $ref: '#/components/schemas/LinkedArticleSummary'
          type: array
          title: Linked Articles
      type: object
      required:
      - id
      - source_type
      - source_url
      - title
      - author
      - published_date
      - status
      - ingested_at
      - compiled_at
      - token_count
      - error_message
      - has_original
      - pipeline_steps
      - images
      - linked_articles
      title: SourceDetailResponse
      description: Full source detail with pipeline steps, images, and linked articles.
    SourceImageEntry:
      properties:
        filename:
          type: string
          title: Filename
        kind:
          type: string
          title: Kind
        label:
          type: string
          title: Label
      type: object
      required:
      - filename
      - kind
      - label
      title: SourceImageEntry
      description: An extracted image entry for the source detail view.
    SourceResponse:
      properties:
        id:
          type: string
          title: Id
        source_type:
          $ref: '#/components/schemas/SourceType'
        title:
          anyOf:
          - type: string
          - type: 'null'
          title: Title
        source_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Url
        ingested_at:
          type: string
          format: date-time
          title: Ingested At
      type: object
      required:
      - id
      - source_type
      - title
      - source_url
      - ingested_at
      title: SourceResponse
      description: 'Provenance view of a raw ingested source exposed via the API.


        Trimmed view of :class:`Source` suitable for embedding in article and

        Q&A responses so callers can trace claims back to their origin

        (URL, PDF filename, upload date, etc.).'
    SourceSpanResponse:
      properties:
        id:
          type: string
          title: Id
        source_id:
          type: string
          title: Source Id
        locator_kind:
          $ref: '#/components/schemas/LocatorKind'
        locator:
          additionalProperties: true
          type: object
          title: Locator
        text:
          type: string
          title: Text
        fingerprint:
          type: string
          title: Fingerprint
        stale:
          type: boolean
          title: Stale
          default: false
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
      - id
      - source_id
      - locator_kind
      - locator
      - text
      - fingerprint
      - created_at
      title: SourceSpanResponse
      description: API response for a single source span anchor.
    SourceType:
      type: string
      enum:
      - url
      - pdf
      - youtube
      - audio
      - text
      - rss
      - email
      - obsidian
      title: SourceType
      description: Type of ingested source.
    StructuralFinding:
      properties:
        id:
          type: string
          title: Id
        user_id:
          type: string
          title: User Id
        report_id:
          type: string
          title: Report Id
        severity:
          $ref: '#/components/schemas/LintSeverity'
          default: warn
        description:
          type: string
          title: Description
        created_at:
          type: string
          format: date-time
          title: Created At
        dismissed:
          type: boolean
          title: Dismissed
          default: false
        dismissed_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Dismissed At
        content_hash:
          type: string
          title: Content Hash
        kind:
          $ref: '#/components/schemas/LintFindingKind'
          default: structural
        article_id:
          type: string
          title: Article Id
        violation_type:
          type: string
          title: Violation Type
        auto_repaired:
          type: boolean
          title: Auto Repaired
          default: false
        detail:
          type: string
          title: Detail
          default: ''
      type: object
      required:
      - user_id
      - report_id
      - description
      - content_hash
      - article_id
      - violation_type
      title: StructuralFinding
      description: A structural integrity violation detected by the backlink enforcer.
    StuckSource:
      properties:
        id:
          type: string
          title: Id
        title:
          anyOf:
          - type: string
          - type: 'null'
          title: Title
        source_type:
          type: string
          title: Source Type
        ingested_at:
          type: string
          title: Ingested At
        minutes_stuck:
          type: integer
          title: Minutes Stuck
      type: object
      required:
      - id
      - title
      - source_type
      - ingested_at
      - minutes_stuck
      title: StuckSource
      description: Source stuck in processing for longer than the threshold.
    SyncSettingsResponse:
      properties:
        enabled:
          type: boolean
          title: Enabled
        interval_minutes:
          type: integer
          title: Interval Minutes
        bucket:
          anyOf:
          - type: string
          - type: 'null'
          title: Bucket
      type: object
      required:
      - enabled
      - interval_minutes
      - bucket
      title: SyncSettingsResponse
      description: Cloud sync configuration section.
    SynthesisConfirmRequest:
      properties:
        title:
          type: string
          minLength: 1
          title: Title
        draft_content:
          type: string
          title: Draft Content
        article_ids:
          items:
            type: string
          type: array
          minItems: 2
          title: Article Ids
      type: object
      required:
      - title
      - draft_content
      - article_ids
      title: SynthesisConfirmRequest
      description: Request to save a confirmed synthesis draft as a real article.
    SynthesisConfirmResponse:
      properties:
        id:
          type: string
          title: Id
        slug:
          type: string
          title: Slug
        title:
          type: string
          title: Title
        summary:
          type: string
          title: Summary
        themes:
          items:
            type: string
          type: array
          title: Themes
        source_count:
          type: integer
          title: Source Count
        source_article_ids:
          items:
            type: string
          type: array
          title: Source Article Ids
        created_at:
          type: string
          format: date-time
          title: Created At
        page_type:
          $ref: '#/components/schemas/PageType'
          default: synthesis
      type: object
      required:
      - id
      - slug
      - title
      - summary
      - themes
      - source_count
      - source_article_ids
      - created_at
      title: SynthesisConfirmResponse
      description: Response after confirming and saving a synthesis article.
    SynthesisPreviewRequest:
      properties:
        article_ids:
          items:
            type: string
          type: array
          minItems: 2
          title: Article Ids
        synthesis_type:
          anyOf:
          - type: string
          - type: 'null'
          title: Synthesis Type
        guidance:
          anyOf:
          - type: string
          - type: 'null'
          title: Guidance
      type: object
      required:
      - article_ids
      title: SynthesisPreviewRequest
      description: Request to generate a synthesis draft without saving it.
    SynthesisPreviewResponse:
      properties:
        draft_content:
          type: string
          title: Draft Content
        suggested_title:
          type: string
          title: Suggested Title
        summary:
          type: string
          title: Summary
        themes:
          items:
            type: string
          type: array
          title: Themes
        article_ids:
          items:
            type: string
          type: array
          title: Article Ids
        source_count:
          type: integer
          title: Source Count
      type: object
      required:
      - draft_content
      - suggested_title
      - summary
      - themes
      - article_ids
      - source_count
      title: SynthesisPreviewResponse
      description: Draft synthesis content returned for preview (not yet persisted).
    SynthesisRefineRequest:
      properties:
        draft_content:
          type: string
          title: Draft Content
        article_ids:
          items:
            type: string
          type: array
          minItems: 2
          title: Article Ids
        guidance:
          type: string
          title: Guidance
      type: object
      required:
      - draft_content
      - article_ids
      - guidance
      title: SynthesisRefineRequest
      description: Request to refine a previous synthesis draft with user feedback.
    SynthesisRefineResponse:
      properties:
        draft_content:
          type: string
          title: Draft Content
        suggested_title:
          type: string
          title: Suggested Title
        summary:
          type: string
          title: Summary
        themes:
          items:
            type: string
          type: array
          title: Themes
        article_ids:
          items:
            type: string
          type: array
          title: Article Ids
        source_count:
          type: integer
          title: Source Count
      type: object
      required:
      - draft_content
      - suggested_title
      - summary
      - themes
      - article_ids
      - source_count
      title: SynthesisRefineResponse
      description: Refined draft synthesis content.
    SynthesisResponse:
      properties:
        id:
          type: string
          title: Id
        slug:
          type: string
          title: Slug
        title:
          type: string
          title: Title
        query:
          type: string
          title: Query
        summary:
          type: string
          title: Summary
        themes:
          items:
            type: string
          type: array
          title: Themes
        source_count:
          type: integer
          title: Source Count
        source_article_ids:
          items:
            type: string
          type: array
          title: Source Article Ids
        created_at:
          type: string
          format: date-time
          title: Created At
        page_type:
          $ref: '#/components/schemas/PageType'
          default: synthesis
      type: object
      required:
      - id
      - slug
      - title
      - query
      - summary
      - themes
      - source_count
      - source_article_ids
      - created_at
      title: SynthesisResponse
      description: Response after creating a synthesis page.
    SynthesisSuggestion:
      properties:
        article_ids:
          items:
            type: string
          type: array
          title: Article Ids
        article_titles:
          items:
            type: string
          type: array
          title: Article Titles
        reason:
          type: string
          title: Reason
        suggested_type:
          type: string
          title: Suggested Type
      type: object
      required:
      - article_ids
      - article_titles
      - reason
      - suggested_type
      title: SynthesisSuggestion
      description: A suggestion for a synthesis opportunity across related articles.
    SystemStats:
      properties:
        total_users:
          type: integer
          title: Total Users
          default: 0
        total_sources:
          type: integer
          title: Total Sources
          default: 0
        total_articles:
          type: integer
          title: Total Articles
          default: 0
        total_compiled_claims:
          type: integer
          title: Total Compiled Claims
          default: 0
        article_count:
          type: integer
          title: Article Count
          default: 0
        source_count:
          type: integer
          title: Source Count
          default: 0
        concept_count:
          type: integer
          title: Concept Count
          default: 0
        backlink_count:
          type: integer
          title: Backlink Count
          default: 0
        orphan_count:
          type: integer
          title: Orphan Count
          default: 0
        conversation_count:
          type: integer
          title: Conversation Count
          default: 0
        articles_by_type:
          additionalProperties:
            type: integer
          type: object
          title: Articles By Type
          default: {}
        articles_by_page_type:
          additionalProperties:
            type: integer
          type: object
          title: Articles By Page Type
          default: {}
        articles_by_confidence:
          additionalProperties:
            type: integer
          type: object
          title: Articles By Confidence
          default: {}
        sources_by_type:
          additionalProperties:
            type: integer
          type: object
          title: Sources By Type
          default: {}
        sources_by_status:
          additionalProperties:
            type: integer
          type: object
          title: Sources By Status
          default: {}
        sources_stuck_processing:
          items:
            $ref: '#/components/schemas/StuckSource'
          type: array
          title: Sources Stuck Processing
          default: []
        stuck_sources:
          type: integer
          title: Stuck Sources
          default: 0
        compilation_queue_depth:
          type: integer
          title: Compilation Queue Depth
          default: 0
        compilation_success_rate:
          anyOf:
          - type: number
          - type: 'null'
          title: Compilation Success Rate
        avg_compilation_time_ms:
          anyOf:
          - type: number
          - type: 'null'
          title: Avg Compilation Time Ms
        last_compilation_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Last Compilation At
      type: object
      title: SystemStats
      description: Aggregate system-wide statistics (admin dashboard).
    TagArticleRequest:
      properties:
        tag_id:
          type: string
          title: Tag Id
      type: object
      required:
      - tag_id
      title: TagArticleRequest
      description: Request to tag an article.
    TagResponse:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        color:
          type: string
          title: Color
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
      - id
      - name
      - color
      - created_at
      title: TagResponse
      description: API response for a user tag.
    TokenCreateRequest:
      properties:
        name:
          type: string
          title: Name
        expires_in_days:
          type: integer
          maximum: 365.0
          minimum: 1.0
          title: Expires In Days
          default: 30
      type: object
      required:
      - name
      title: TokenCreateRequest
      description: Request to create a long-lived API token.
    TokenCreateResponse:
      properties:
        access_token:
          type: string
          title: Access Token
        token_type:
          type: string
          title: Token Type
          default: bearer
        expires_at:
          type: string
          title: Expires At
        name:
          type: string
          title: Name
      type: object
      required:
      - access_token
      - expires_at
      - name
      title: TokenCreateResponse
      description: Response after creating a long-lived API token (shown only once).
    TurnSelection:
      properties:
        conversation_id:
          type: string
          title: Conversation Id
        turn_indices:
          items:
            type: integer
          type: array
          title: Turn Indices
      type: object
      required:
      - conversation_id
      - turn_indices
      title: TurnSelection
      description: A selection of specific turns from a single conversation.
    UpdateCompilationSchemaRequest:
      properties:
        name:
          anyOf:
          - type: string
            maxLength: 200
            minLength: 1
          - type: 'null'
          title: Name
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        is_active:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Is Active
        article_max_length:
          anyOf:
          - type: integer
            maximum: 50000.0
            minimum: 100.0
          - type: 'null'
          title: Article Max Length
        required_sections:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Required Sections
        style:
          anyOf:
          - type: string
            maxLength: 500
          - type: 'null'
          title: Style
        focus:
          anyOf:
          - type: string
            maxLength: 500
          - type: 'null'
          title: Focus
        concept_max_depth:
          anyOf:
          - type: integer
            maximum: 10.0
            minimum: 1.0
          - type: 'null'
          title: Concept Max Depth
        concept_naming:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          title: Concept Naming
        extraction_always_note:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Extraction Always Note
        extraction_ignore:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Extraction Ignore
        custom_directives:
          anyOf:
          - type: string
            maxLength: 2000
          - type: 'null'
          title: Custom Directives
      type: object
      title: UpdateCompilationSchemaRequest
      description: Request to update a compilation schema.
    UsageResponse:
      properties:
        plan_name:
          type: string
          title: Plan Name
        plan_display_name:
          type: string
          title: Plan Display Name
        sources:
          type: integer
          title: Sources
        sources_limit:
          anyOf:
          - type: integer
          - type: 'null'
          title: Sources Limit
        articles:
          type: integer
          title: Articles
        articles_limit:
          anyOf:
          - type: integer
          - type: 'null'
          title: Articles Limit
        storage_bytes:
          type: integer
          title: Storage Bytes
        storage_limit:
          anyOf:
          - type: integer
          - type: 'null'
          title: Storage Limit
        queries_today:
          type: integer
          title: Queries Today
        queries_limit:
          anyOf:
          - type: integer
          - type: 'null'
          title: Queries Limit
        active_shares:
          type: integer
          title: Active Shares
        shares_limit:
          anyOf:
          - type: integer
          - type: 'null'
          title: Shares Limit
        llm_spend_cents_today:
          type: integer
          title: Llm Spend Cents Today
        llm_spend_limit:
          anyOf:
          - type: integer
          - type: 'null'
          title: Llm Spend Limit
      type: object
      required:
      - plan_name
      - plan_display_name
      - sources
      - sources_limit
      - articles
      - articles_limit
      - storage_bytes
      - storage_limit
      - queries_today
      - queries_limit
      - active_shares
      - shares_limit
      - llm_spend_cents_today
      - llm_spend_limit
      title: UsageResponse
      description: Current resource usage vs plan limits.
    UserProfileResponse:
      properties:
        id:
          type: string
          title: Id
        email:
          anyOf:
          - type: string
          - type: 'null'
          title: Email
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
        avatar_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Avatar Url
      type: object
      required:
      - id
      title: UserProfileResponse
      description: Public user profile returned by GET /auth/me.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    WikiExportFormat:
      type: string
      enum:
      - obsidian
      - markdown_json
      title: WikiExportFormat
      description: Supported full-wiki export formats.
    WikiWorthinessScore:
      properties:
        word_count:
          type: integer
          title: Word Count
        source_count:
          type: integer
          title: Source Count
        synthesizes:
          type: boolean
          title: Synthesizes
        dedup_collision:
          type: boolean
          title: Dedup Collision
        passed:
          type: boolean
          title: Passed
        auto_filed:
          type: boolean
          title: Auto Filed
          default: false
      type: object
      required:
      - word_count
      - source_count
      - synthesizes
      - dedup_collision
      - passed
      title: WikiWorthinessScore
      description: 'Score describing whether a Q&A answer is worth filing back as
        a wiki page.


        Produced by the Q&A agent''s auto file-back scorer. ``passed`` is the

        overall verdict; ``auto_filed`` records whether a wiki article was

        actually created as a result of this score.'
    WikilinkMatch:
      properties:
        id:
          type: string
          title: Id
        slug:
          type: string
          title: Slug
        title:
          type: string
          title: Title
        is_stub:
          type: boolean
          title: Is Stub
          default: false
      type: object
      required:
      - id
      - slug
      - title
      title: WikilinkMatch
      description: A single article match for wikilink resolution autocomplete.
tags:
- name: Wiki
  description: Browse wiki articles, knowledge graph, and search
- name: Ingest
  description: Ingest sources (URLs, PDFs, text, YouTube)
- name: Capture
  description: Ambient capture inbox and RSS feeds
- name: Query
  description: Ask questions against the wiki
- name: Jobs
  description: Manage async compilation and linting jobs
- name: Lint
  description: Wiki health audit reports and findings
- name: Settings
  description: LLM provider configuration and cost tracking
- name: Admin
  description: System diagnostics and maintenance
- name: Auth
  description: OAuth2 authentication
- name: Export
  description: Export wiki articles as PDF, LinkedIn, or slides
- name: Tags
  description: User-created organizational tags
- name: SavedSearches
  description: Saved searches with tag and concept filters
- name: Sharing
  description: Per-article share links and public access
- name: Synthesis
  description: Cross-cutting synthesis pages across multiple sources
- name: CompilationSchemas
  description: User-defined compilation rules for wiki articles
- name: Billing
  description: Subscription plans, usage quotas, checkout, and webhooks
- name: WebSocket
  description: Real-time progress streams