Skip to content

feat: make X Articles first-class resources - #57

Open
robertn702 wants to merge 5 commits into
tamnd:mainfrom
robertn702:feat/x-articles
Open

robertn702 wants to merge 5 commits into
tamnd:mainfrom
robertn702:feat/x-articles

Conversation

@robertn702

@robertn702 robertn702 commented Sep 26, 2026 •

Copy link
Copy Markdown

What changed

Make X Articles first-class resources across the CLI and its read surfaces:

  • x article <article-id-or-url> reads a long-form Article as its own record, with title, full body, structured content_state, cover, inline media, author, and linking post.
  • x get <article-url> dispatches to Article; x classify, x uri, and x url recognize x://article/<id> and https://x.com/i/article/<id>. A bare numeric x get <id> remains a tweet lookup.
  • Article identity and metadata flow through fields, rows, graph/edges, RDF, and the registered MCP/serve operations. Tweet and thread reads still expose linked Article data.

For non-owner sessions, Article-by-ID resolution uses exact signed-in URL search to find a post containing the Article, checks the embedded Article ID, and retrieves that post through TweetDetail for the full body. It rechecks the Article ID before returning it. This is not a direct Article entity API: no search hit means no discoverable linking post, not proof that an Article doesn't exist. Explicit guest/public tiers do not escalate to session access.

Closes #56

Verification

  • go test -race -count=1 ./...; go vet ./...; git diff --check
  • Live signed-in reads of Leo's Article 2103118352554344448 using the Article URL and bare Article ID; Article URL via x get; classification, fields, and graph. The response included title, full body, author, linking post, cover, and eight inline media entries.
  • Exact URL search located linking posts for two distinct Articles. Synthetic tests cover lookup ID matching, missing session and no-hit behavior, explicit guest tier, identity, CLI registration, graph/RDF media relationships, and session-tier tweet/thread parsing.

@robertn702 robertn702 changed the title feat: read X Articles linked from tweets feat: make X Articles first-class resources Sep 26, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Support X Articles as first-class read resources

1 participant