Skip to content

AI: Powered Document (standalone / from list / from document / research URL) #9

Closed

Description

@Adron

Part of #3 — AI Writing Assistance is entirely missing from the Android app

Web behaviour: a Powered Document button on the Documents page drafts a full document
in one of four modes:

  1. Standalone article from a topic the user describes.
  2. Derived From List — a write-up based on one of the user's lists.
  3. Derived From Article — a new document based on an existing one.
  4. Research URL — a document based on a web page the user points at.

For the derived and research modes the user picks the source list / document / URL. The draft is
always previewed before it is saved.

  • Source pickers should reuse the existing lists and documents pickers rather than new ones.
  • POST /api/ai/suggest → preview; POST /api/ai/generate → saved document.

Tests: one ViewModel test per mode (source selection → suggest → confirm); preview is not
persisted if the user backs out.


Filed from the parity review of feature/parity-wip @ 14d7795 against interlinedlist.com (OpenAPI /api/openapi.json, 233 paths) and the public help centre.

Activity

  1. added
    parityClosing a gap against interlinedlist.com
    P1Big hole in a shipped feature
    area:aiAI writing assistance
    on Sep 15, 2026
  2. Adron commented on Sep 16, 2026

    @Adron
    MemberAuthor

    Implemented in the PR above (branch issue/9-ai-powered-document). Closing here — review and any follow-up happens on the PR.

    One architectural decision needs your ruling, and it is better settled now than after four more AI issues: this PR introduces the repo's first feature→feature dependency, :feature:documents → :feature:ai. There is no way to consume #4's AiRepository/AiGate/ConfirmedPreview without it.

    The case for it: :feature:ai is a leaf capability module — only :core:* dependencies, no navigation, no screens — and #4 built it explicitly to be consumed. The case against: the no-feature→feature convention is what has kept the parallel work conflict-free.

    If you would rather it were :core:ai, say so and I will move it before #5, #6, #7 and #8 each add the same edge.

    On the issue itself: the four modes are sent as context.mode (article / from_list / from_article / research_url) and only a reference is ever sent — the server resolves the source. Backing out of a preview is structurally incapable of writing, since /generate only accepts a ConfirmedPreview that an on-screen preview must mint.

    The list source picker does not import :feature:lists; :feature:documents owns a one-endpoint read-only /api/lists client instead — so no documents→lists edge was created.

  3. added a commit that references this issue on Sep 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    P1Big hole in a shipped featurearea:aiAI writing assistancearea:documentsDocumentsparityClosing a gap against interlinedlist.com

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions