4 commits

Author	SHA1	Message	Date
mpstaton	f946973894	feat(release): 0.3.0 — three analyst-grade templates for VC/PE/equities + four infrastructure fixes for deep-research reliability ... 0.3.0 turns Perplexed into a serious analyst tooling layer for Venture Capital, Private Equity, and equities-trading workflows. Three new directory templates produce 6-9K-word cited analyst drafts in a single Perplexity Deep Research run. Underneath them, four infrastructure fixes turn deep-research from a brittle "might work" workflow into something you can put real analyst time behind. The three new templates: market-map-profile (analyst memo for Known Category or Thesis-Driven maps), standards-and-specs-profile (open-spec profiles with five-way authority typing and three-tier adoption framing), market-category-profile (concept-folder reference card with three financial-stage tiers — Incumbents / Challengers / Innovators). The four infrastructure fixes: per-template request-timeout-ms wall-clock override (yesterday, pressure-relief valve), structural port of per-chunk idle-timeout discipline from the legacy modal flow into the directory-template flow (yesterday, structural fix), per-template max-tokens Perplexity output-budget override (today, fixes silent clean-truncation when finish_reason=length fires mid-template), and a strengthened mermaid-discipline partial plus new latex-discipline partial (today, fixes the 4-of-5 broken-Mermaid rate via paired BAD/GOOD examples and a six-item pre-emit self-check). New templates (src/docs/templates/): - market-map-profile.md — sonar-deep-research, request-timeout-ms 2400000 (40-min ceiling), max-tokens 24000. Anti-incumbent editorial stance. - standards-and-specs-profile.md — sonar-deep-research, request-timeout-ms 0 (idle-only safety), max-tokens 24000. Five-way authority typing, named editors, stewardship transitions, named critics. - market-category-profile.md — sonar-deep-research, request-timeout-ms 0, max-tokens 24000. Three-tier financial-stage framing, separate Why Now and What's Happening sections, Industry Coverage sub-grouped into Market Reports / Industry Articles / Financial News. Rendering-discipline partials (src/docs/partials/): - mermaid-discipline.md rewritten — paired BAD/GOOD examples throughout, the &amp; escape rule, explicit \n vs <br/> ban, six-item self-check before emit, simplify-rather-than-break ethos. Original ~250 tokens expanded to ~440. - latex-discipline.md new — Obsidian MathJax delimiters and \$ escaping in prose to avoid accidental inline-math spans. - concept-profile.md wired in {{include: latex-discipline}} alongside the existing {{include: mermaid-discipline}}, placed immediately after the "render a mermaid codefence here" instruction so the rules are in scope at the moment of generation. Streaming, timeout, and output-budget infrastructure (src/services/ directoryTemplateService.ts): - streamPerplexityToFile now races each reader.read() against a fresh per-chunk idle timer (270s deep-research, 90s normal — matches the legacy modal flow at perplexityService.ts:659). Closes the "Wall-clock-timeout cuts off long deep-research streams" issue. - request-timeout-ms cft override is now the optional absolute wall-clock ceiling (belt-and-suspenders backstop on top of the idle timer); explicit 0 disables. - max-tokens cft override added to buildPayload — passes through to Perplexity's max_tokens parameter; lifts the silent ~8K-token default ceiling that was clean-truncating thorough drafts via finish_reason: length. Documentation (README.md, docs/directory-templates.md): - README — new top-level section "For Venture Capital, Private Equity, and Equities-Trading Workflows" with a five-row table mapping each analyst workflow to the template that produces it. Directory Templates section updated to seven shipped templates plus the new per-template cft-block knobs. - docs/directory-templates.md — new "Per-template max-tokens override" section with the diagnostic table for distinguishing wall-clock-timeout truncation (mid-sentence cutoff, no sources footer) from max_tokens truncation (clean section-end, full sources footer). The diagnostic vocabulary that did not exist before this release. Seeding (src/services/templateSeederService.ts): - Registered all three new templates plus the new latex-discipline partial so they auto-seed into vaults on first plugin load and appear in Re-seed runs. Version bump (manifest.json, package.json, versions.json): - 0.2.1 to 0.3.0. minAppVersion unchanged at 1.8.10. Engineering changelog entries (changelog/): - 2026-05-26_02.md — the structural idle-timeout port. - 2026-05-27_01.md — the two new templates, max-tokens override, and rendering-discipline partial work. Includes the diagnostic-led narrative on the vault-drift bug that caused the 4-of-5 broken-Mermaid rate. Release narratives: - changelog/releases/0.3.0.md — full marketing-quality release narrative with frontmatter, four-audience cascade, three diagnostic-led stories (streaming-timeout, max_tokens, rendering-discipline), explicit upgrade notes including the vault-drift warning, three deferred items for 0.4.x. - release-notes/0.3.0.md — prose-only release-page body picked up by the release.yml workflow when the 0.3.0 tag is pushed. Tighter cut of the same narrative, suited for the GitHub release page. Context-v stamp: - context-v/issues/Wall-Clock-Timeout-Cuts-Off-Long-Deep-Research-Streams.md marked status: resolved, date_resolved 2026-05-26, with the four open items reorganized into "what landed" (3 of 4) and "deferred follow-ups" (cross-service audit, settings-pane exposure, deep-research detection robustness). Files changed: - manifest.json, package.json, versions.json - README.md, docs/directory-templates.md - src/services/directoryTemplateService.ts - src/services/templateSeederService.ts - src/docs/templates/README.md - src/docs/templates/concept-profile.md - src/docs/templates/market-map-profile.md - src/docs/templates/market-category-profile.md (new) - src/docs/templates/standards-and-specs-profile.md (new) - src/docs/partials/mermaid-discipline.md - src/docs/partials/latex-discipline.md (new) - changelog/2026-05-26_02.md (new) - changelog/2026-05-27_01.md (new) - changelog/releases/0.3.0.md (new) - release-notes/0.3.0.md (new) - context-v/issues/Wall-Clock-Timeout-Cuts-Off-Long-Deep-Research-Streams.md Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-27 17:41:13 -05:00
mpstaton	3ae4012f1f	feat(release): 0.2.1 — deep research that actually keeps the research ... Directory-template runs with sonar-deep-research were silently discarding ~99% of every response. Perplexity's deep-research model delivers its whole finished document in the first SSE event's message.content; the streaming reader took delta.content (correct for the token-streaming sonar models) and captured only a ~75-character tail fragment of a ~10,000-character report. toolkit-profile shipped with sonar-deep-research as its default model, so the default was the broken one. This release fixes the streaming, hardens it against mid-stream disconnects, and adds the tooling the directory-template research workflow was missing. Both streaming paths now read Perplexity's cumulative message.content snapshot and append only the new tail — correct for token-streaming sonar models and for deep research's first-event document dump alike. A timed-out or dropped stream now keeps the partial content and the citations it already received instead of discarding the whole run. "Apply directory template" gained a run dialog with a per-run model selector, so the model is no longer locked to the template file, and the loading notice names the model that is actually running instead of a hardcoded "deep research" string. Streaming (perplexityService.ts, directoryTemplateService.ts): - Read message.content (cumulative snapshot), diff against written text, append the tail; a startsWith guard skips a changed prefix rather than corrupting the note. - streamPerplexityToFile returns a partial result with a `truncated` flag on a read error instead of throwing; applyTemplate writes the partial with its sources footer and a truncation notice. The modal catch block salvages its citation metadata the same way. - Deep-research idle timeout 90s -> 270s; request-timeout default 5 -> 10 min. Model selection (DirectoryTemplateRunModal.ts, main.ts): - New run dialog: a template dropdown plus a Perplexity model dropdown that defaults to the template's cft model and overrides it for that run only. - cf_last_run_model now stamps the model that actually ran. Search scoping (directoryTemplateService.ts): - search_domain_filter support via cf_search_domains (target frontmatter) and search-domains (cft block); allow/deny entries, capped at 10; job boards are denied automatically. Template (src/docs/templates/toolkit-profile.md): - System prompt rebuilt: anchors the entity on its real name rather than the scraped marketing tagline, makes source quality a triage task instead of an allow/deny list, adds a search-don't-recall rule and per-section length ceilings. Default model -> sonar-pro. Files changed: - src/services/perplexityService.ts - src/services/directoryTemplateService.ts - src/modals/DirectoryTemplateRunModal.ts - main.ts - src/docs/templates/toolkit-profile.md - manifest.json - package.json - versions.json - changelog/releases/0.2.1.md - release-notes/0.2.1.md Also included: - manifest.json description aligned with package.json ("Perplexica (now Vane)"). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-22 15:28:53 -05:00
mpstaton	160abebaa3	docs(release-notes): 0.2.0 — release-page body for the auto-release workflow ... Workflow .github/workflows/release.yml looks for release-notes/<tag>.md at the tagged commit; without this file it falls back to --generate-notes, which produces a flat commit list instead of the marketing-shape body. Mirrors the convention introduced in release-notes/0.1.2.md. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-20 01:51:14 -05:00
mpstaton	b1ff11c687	chore(release): 0.1.2 — workflow-driven releases + artifact attestations + package.json description alignment ... Three things bundled: 1. Release workflow at .github/workflows/release.yml fires on every 3-digit-semver tag push. Builds main.js + styles.css in a clean Ubuntu runner, signs all three release assets via actions/attest-build-provenance@v1 (sigstore-backed via OIDC), creates the GitHub Release with notes pulled from release-notes/<tag>.md. Identical to the workflow landing across cite-wide, image-gin, metafetch as a family-wide pattern. 2. release-notes/0.1.2.md authored in marketing-shape per content-farm/context-v/skills/changelog-conventions/SKILL.md "These are marketing artifacts" section. 3. package.json description aligned with manifest.json. Previous package.json text "A plugin for Obsidian that allows you to generate source-cited content..." still contained the bot-flagged "Obsidian" + self-reference patterns that we'd already fixed in manifest.json; this synchronises the two so anything reading from npm-style metadata gets the same active-voice description users see in the directory listing. Version bumped 0.1.1 → 0.1.2 across manifest.json / package.json / versions.json. No source-code changes — Directory Templates, the four shipped templates, the first-run seeder, the Claude integration, the wide modals all behave identically to 0.1.1. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-18 03:11:03 -05:00