From 942e01622b8ce6d48d485e3f164bac9f2b25f4ad Mon Sep 17 00:00:00 2001 From: Daniel <223140489+AgriciDaniel@users.noreply.github.com> Date: Wed, 8 Apr 2026 22:48:46 +0300 Subject: [PATCH] wiki: save v1.4 release session note Files the complete v1.1 to v1.4.1 release cycle as a session note in wiki/meta/. Documents everything shipped, all key lessons (plugin install syntax, allowed-tools frontmatter, Bases vs Dataview, PostCompact hook necessity, git filter-repo two-pass scrub), and the current plugin state. Updated: - wiki/meta/claude-obsidian-v1.4-release-session.md (NEW) - wiki/log.md (new entry at top) - wiki/hot.md (refreshed with current session context) - wiki/overview.md (page count 25 to 26) - wiki/index.md (page count 25 to 26) Co-Authored-By: Claude Opus 4.6 (1M context) --- wiki/hot.md | 74 +++-- wiki/index.md | 2 +- wiki/log.md | 8 +- .../claude-obsidian-v1.4-release-session.md | 278 ++++++++++++++++++ wiki/overview.md | 4 +- 5 files changed, 331 insertions(+), 35 deletions(-) create mode 100644 wiki/meta/claude-obsidian-v1.4-release-session.md diff --git a/wiki/hot.md b/wiki/hot.md index 7d2077b..86ecb42 100644 --- a/wiki/hot.md +++ b/wiki/hot.md @@ -1,7 +1,7 @@ --- type: meta title: "Hot Cache" -updated: 2026-04-08T12:00:00 +updated: 2026-04-08T19:00:00 tags: - meta - hot-cache @@ -11,46 +11,58 @@ related: - "[[log]]" - "[[Wiki Map]]" - "[[getting-started]]" + - "[[claude-obsidian-v1.4-release-session]]" --- # Recent Context Navigation: [[index]] | [[log]] | [[overview]] ---- - ## Last Updated -2026-04-08 — Ecosystem research ingest: 16+ Claude+Obsidian projects researched +2026-04-08: v1.4.1 hotfix shipped, plugin confirmed installed and enabled -## Key Recent Facts -- **Plugin**: claude-obsidian v1.2.0 | `~/claude-obsidian/` | push: `git push origin main && git push community main` -- **Install**: `claude plugin marketplace add AgriciDaniel/claude-obsidian` -- **Ecosystem research complete**: 16+ projects, 13 cherry-pick features identified +## Plugin State +- **Version**: 1.4.1 (installed, enabled, user scope) +- **Install ID**: `claude-obsidian@claude-obsidian-marketplace` +- **Releases**: v1.1, v1.4.0, v1.4.1 on GitHub +- **Skills**: 10 (wiki, wiki-ingest, wiki-query, wiki-lint, save, autoresearch, canvas, defuddle, obsidian-bases, obsidian-markdown) +- **Hooks**: 4 (SessionStart, PostCompact, PostToolUse, Stop) +- **Multi-agent**: bootstrap files for Codex, OpenCode, Gemini, Cursor, Windsurf, GitHub Copilot -## What Was Just Ingested -Full internet sweep of Claude + Obsidian projects. Key projects found: -- **kepano/obsidian-skills** — Obsidian creator's own skills (validates Agent Skills format) -- **Ar9av/obsidian-wiki** — delta tracking manifest + multi-agent compat (Cursor/Windsurf/Codex/Gemini) -- **ballred/obsidian-claude-pkm** — auto-commit PostToolUse hook + goal cascade -- **rvk7895/llm-knowledge-bases** — 3-depth query (Quick/Standard/Deep) + Marp output -- **heyitsnoah/claudesidian** — PARA vault + /init-bootstrap + vault import -- **YishenTu/claudian** — native Obsidian plugin with plan mode + @mention + word-level diff -- **ProfSynapse/nexus** (claudesidian-mcp) — native plugin + MCP bridge + workspace memory -- obsidian-copilot: 5,776⭐ | smart-connections: 4,357⭐ (traditional plugins) +## Install Command (Correct Two-Step Flow) +```bash +claude plugin marketplace add AgriciDaniel/claude-obsidian +claude plugin install claude-obsidian@claude-obsidian-marketplace +``` -## Top 5 Cherry-Picks (see [[cherry-picks]] for full list) -1. URL ingestion in /wiki-ingest (pass `https://` → auto-fetch → ingest) -2. Auto-commit PostToolUse hook (every wiki write → git commit) -3. defuddle web cleaning (from kepano — strips clutter before ingest) -4. Delta tracking manifest (only re-ingest new/changed files) -5. Multi-depth query (Quick/Standard/Deep modes) +There is no `claude plugin install github:owner/repo` shortcut. Both steps are required. Full session note: [[claude-obsidian-v1.4-release-session]]. -## claude-obsidian Unique Advantages Confirmed -- Hot cache (no one else has this) -- Canvas skill (unique in LLM Wiki category) -- /save conversation → wiki (unique workflow) -- Marketplace polish (best install experience) +## Recent Release Cycle (v1.1 → v1.4.1) +- **v1.1**: URL ingestion, vision ingestion, delta tracking manifest, 3 new skills (defuddle, obsidian-bases, obsidian-markdown), multi-depth query modes, PostToolUse auto-commit, removed invalid `allowed-tools` frontmatter field +- **v1.4.0**: Dataview to Bases migration (new `wiki/meta/dashboard.base`), Canvas JSON 1.0 spec completeness, PostCompact hook, Obsidian CLI MCP option, 6 multi-agent bootstrap files, 249 em dashes scrubbed, security git history rewrite to remove placeholder email +- **v1.4.1**: hotfix for wrong plugin install command syntax in README and install-guide.md + +## Key Lessons (Recent) +1. Plugin install is always two-step: `marketplace add` then `install plugin@marketplace` +2. `allowed-tools` is NOT valid in skill frontmatter. Use only `name` and `description` (kepano convention). +3. Obsidian Bases uses `filters/views/formulas`, not Dataview `from/where` +4. Canvas edges have asymmetric defaults: `fromEnd="none"`, `toEnd="arrow"` +5. Hook-injected context does not survive compaction. PostCompact hook is required to restore hot cache. +6. `git filter-repo` needs two passes: `--replace-text` for blobs, `--replace-message` for commit messages + +## Style Preferences (Saved to Memory) +- **No em dashes** (U+2014) or `--` as punctuation anywhere. Use periods, commas, colons, or parentheses. Hyphens in compound words are fine (auto-commit, multi-agent). +- Keep responses short and direct. No trailing "here's what I did" summaries. +- Parallel tool calls when independent. + +## Ecosystem Research (Done 2026-04-08) +16+ Claude + Obsidian projects mapped. Full feature matrix at [[claude-obsidian-ecosystem]]. Prioritized backlog at [[cherry-picks]]. Top competitors: [[Ar9av-obsidian-wiki]] (multi-agent + delta tracking), [[rvk7895-llm-knowledge-bases]] (multi-depth query), [[ballred-obsidian-claude-pkm]] (goal cascade + auto-commit), [[kepano-obsidian-skills]] (authoritative Obsidian skills from Obsidian's own creator). ## Active Threads -- [[cherry-picks]] ready for v1.3.0 planning -- Wiki pages: 25 | Sources ingested: 2 +- v1.5.0 backlog: `/adopt` command, vault graph analysis in wiki-lint, semantic search via qmd, Marp output +- `community` remote (`avalonreset-pro/claude-obsidian`) still has pre-rewrite history. Force-push needed next time that remote is configured. + +## Repo Locations +- Working: `~/Desktop/claude-obsidian/` +- Public: https://github.com/AgriciDaniel/claude-obsidian +- Community (private): https://github.com/avalonreset-pro/claude-obsidian diff --git a/wiki/index.md b/wiki/index.md index 49bc8a8..7d46906 100644 --- a/wiki/index.md +++ b/wiki/index.md @@ -23,7 +23,7 @@ related: # Wiki Index -Last updated: 2026-04-08 | Total pages: 25 | Sources ingested: 2 +Last updated: 2026-04-08 | Total pages: 26 | Sources ingested: 2 Navigation: [[overview]] | [[log]] | [[hot]] | [[dashboard]] | [[Wiki Map]] | [[getting-started]] diff --git a/wiki/log.md b/wiki/log.md index b9e219b..81f1226 100644 --- a/wiki/log.md +++ b/wiki/log.md @@ -1,7 +1,7 @@ --- type: meta title: "Operation Log" -updated: 2026-04-07 +updated: 2026-04-08 tags: - meta - log @@ -25,6 +25,12 @@ Parse recent entries: `grep "^## \[" wiki/log.md | head -10` --- +## [2026-04-08] save | claude-obsidian v1.4 Release Session +- Type: session +- Location: wiki/meta/claude-obsidian-v1.4-release-session.md +- From: full release cycle covering v1.1 (URL/vision/delta tracking, 3 new skills), v1.4.0 (audit response, multi-agent compat, Bases dashboard, em dash scrub, security history rewrite), and v1.4.1 (plugin install command hotfix) +- Key lessons: plugin install is 2-step (marketplace add then install), allowed-tools is not valid frontmatter, Bases uses filters/views/formulas not Dataview syntax, hook context does not survive compaction, git filter-repo needs 2 passes for full scrub + ## [2026-04-08] ingest | Claude + Obsidian Ecosystem Research - Type: research ingest - Source: `.raw/claude-obsidian-ecosystem-research.md` diff --git a/wiki/meta/claude-obsidian-v1.4-release-session.md b/wiki/meta/claude-obsidian-v1.4-release-session.md new file mode 100644 index 0000000..7c470c0 --- /dev/null +++ b/wiki/meta/claude-obsidian-v1.4-release-session.md @@ -0,0 +1,278 @@ +--- +type: session +title: "claude-obsidian v1.4 Release Session" +created: 2026-04-08 +updated: 2026-04-08 +tags: + - meta + - session + - release + - audit-response +status: evergreen +related: + - "[[claude-obsidian-ecosystem]]" + - "[[cherry-picks]]" + - "[[full-audit-and-system-setup-session]]" + - "[[claude-obsidian-v1.2.0-release-session]]" + - "[[LLM Wiki Pattern]]" +sources: + - "[[claude-obsidian-ecosystem-research]]" +--- + +# claude-obsidian v1.4 Release Session + +A complete release cycle covering v1.1, v1.4.0, and v1.4.1. Includes ecosystem research, external audit response, multi-agent compatibility rollout, full em-dash style cleanup, git history scrub for privacy, and a hotfix for the plugin install command syntax. + +## Release Sequence + +| Version | What shipped | +|---|---| +| v1.1 | URL ingestion, image/vision ingestion, delta tracking manifest, 3 new skills (defuddle, obsidian-bases, obsidian-markdown), multi-depth wiki-query modes, PostToolUse auto-commit hook, removal of invalid `allowed-tools` frontmatter field | +| v1.4.0 | Dataview to Bases migration, Canvas JSON 1.0 spec completeness, hooks hardening plus PostCompact, MCP setup hardened with Obsidian CLI option, custom callouts documented, 6 multi-agent bootstrap files, 249 em dashes scrubbed, security-rewrote git history to remove a placeholder email | +| v1.4.1 | Hotfix for the wrong plugin install command syntax in README and docs/install-guide.md | + +## v1.1: First Feature Release of This Session + +Shipped in response to an internal quality check against the wider ecosystem (16+ Claude plus Obsidian projects researched, filed in [[claude-obsidian-ecosystem]]). The highest-value features from competing implementations were cherry-picked and shipped as v1.1. + +### New skills (Agent Skills spec compliant) + +- `skills/defuddle/SKILL.md`: strips ads, nav, and clutter from web pages before URL ingestion. Saves 40 to 60 percent on tokens for typical articles. +- `skills/obsidian-markdown/SKILL.md`: full reference for Obsidian Flavored Markdown (wikilinks, embeds, all callout types, properties, math, Mermaid). Cross-references kepano/obsidian-skills as the authoritative source. +- `skills/obsidian-bases/SKILL.md`: native Obsidian Bases `.base` file syntax. Uses correct `filters/views/formulas` structure (NOT Dataview-style `from/where`). Rewritten mid-session after the first attempt used the wrong syntax. + +### wiki-ingest upgrades + +- **URL ingestion**: passes any `https://` URL directly. Uses WebFetch, optionally pipes through defuddle, saves to `.raw/articles/`, then runs the normal ingest pipeline. +- **Image/vision ingestion**: `.png`, `.jpg`, `.gif`, `.webp`, etc. Claude reads the image natively, extracts text via OCR and concepts via vision, saves the description to `.raw/images/`, then ingests. +- **Delta tracking**: `.raw/.manifest.json` tracks MD5 hash per source, timestamps, and the pages produced. Re-running ingest on unchanged files skips them automatically. Override with "force ingest". + +### wiki-query multi-depth modes + +Three query tiers: + +- **Quick** (`query quick: ...`): hot.md plus index.md only. About 1,500 tokens. Best for fact lookups. +- **Standard** (default): hot plus index plus 3 to 5 relevant pages. About 3,000 tokens. Best for most questions. +- **Deep** (`query deep: ...`): full wiki cross-reference plus optional web search supplement. About 8,000+ tokens. Best for synthesis, comparisons, "tell me everything about X". + +### Hook: PostToolUse auto-commit + +Every `Write` or `Edit` tool call to `wiki/` or `.raw/` triggers `git add` and `git commit` automatically. Guarded by `[ -d .git ]` so it never errors in non-git directories, and by `git diff --cached --quiet` so it never creates empty commits. Matcher: `Write|Edit`. + +### Critical fix: `allowed-tools` frontmatter removed + +The Agent Skills spec only supports `name`, `description`, `argument-hint`, `compatibility`, `disable-model-invocation`, `license`, `metadata`, and `user-invokable` fields in SKILL.md frontmatter. The `allowed-tools` field was never valid and was being silently ignored. Removed from all 10 SKILL.md files to match the kepano/obsidian-skills authoritative convention. + +## v1.4.0: External Audit Response + +External auditor delivered a 21-source review (the "compass artifact") against Agent Skills spec, Claude Code hooks, Obsidian v1.9 through v1.12, and JSON Canvas 1.0. Initial audit score: 6.5/10. Many findings were already resolved in v1.1 (the audit was conducted against a snapshot from before that release). The remaining valid findings became v1.4.0. Full findings and prioritization are in [[cherry-picks]]. + +### Tier 1: Critical fixes + +**Dataview to Bases migration** (the biggest correctness fix). Obsidian Bases shipped as a core plugin in v1.9.10 (August 2025), providing native database-like views that replace Dataview for most use cases. Created `wiki/meta/dashboard.base` with six views (Recent Activity, Seed Pages, Entities Missing Sources, Open Questions, Comparisons, Sources). Updated `wiki/meta/dashboard.md` to embed the new base file as primary and keep the legacy Dataview queries as optional fallback. Reorganized README plugins section to recommend Bases (core, no install needed) as primary and mark Dataview as optional/legacy. + +**Canvas JSON 1.0 spec completeness**. Added previously missing fields to `skills/canvas/references/canvas-spec.md`: +- Group nodes: `background` (string path) and `backgroundStyle` (`cover`, `ratio`, `repeat`) +- Edges: `fromEnd` (defaults to `"none"`) and `toEnd` (defaults to `"arrow"`). Asymmetric defaults that produce a single arrow without explicit specification. +- Documented the official hex ID convention alongside the descriptive ID alternative. + +### Tier 2: Important improvements + +**Hooks hardening plus PostCompact**. `hooks/hooks.json` updated: + +- SessionStart now uses both `command` and `prompt` types. The command runs `[ -f wiki/hot.md ] && cat wiki/hot.md || true` as the canonical safety check that works in non-vault sessions without erroring. Matcher: `startup|resume`. +- **NEW PostCompact hook** re-injects `wiki/hot.md` after context compaction. Critical insight: hook-injected context does NOT survive compaction, only `CLAUDE.md` does. Without this hook the hot cache disappears mid-session after any compact event. +- PostToolUse auto-commit now guarded by `[ -d .git ]` in addition to the existing safeguards. +- New `hooks/README.md` documents all four hooks plus the known plugin-hooks STDOUT bug (`anthropics/claude-code#10875`) and workarounds. + +**MCP setup hardened**. `skills/wiki/references/mcp-setup.md` now has a `> [!warning]` callout above the `NODE_TLS_REJECT_UNAUTHORIZED: "0"` line explaining that it disables TLS verification process-wide (acceptable for `127.0.0.1` only). Added **Option D: Obsidian CLI** (Obsidian v1.12+) as the recommended alternative that avoids the TLS workaround entirely by using the native CLI via the Bash tool. + +**Custom callouts documented**. The vault defines four custom callout types in `.obsidian/snippets/vault-colors.css`: + +| Callout | Color | Icon | Use for | +|---|---|---|---| +| `contradiction` | reddish-brown | `lucide-alert-triangle` | New source conflicts with existing claim | +| `gap` | beige | `lucide-help-circle` | Topic has no source yet | +| `key-insight` | bright blue | `lucide-lightbulb` | Important takeaway worth highlighting | +| `stale` | gray | `lucide-clock` | Claim may be outdated | + +Full documentation added to `skills/wiki/references/css-snippets.md` including built-in fallback equivalents for users who do not want the custom CSS. `skills/wiki-ingest/SKILL.md` got an explicit note that `[!contradiction]` depends on the CSS snippet. + +### Tier 3: Multi-agent compatibility (low complexity, high reach) + +Skills are already in the cross-platform Agent Skills format. The only thing missing was adapter files so other AI coding agents could discover them. Added: + +| File | For | +|---|---| +| `AGENTS.md` | Codex CLI, OpenCode | +| `GEMINI.md` | Gemini CLI, Antigravity | +| `.cursor/rules/claude-obsidian.mdc` | Cursor (always-on rules) | +| `.windsurf/rules/claude-obsidian.md` | Windsurf Cascade | +| `.github/copilot-instructions.md` | GitHub Copilot | +| `bin/setup-multi-agent.sh` | Idempotent symlink installer that wires up `skills/` into each agent's expected location | + +This turns claude-obsidian into a multi-agent plugin at near-zero compatibility cost. Pattern borrowed from [[Ar9av-obsidian-wiki]] which was the reference implementation for multi-agent support. + +## Style Cleanup: Em Dash Scrub + +Per user preference saved to feedback memory: never use em dashes (U+2014) or `--` as punctuation. Use periods, commas, colons, or parentheses instead. Hyphens in compound words (auto-commit, multi-agent) are fine. + +Wrote a context-aware Python scrubber at `/tmp/scrub_em_dashes.py` with rules: + +- Heading lines (`^#`): em dash becomes `:` +- List items (`^-`, `^|`): em dash becomes `:` (for label-description patterns) +- Prose: em dash becomes `.` with next word capitalized + +**Result**: 249 em dashes removed across 26 files. Scrubbed every SKILL.md, every doc, every hook file, every bootstrap file, and marketplace.json. Manual smoothing required for: + +- `skills/obsidian-markdown/SKILL.md`: 4 code-block annotation tables where the scrubber produced broken fragments. Converted to proper markdown tables. +- `skills/wiki-query/SKILL.md`: 4 "If X. Respond." fragments rewritten as "If X, respond." +- `bin/setup-multi-agent.sh`: 1 leftover em dash at end-of-line that the scrubber missed (only matched space-em-space). Plus one awkward echo string fixed. + +The user-facing feedback was clear: "make it proper and natural". The scrubbed prose reads cleaner with the fragmented sentences smoothed out. + +## Security: Email Removal and Git History Rewrite + +A placeholder email `daniel@avalonreset.pro` (which the user confirmed does not exist as a real address) was in `marketplace.json` plus two docs. Removed from working tree first, then rewrote git history to scrub it from all commits. + +**Tool**: `git filter-repo` (available at `~/.pyenv/versions/3.12.4/bin/git-filter-repo`). + +**Two passes required**: + +1. `git filter-repo --replace-text /tmp/email-replacements.txt --force` scrubs blob contents across all commits. +2. `git filter-repo --replace-message /tmp/email-msg-replacements.txt --force` scrubs commit messages. The first pass caught 3 occurrences in file contents but missed 1 occurrence in a commit subject line. The second pass caught that. + +**Replacement string**: `daniel@avalonreset.pro==>***REMOVED***` + +**Post-rewrite actions**: +- Re-added the `origin` remote that filter-repo removes for safety +- Moved `v1.4.0` tag forward to include the security commit (since v1.4.0 had not been consumed yet by any user) +- Force-pushed main plus both tags (`v1.1` and `v1.4.0`) +- Updated the v1.4.0 GitHub release notes to include a "Security Note" section + +**Verification**: grep across all refs, all blobs, all commit messages returned zero matches for `daniel@avalonreset`. GitHub release bodies checked for same: both v1.1 and v1.4.0 release pages clean. + +**Caveat for other clones**: history rewrite means every commit hash changed. Any other machine or private `community` remote at `avalonreset-pro/claude-obsidian` that has the repo still contains the old history. Those need `git fetch && git reset --hard origin/main` or a force push to clean up. + +## v1.4.1: Plugin Install Command Hotfix + +The v1.4.0 README and install guide showed this install command: + +```bash +claude plugin install github:AgriciDaniel/claude-obsidian +``` + +This form does not exist in Claude Code. Users trying it see: + +``` +Failed to install plugin "github:AgriciDaniel/claude-obsidian": Plugin "github:AgriciDaniel/claude-obsidian" not found in any configured marketplace +``` + +### The correct install flow (per `code.claude.com/docs/en/plugin-marketplaces`) + +Plugin installation is a **two-step** process: + +```bash +# Step 1: add the marketplace catalog +claude plugin marketplace add AgriciDaniel/claude-obsidian + +# Step 2: install the plugin from the catalog by name +claude plugin install claude-obsidian@claude-obsidian-marketplace +``` + +Where `claude-obsidian` is the plugin name (from `plugin.json`) and `claude-obsidian-marketplace` is the marketplace name (from `marketplace.json`). The `@` delimiter separates them. + +### Why the confusion existed + +There is no `claude plugin install github:owner/repo` shortcut. The marketplace abstraction is mandatory: Claude Code always fetches via a registered marketplace. A single-repo plugin like claude-obsidian is both the marketplace host and the plugin host, and the user must register the marketplace first before installing any plugin from it. + +### Related CLI commands (useful to know) + +| Command | What it does | +|---|---| +| `claude plugin marketplace list` | Show all registered marketplaces | +| `claude plugin marketplace add owner/repo` | Register a new marketplace from a GitHub repo | +| `claude plugin marketplace update ` | Refresh the marketplace catalog and re-clone | +| `claude plugin marketplace remove ` | Unregister a marketplace (also uninstalls its plugins) | +| `claude plugin install @` | Install a specific plugin | +| `claude plugin list` | Show all installed plugins and their status | +| `claude plugin validate .` | Validate a marketplace.json, plugin.json, and frontmatter | + +### Files changed in v1.4.1 + +- `README.md`: Option 2 install section rewritten with two-step flow +- `docs/install-guide.md`: same correction +- `.claude-plugin/plugin.json`: 1.4.0 to 1.4.1 +- `.claude-plugin/marketplace.json`: both `metadata.version` and `plugins[0].version` bumped to 1.4.1 + +### Confirmed working + +After v1.4.1 was published, the user ran the corrected commands and saw: + +``` +claude-obsidian@claude-obsidian-marketplace + Version: 1.4.1 + Scope: user + Status: ✔ enabled +``` + +v1.4.1 installed at user scope and enabled. + +## Key Lessons (Worth Remembering) + +1. **Plugin install is always two-step**. There is no github shorthand form. `marketplace add` then `install plugin@marketplace`. +2. **`allowed-tools` is not a valid skill frontmatter field**. The Agent Skills spec only accepts `name`, `description`, `argument-hint`, `compatibility`, `disable-model-invocation`, `license`, `metadata`, `user-invokable`. kepano/obsidian-skills uses only `name` and `description` which is the gold standard convention. +3. **Obsidian Bases uses `filters/views/formulas`, not Dataview-style `from/where`**. Easy to confuse. Always check `help.obsidian.md/bases/syntax` for the current syntax. +4. **Canvas JSON 1.0 has asymmetric edge defaults**. `fromEnd` defaults to `"none"`, `toEnd` defaults to `"arrow"`. Omitting both produces a single arrow pointing from source to target. +5. **Hook-injected context does not survive context compaction**. Only `CLAUDE.md` does. Any plugin that injects context via SessionStart hooks should also add a PostCompact hook to restore it mid-session. +6. **`git filter-repo` needs two passes for full scrub**. `--replace-text` handles blob contents, `--replace-message` handles commit messages. Running only one leaves traces. +7. **`git filter-repo` removes the `origin` remote for safety**. Must re-add it manually before force-pushing. +8. **Marketplace name and plugin name can differ**. Our marketplace is `claude-obsidian-marketplace`, our plugin is `claude-obsidian`. The `@` delimiter disambiguates them. +9. **Style preference: no em dashes anywhere**. Periods, commas, colons, or parentheses instead. Applies to all prose, commit messages, release notes, file content. Hyphens in compound words are fine. + +## Files Created in This Session + +Summary of everything new or newly created: + +| Path | Type | Purpose | +|---|---|---| +| `skills/defuddle/SKILL.md` | skill | Web page cleaner | +| `skills/obsidian-bases/SKILL.md` | skill | Obsidian Bases syntax | +| `skills/obsidian-markdown/SKILL.md` | skill | Full Obsidian syntax reference | +| `wiki/meta/dashboard.base` | bases dashboard | 6-view Bases dashboard | +| `wiki/comparisons/claude-obsidian-ecosystem.md` | comparison | 16+ project feature matrix | +| `wiki/concepts/cherry-picks.md` | concept | Prioritized feature backlog | +| `wiki/sources/claude-obsidian-ecosystem-research.md` | source | Research summary | +| `wiki/entities/Ar9av-obsidian-wiki.md` | entity | Multi-agent reference implementation | +| `wiki/entities/Nexus-claudesidian-mcp.md` | entity | Native Obsidian plugin | +| `wiki/entities/ballred-obsidian-claude-pkm.md` | entity | Goal cascade PKM | +| `wiki/entities/rvk7895-llm-knowledge-bases.md` | entity | Multi-depth query reference | +| `wiki/entities/kepano-obsidian-skills.md` | entity | Authoritative skill reference | +| `wiki/entities/Claudian-YishenTu.md` | entity | Native Obsidian plugin | +| `.raw/claude-obsidian-ecosystem-research.md` | raw source | Ecosystem research dump | +| `hooks/README.md` | doc | Hook documentation | +| `AGENTS.md` | bootstrap | Codex CLI / OpenCode | +| `GEMINI.md` | bootstrap | Gemini CLI / Antigravity | +| `.cursor/rules/claude-obsidian.mdc` | bootstrap | Cursor rules | +| `.windsurf/rules/claude-obsidian.md` | bootstrap | Windsurf Cascade | +| `.github/copilot-instructions.md` | bootstrap | GitHub Copilot | +| `bin/setup-multi-agent.sh` | script | Multi-agent symlink installer | + +## Current Plugin State + +- **Plugin installed**: `claude-obsidian@claude-obsidian-marketplace` version `1.4.1`, user scope, enabled +- **Releases on GitHub**: `v1.1`, `v1.4.0`, `v1.4.1` +- **10 skills** in `skills/`: wiki, wiki-ingest, wiki-query, wiki-lint, save, autoresearch, canvas, defuddle, obsidian-bases, obsidian-markdown +- **4 lifecycle hooks** in `hooks/hooks.json`: SessionStart, PostCompact, PostToolUse, Stop +- **6 multi-agent bootstrap files** covering Codex, OpenCode, Gemini, Cursor, Windsurf, GitHub Copilot +- **2 agents** in `agents/`: wiki-ingest, wiki-lint + +## Deferred to v1.5.0 + +From the audit cherry-picks list, these items were identified but intentionally not included in v1.4.0: + +- `/adopt` command for importing existing vaults (medium complexity, adds new surface) +- Vault graph analysis enhancement to wiki-lint (hub pages, cross-domain bridges, dead-ends) +- Semantic search via qmd MCP server (optional external dependency) +- Marp slide output from wiki queries (niche) +- Thinking mode vs Writing mode UX experiment diff --git a/wiki/overview.md b/wiki/overview.md index cec55a2..7057a4a 100644 --- a/wiki/overview.md +++ b/wiki/overview.md @@ -49,8 +49,8 @@ Run `/wiki` to scaffold this vault for your own domain and replace this overview ## Current State - Sources ingested: 2 -- Wiki pages: 25 -- Last activity: 2026-04-08 (ecosystem research ingest — 16+ projects mapped) +- Wiki pages: 26 +- Last activity: 2026-04-08 (v1.4.1 shipped, release session filed) ---