test(e2e): add Obsidian runtime coverage

.gitignore

@@ -25,3 +25,6 @@ __snapshots__
 
 # Documentation build output
 docs/site
+
+# Obsidian E2E failure artifacts
+.obsidian-e2e-artifacts

README.md

@@ -31,6 +31,23 @@ Here are the features that will help you do that 👇.
 
 Other installation options can be found in the [documentation](https://chhoumann.github.io/PodNotes).
 
+## Development
+
+- `npm run test` runs the jsdom/unit test suite.
+- `npm run build` type-checks and bundles the plugin.
+- `npm run test:e2e` builds the plugin, then runs the local Obsidian-backed E2E suite.
+
+The E2E suite is local-only. It depends on Obsidian being installed, the
+`obsidian` CLI being available on `PATH`, and the target vault being open and
+reachable. The default target vault is `dev`; override it with
+`PODNOTES_E2E_VAULT` when needed. Failed E2E runs may write artifacts to
+`.obsidian-e2e-artifacts/`.
+
+Before running E2E, make sure the target vault's
+`.obsidian/plugins/podnotes/main.js` and `manifest.json` symlinks point at this
+checkout. The tests intentionally fail during preflight instead of relinking the
+vault automatically.
+
 ## Screenshots
 
 ### Demo

manifest.json

@@ -8,4 +8,4 @@
 	"authorUrl": "https://bagerbach.com",
 	"fundingUrl": "https://buymeacoffee.com/chhoumann",
 	"isDesktopOnly": false
-}
+}