Skip to content

Refresh README with real screenshots; brand the app as Docket - #3

Merged
adityam23 merged 1 commit into
mainfrom
readme-refresh
Oct 13, 2026
Merged

adityam23 merged 1 commit into
mainfrom
readme-refresh

Conversation

@adityam23

Copy link
Copy Markdown
Owner

What

  • README rewritten for people rather than agents: what Docket is, a Mermaid "how it works" diagram, getting started, CLI usage, and four screenshots of the real app (Ask, Home, Filings, Observability). Benchmarks removed.
  • Branding: the header, tab title, desktop window and product name now read Docket (the header said "agent·assistant"). The outdated "agentic document engine" / "RAG engine" taglines are replaced in the CLI help, page meta, pyproject.toml and the API title. The package name, the dk command and the app identifier are unchanged.
  • Answer formatting: answers were printed as raw markdown (##, **, pipe tables). They now go through one shared renderer (lib/markdown.js + Answer.svelte), used by both the Ask page and the chat permalink. All model text is HTML-escaped before a fixed set of tags is applied, so model output can't inject markup. The duplicated .cite-pill style now lives once in app.css.

How the screenshots were made

Live app, run on a throwaway index with three real SEC 10-Ks (3M, AMD and American Express, 2022). The question and answer shown are real output from the local model. The images live in assets/screenshots/ because docs/ is gitignored.

Verification

  • uv run pytest: all pass, offline.
  • npm run build: clean.
  • Renderer checked against headings, bold text, quotes, tables, lists and an <img onerror> / <script> injection; everything came out escaped.

Known issues found along the way (not fixed here)

  • mettle returns no per-token logprobs, so every answer's reliability is unknown. The README avoids claiming confidence scores until that's fixed.
  • max_tokens=700 on the QA path (agent/graph.py:514) can cut long answers off mid-table.

… answer markdown

- README rewritten for humans: what Docket is, how it works (Mermaid),
  getting started, CLI usage, and screenshots of the live app over real
  SEC 10-Ks (assets/screenshots/; docs/ is local-only).
- Brand: header/tab/desktop window read "Docket" (was "agent·assistant");
  stale "agentic document engine" / "RAG engine" taglines replaced.
- Answers render markdown via one shared, escape-first renderer
  (lib/markdown.js + Answer.svelte) used by Ask and the chat permalink;
  the duplicated .cite-pill style is lifted into app.css.
@adityam23
adityam23 merged commit cd2de33 into main Oct 13, 2026
2 checks passed
@adityam23
adityam23 deleted the readme-refresh branch October 13, 2026 15:57
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.

1 participant