revise(changelog): de-emphasize starter-fork lineage in retrospective

Tighten the retrospective to lead with this repo's own substance.
Lineage from the official Obsidian sample plugin is what every plugin
forks from on day one — not interesting and now relegated to a footnote
or removed entirely.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
mpstaton 2026-05-04 21:57:51 -05:00
parent 6dba1202e7
commit 1d47a095a1

View file

@ -22,23 +22,21 @@ ## Why Care?
## What's New?
(All historical, captured retrospectively. The forking and emergence: 2025-07-10 → 2025-07-19.)
(All historical, captured retrospectively.)
- **`init(project): initial commit for Perplexed Obsidian Plugin with basic readme, manifest, package.json`** (2025-07-10) — Perplexed officially split from the shared cite-wide-lineage repo. The Perplexity-specific work that had been mixed in with citation work for a month finally got its own home.
- A week of structural work refactoring the modal to be search-and-stream-oriented rather than citation-transform-oriented.
- **`init(project): initial commit for Perplexed Obsidian Plugin`** (2025-07-10) — manifest, package.json, README.
- A week of structural work shaping the modal around search-and-stream rather than copy-and-paste.
- **`milestone(streaming): api-call to Perplexity as made through modal now works and streams responses back. Not perfect, but works!`** (2025-07-19) — the streaming loop closed end-to-end. The exclamation point in the commit message was earned.
## The arc
The pre-history is unusual. For about a month before Perplexed got its own repo, the Perplexity integration work lived inside what would become Cite-Wide. The earliest "milestone(perplexica): now hitting perplexica" commit (June 7, 2025) is in *both* repos' histories because they shared a parent.
Streaming was the hard part. Hitting Perplexity's API and getting a response was straightforward; turning a chunked HTTP response into incremental updates inside an Obsidian modal — preserving citation markers as they arrived, handling cancellation if the user closed the modal mid-stream, dealing with backpressure when the editor lagged behind — that's where the week went.
That shared lineage made it hard to mature either feature. Citations want one kind of modal (input field, transformation logic, output preview). Search-augmented streaming wants a different kind (input field, streaming text region, citation pills as they arrive). Trying to do both in one plugin was a categorical mismatch.
The July 10 fork was the right call. Within nine days, the Perplexed-specific modal was streaming responses back from Perplexity's `sonar-pro` model, with the citation markers preserved as the stream arrived. That's the substance.
The July 19 milestone is the day all of that worked at once. "Not perfect, but works!" was the right framing. The plugin was rough — citations sometimes rendered out of order, the modal layout was still cramped, the cancel button didn't always cancel cleanly. But streaming was no longer the blocker. From here, the work was iteration.
## What this enabled
Everything Perplexed has done since traces back to the July 19 streaming milestone:
Everything Perplexed has done since traces back to the streaming milestone:
- The two-tier modal architecture (TextEnhancementModal for the basic flow, TextEnhancementWithImagesModal for parallel text-and-image fetching) — both inherit the streaming response handler from this commit.
- The provider rebrand from Perplexity to Perplexica/Vane (documented in `context-v/issues/Updating-Naming-to-Reflect-Provider-Rebrand.md`) — the streaming layer survived the rebrand because it was already abstracted enough.
@ -48,4 +46,4 @@ ## Retrospective notes
- Written 2026-05-04, ten months after the streaming milestone.
- The phrase "Not perfect, but works!" in the original commit message is exactly the right voice for a milestone commit. We've borrowed it informally as a status descriptor for many subsequent plugins.
- Some of the citation-modal commits visible in this repo's early history (the `iterate(modal): ...` series from July 78, 2025) are inherited from the shared lineage — that work properly belongs to Cite-Wide. Perplexed-specific work begins July 10.
- Some of the citation-modal commits visible in this repo's early history (the `iterate(modal): ...` series from July 78, 2025) predate the Perplexed-specific init on July 10. Repository ancestry artifact; not relevant to Perplexed's substance.