aaronsb_obsidian-mcp-plugin/docs
Aaron Bockelie 2be1998e12 docs(adr): ADR-203 — faithful-by-default content reads; concise tool results (#133)
Synthesizes #133's intent (machine-usable default for a machine protocol)
with the project instinct (concise formatted tool results, but unaltered
content for editing). Empirically grounded: default vault.read is lossy
(fragments + flattens newlines → broken read→edit round-trip), the raw
envelope double-encodes the body (~2x), and returnFullFile-without-raw
crashes the formatter.

Decision (two-bucket contract): content reads faithful/verbatim by default
(fragmentation = explicit opt-in via existing strategy/maxFragments);
action/result tools stay concise-formatted by default; stop double-encoding
the body; verbatim path must not route through the broken formatter.
#133's global-raw-flip remedy explicitly declined; its intent satisfied by
bucket 1. Status: Proposed (design of record; implementation tracked
separately, not in this ADR).
2026-05-19 00:14:29 -05:00
..
adr docs: Add ADR-003 for presentation facade pattern 2025-12-15 00:09:06 -06:00
architecture docs(adr): ADR-203 — faithful-by-default content reads; concise tool results (#133) 2026-05-19 00:14:29 -05:00
scripts chore: Add ADR tooling and ADR-100 (simplify connection setup) 2026-03-14 22:53:46 -05:00
tools docs: Simplify README with semantic value proposition focus 2025-08-31 00:54:07 -05:00
bases-implementation-fixes.md refactor: Reimplement Bases support with proper YAML and expression parsing 2025-08-19 22:48:51 -05:00
bases-implementation-status.md fix: Improve metadata cache integration for Bases frontmatter parsing 2025-08-19 23:04:06 -05:00
bases-implementation.md feat: Add Obsidian Bases support to MCP server 2025-08-19 22:21:09 -05:00
bases-mcp-reference.md refactor: Reimplement Bases support with proper YAML and expression parsing 2025-08-19 22:48:51 -05:00
graph-traversal.md feat: Add graph search traversal tool for semantic navigation 2025-06-29 18:20:44 -05:00
Plugin_UI_July_2025.png docs: Update plugin settings screenshot to show .mcpignore feature 2025-07-21 17:19:17 -05:00
PROJECT_STRUCTURE.md docs: Add comprehensive project documentation and security audit 2025-07-12 00:14:45 -05:00
SECURITY-IMPLEMENTATION.md feat: Implement comprehensive security architecture 2025-07-16 09:16:24 -05:00
troubleshooting.md security(docs): replace claude mcp add --header with safe config-file approach 2026-05-18 08:10:00 -05:00