Obsidian Stats logoObsidian Stats

InsightMesh Viewer

by aucontraire
5
4
3
2
1
Score: 50/100
Install Code

Description

Read-only Obsidian viewer for InsightMesh provenance. See which conversation, checkpoint, and Editor decision produced each wiki page, with rationale rendering and snapshot diffs.

Reviews

No reviews yet.

Stats

0
stars
77
downloads
0
forks
78
days
78
days
78
days
8
total PRs
0
open PRs
0
closed PRs
8
merged PRs
0
total issues
0
open issues
0
closed issues
9
commits

Latest Version

0.3.0
3 months ago

Changelog

Structured, human-readable views for a checkpoint's source links. The Session log and Cursor links no longer open raw JSON; they open readable views, with a Show raw toggle still one click away.

What's new

Run log (the pipeline trace)

  • Open the Session log link to see the whole batch run: an overall status badge, when it ran and how long it took, the pages it created and updated (shown vault-relative), and any errors.
  • A per-agent record for Synthesis, Historian, and Editor, each with status and duration.
  • Drill into an agent to see what it produced, including work that did not land: Synthesis drafts (a short preview that expands to full markdown), Historian augmentations and recorded topics, and the Editor's decisions and results. This makes the "what ran versus what was committed" distinction visible.
  • Editor decisions render in the same form as the checkpoint detail.

Cursor (resume and coverage state)

  • Open the Cursor link to see its status, checkpoint number, last-updated time (relative), and the topics-covered digest as readable cards (what the pipeline considers already covered in the conversation).
  • Diagnostic fields stay tucked into a collapsible Details section or behind Show raw.

Show raw on every view

  • Toggle to the literal JSON at any time, and back. It is also the safe fallback when a file is partial or unexpected.

Notes

  • Both views render untrusted content safely (inert text or markdown via Obsidian's renderer) and degrade gracefully on malformed or partial files.
  • Strictly read-only, desktop, theme-respecting, as before.
  • These views support the insightmesh-core session-log and cursor shape as of core v0.5.0. These are informal artifacts, so a future core change to them may require a plugin update; the views fall back to Show raw when a field is missing or unexpected.

Install / update

  • BRAT: update aucontraire/insightmesh-obsidian to 0.3.0.
  • Or download main.js, manifest.json, and styles.css from the assets below into <vault>/.obsidian/plugins/insightmesh-viewer/.
See all version on GitHub

README file from

Github

InsightMesh Viewer

A read-only Obsidian plugin that visualizes the provenance behind the wiki pages produced by InsightMesh. For any generated page, it shows which conversations and checkpoints produced it, the decisions and rationale behind each edit, and how the page changed over time.

This is to InsightMesh's provenance data what a repository browser is to a git repo: the raw history lives underneath, and this plugin is the domain-aware layer on top. It never writes anything, runs entirely locally, and makes no network requests.

You generate the provenance data by running insightmesh-core over your AI chat transcripts. This plugin only reads and displays that data; it does not generate it. Without an InsightMesh history in your vault, there is nothing for the plugin to show.

Features

  • Provenance summary for the active page: latest action, confidence, total edits, contributing exchanges and conversations, and the latest checkpoint time.
  • Drift flag when the page's summary diverges from its latest checkpoint (for example, after a manual edit).
  • Readable checkpoint detail: each editor decision with its rationale rendered as markdown, confidence, action, exchanges, and signals, plus a friendly provider label (Claude, ChatGPT, or Local transcript) and the models used.
  • Checkpoint list: every checkpoint that touched the page, across all conversations, time-ordered.
  • Snapshot diff: a GitHub-style unified diff between the two most recent recorded versions of the page, with collapsed hunks and old/new line numbers.
  • Run log and cursor views: click a checkpoint's source links to open a structured run log (the pipeline trace of what each agent did during the batch, including drafts that did not land) and a readable cursor (status, checkpoint number, last-updated time, and the topics-covered digest), each with a Show raw toggle.

Screenshots

The provenance panel for the active page, with its contributing checkpoints:

A checkpoint rendered as a readable view: the decision, its rationale, the signals behind it, and links to the source:

A unified diff between two recorded versions of a page:

Requirements

  • Obsidian desktop, version 1.7.2 or later. This plugin is desktop only for v0.1.
  • A vault containing the InsightMesh history produced by insightmesh-core (the InsightMesh/.history/ folder), at schema version 1.
  • A git binary on your PATH (used read-only, for the snapshot diff only).

Install

Community plugins (recommended)

  1. In Obsidian, open Settings, then Community plugins.
  2. Select Browse, search for "InsightMesh Viewer", and Install.
  3. Enable "InsightMesh Viewer".

BRAT (for pre-release builds)

To track the latest build before it reaches the registry:

  1. Install BRAT from Community plugins.
  2. In BRAT settings, choose "Add Beta Plugin" and paste: aucontraire/insightmesh-obsidian
  3. Enable "InsightMesh Viewer".

Manual

  1. Download manifest.json, main.js, and styles.css from the latest release.
  2. Copy them into <vault>/.obsidian/plugins/insightmesh-viewer/.
  3. Reload Obsidian and enable "InsightMesh Viewer" in Community plugins.

Usage

  1. Open a vault that contains an InsightMesh/ folder with generated pages.
  2. Open the provenance panel: click the ribbon icon, or run the command "Open provenance view".
  3. Open any generated page that carries a provenance: frontmatter block. The panel shows the summary; use "Open latest checkpoint" or the checkpoint list for detail, and "Compare adjacent versions" for the diff.

Pages without a provenance: block show a clear empty state.

Read-only by design

The plugin never writes to, modifies, creates, deletes, stages, or commits any file in your vault or in the provenance history. There is no UI action anywhere that mutates anything.

The snapshot diff is the only feature that reaches outside the Vault API: it runs the system git binary to read two recorded revisions of a page from the shadow repository. The community plugin directory flags this as a shell-execution capability; in practice it is tightly bounded:

  • Read-only: only git log and git show run. Nothing is ever written, staged, or committed.
  • No shell: git is invoked directly with a fixed argument list (Node's execFile, not a shell command string), so the plugin cannot run arbitrary commands and there is no command-injection surface.
  • Desktop only and guarded: every call is behind a filesystem-adapter check, which is why the plugin is isDesktopOnly. If git is unavailable the diff degrades to a clear message and the rest of the plugin works normally.
  • Small by choice: bundling a JavaScript git implementation was rejected to keep the plugin lightweight.

The plugin makes no network requests and contains no telemetry. Everything it reads stays on your machine.

Compatibility

InsightMesh Viewer insightmesh-core schema_version
0.x 1

A future core schema change would trigger a coordinated plugin release.

The run-log and cursor views support the insightmesh-core session-log and cursor shape as of core v0.5.0. These are informal artifacts (the session log is unversioned), so a future core change to them may require a plugin update; the views parse defensively and fall back to Show raw when a field is missing or unexpected.

Settings

  • History location: vault-relative path to the provenance history (default InsightMesh/.history).
  • Diff display: show the snapshot diff inline in the panel or in a modal.

Troubleshooting

  • The panel is empty or missing: open it with the ribbon icon or the "Open provenance view" command. It opens as a tab in the right sidebar; it does not open automatically.
  • "No provenance for this page": the page was not generated by insightmesh-core, or its provenance: frontmatter block is absent. Open one of the generated pages under InsightMesh/.
  • "Nothing to compare yet": the page has only one recorded snapshot. The diff needs at least two committed revisions of the page in the shadow repository.
  • The diff reports git is unavailable: install git and make sure it is on your PATH. The diff is the only feature that needs it.
  • Wrong or missing data after moving the history: set the correct path in the plugin settings if your history is not at the default InsightMesh/.history.

Limitations and roadmap

The plugin is intentionally small. Known limitations and planned improvements:

  • Desktop only; mobile support is out of scope for now.
  • The run-log and cursor views consume informal core artifacts; if a future core version changes their shape, the structured view degrades to Show raw until the plugin is updated.
  • The drift flag reports divergence but does not offer to reconcile, by design (the plugin is read-only).
  • Planned for later versions: a cross-conversation timeline, filtering by confidence or action, and search across checkpoints.

Development

npm install
npm run dev     # watch-mode build
npm run build   # production build (typecheck + bundle)
npm run lint
npm test        # unit tests for the pure data layer

For live development, symlink this repo into a vault at <vault>/.obsidian/plugins/insightmesh-viewer/ and run npm run dev.

Acknowledgements

Thanks to obsidian-sample-plugin and obsidian-git for showing what good Obsidian plugin code looks like.

Contributing

Issues and feature requests are welcome at the issue tracker. Note that the provenance data format is owned by insightmesh-core, so a problem with the underlying data may belong in that project's tracker.

License

0BSD

Sponsors