Skip to content

feat: implement workspace insights and wiki links - #44

Open
the-long-ride wants to merge 114 commits into
mainfrom
feature/workspace-insights
Open

feat: implement workspace insights and wiki links#44
the-long-ride wants to merge 114 commits into
mainfrom
feature/workspace-insights

Conversation

@the-long-ride

@the-long-ride the-long-ride commented Aug 27, 2026

Copy link
Copy Markdown
Owner

Summary

  • Add Workspace Insights with Links, Graph, Related, Duplicates, Lint, and Gallery views.
  • Add workspace-aware wiki links/transclusion and shared navigation behavior.
  • Add Insights host support across Electron, VS Code, Chromium/web, and Tauri.
  • Add worker-backed local indexing, privacy-safe IndexedDB cache restore/validation, settings, translations, and cross-runtime contracts.

Cache and privacy

  • Restore only persistence-safe derived analysis as provisional state, then reread every eligible Markdown/MDX file from disk before treating it as authoritative.
  • Key cache data by normalized app-local workspace identity and invalidate incompatible analyzer/lint configurations.
  • Revalidate live disk analysis before persisting under a changed lint-analysis signature.
  • Never persist source bodies, readable section text/terminology, active unsaved overlays, external-link sessions, or private-origin approvals.
  • External link checks remain disabled by default and run only after explicit user action when enabled.

Verification

Exact head 42841a7381558503dc85368afebf52f409c06a34 passed workflow run #504 (33272202798):

  • Contracts, Node, update-contracts, and translations
  • UI: four sequential standard-forks Vitest shards, 3,112 tests passed total
  • Electron tests
  • VS Code and Chromium host tests/builds
  • Tauri tests on Ubuntu, macOS, and Windows
  • Tauri coverage threshold (85%)

The four UI shards intentionally preserve the normal Vitest runtime semantics while giving each shard a fresh heap.

@greptile-apps

greptile-apps Bot commented Aug 27, 2026

Copy link
Copy Markdown

Greptile Summary

This PR specifies the architecture and implementation plan for Workspace Insights and Wiki Links, then establishes the initial shared contracts, configuration, path matching, YAML frontmatter parsing, and anchor generation primitives.

  • Defines offline-first indexing, runtime host capabilities, secure external-link checking, persistence, and UI behavior.
  • Adds normalized Insights settings and host-facing domain contracts.
  • Introduces gitignore-style path matching with hard exclusions and ordered overrides.
  • Replaces scalar-only frontmatter handling with YAML parsing and source mapping.
  • Shares heading-ID allocation between rendering and document anchor indexing.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename Overview
docs/workspace-insights-design.md Defines the approved cross-runtime Workspace Insights and Wiki Links architecture, including metadata-only resource probes and reliable host-backed external checks.
docs/superpowers/plans/2026-08-27-workspace-insights-wiki-links.md Breaks the design into staged implementation and verification tasks across shared UI modules and runtime hosts.
ui/src/insights/contracts.ts Adds shared scan, source-read, resource-probe, filesystem-delta, capability, and external-link result contracts.
ui/src/insights/config.ts Adds Insights defaults and normalization for limits, external checks, graph sizing, cache capacity, relationships, and lint settings.
ui/src/insights/patterns.ts Implements ordered gitignore-style exclusions, user overrides, and non-overridable internal-path exclusions.
ui/src/markdown/frontmatter.ts Adds YAML frontmatter parsing, typed Insights metadata, diagnostics, and body-to-source mappings.
ui/src/markdown/anchors.ts Centralizes duplicate-aware heading IDs and static HTML anchor extraction for renderer and analysis consistency.
ui/src/markdown/renderer.ts Refactors rendering to use the shared heading-ID allocator without changing intended anchor semantics.
ui/src/markdown/sourceMapping.ts Delegates frontmatter extraction to the shared YAML-aware parser while retaining the existing compatibility interface.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  Host[Runtime host capabilities] --> Session[Insights session coordinator]
  Session --> Worker[Insights worker and index]
  Markdown[Shared Markdown parser] --> Worker
  Markdown --> Renderer[Renderer and Wiki navigation]
  Frontmatter[YAML frontmatter metadata] --> Markdown
  Anchors[Shared anchor allocator] --> Renderer
  Anchors --> Worker
  Patterns[Path exclusion matcher] --> Host
  Worker --> Views[Gallery, Links, Lint, Duplicates, Graph, Related]
Loading

Reviews (10): Last reviewed commit: "feat: share markdown metadata and anchor..." | Re-trigger Greptile

Comment thread docs/workspace-insights-design.md Outdated
Comment thread docs/workspace-insights-design.md Outdated
@the-long-ride
the-long-ride force-pushed the feature/workspace-insights branch 2 times, most recently from 7ef2d82 to c9a883f Compare August 28, 2026 06:09
@the-long-ride
the-long-ride force-pushed the feature/workspace-insights branch from c9a883f to c9f64ab Compare August 28, 2026 06:12

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the-long-ride has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the-long-ride has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the-long-ride has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the-long-ride has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the-long-ride has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.

@the-long-ride
the-long-ride force-pushed the feature/workspace-insights branch from fc031d6 to 1fa91bc Compare August 28, 2026 06:48

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the-long-ride has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the-long-ride has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the-long-ride has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.

@the-long-ride
the-long-ride force-pushed the feature/workspace-insights branch from f54e292 to a18956e Compare August 28, 2026 06:59

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the-long-ride has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the-long-ride has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the-long-ride has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.

@the-long-ride the-long-ride changed the title docs: design workspace insights feat: implement workspace insights and wiki links Aug 29, 2026
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