release: promote v2.0.0 public artifact

Author: AgriciDaniel

.claude-plugin/marketplace.json

@@ -1,27 +1,22 @@
 {
-  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "description": "Audited public distribution channel for claude-obsidian",
   "name": "agricidaniel-claude-obsidian",
   "owner": {
-    "name": "AgriciDaniel",
-    "url": "https://github.com/AgriciDaniel"
-  },
-  "metadata": {
-    "description": "claude-obsidian: a self-organizing AI second brain for Obsidian + Claude Code by AgriciDaniel. A persistent, compounding wiki vault of plain Markdown you own, based on Karpathy's LLM Wiki pattern.",
-    "version": "1.9.2"
+    "name": "AgriciDaniel"
   },
   "plugins": [
     {
-      "name": "claude-obsidian",
-      "source": "./",
-      "description": "Claude + Obsidian knowledge companion. v1.7 \"Compound Vault\" + v1.8 methodology modes close 5 of 5 priority gaps from the May 2026 compass artifact. Ships: substrate alignment with kepano/obsidian-skills, default Obsidian CLI transport, hybrid retrieval (Anthropic Sept 2024 contextual retrieval pattern: BM25 + cosine rerank), per-file advisory locking for multi-writer safety, pre-commit verifier agent, AND methodology modes (LYT / PARA / Zettelkasten / Generic) — first-class organizational support no other Claude+Obsidian competitor offers. v1.7.x audit fully closed; 50-query retrieval benchmark verified at +32pp top-1 / +41% error-reduction vs v1.6 baseline. Optional DragonScale Memory extension. Pairs with kepano/obsidian-skills (recommended) for canonical Obsidian primitives.",
-      "version": "1.9.2",
       "author": {
         "name": "AgriciDaniel",
         "url": "https://github.com/AgriciDaniel"
       },
+      "description": "Local-first Agent Skills package and Claude Code plugin for source-cited Obsidian knowledge bases. Includes recoverable transactions, deterministic lint and retrieval, provenance ledgers, explicit vault adoption, offline-first capture foundations, and methodology modes.",
       "homepage": "https://github.com/AgriciDaniel/claude-obsidian",
+      "license": "MIT",
+      "name": "claude-obsidian",
       "repository": "https://github.com/AgriciDaniel/claude-obsidian",
-      "license": "MIT"
+      "source": "./"
     }
-  ]
+  ],
+  "version": "2.0.0"
 }

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-obsidian",
-  "version": "1.9.2",
-  "description": "Claude + Obsidian knowledge companion. Sets up a persistent, compounding wiki vault (Karpathy's LLM Wiki pattern). v1.7 \"Compound Vault\" + v1.8 methodology modes close 5 of 5 priority gaps from the May 2026 compass artifact. Ships: substrate alignment with kepano/obsidian-skills, default Obsidian CLI transport, hybrid retrieval (contextual prefix + BM25 + cosine rerank per Anthropic's Sept 2024 research), per-file advisory locking for multi-writer safety, pre-commit verifier agent, AND methodology modes (LYT / PARA / Zettelkasten / Generic) for first-class organizational support no other Claude+Obsidian competitor offers. v1.7.x audit closure: every BLOCKER + HIGH + MEDIUM + LOW finding from the v1.7.0 audit is CLOSED or DEFERRED-with-rationale. Optional DragonScale Memory extension (log folds, deterministic addresses, semantic tiling lint, boundary-first autoresearch).",
+  "version": "2.0.0",
+  "description": "Local-first Agent Skills package and Claude Code plugin for source-cited Obsidian knowledge bases. Provides explicit vault initialization and adoption, recoverable operation transactions, deterministic lint and retrieval, provenance ledgers, offline-first capture foundations, and optional methodology modes. User vaults stay outside the plugin cache; network and destructive actions require explicit consent.",
   "author": {
     "name": "AgriciDaniel",
     "url": "https://github.com/AgriciDaniel"

.cursor/rules/claude-obsidian.mdc

@@ -1,65 +1,32 @@
 ---
-description: claude-obsidian: LLM Wiki Pattern for Obsidian vaults. Always-on context for any project pointed at this repo.
+description: Portable rules for the claude-obsidian product and user vault workflows.
 globs:
+  - "skills/**/SKILL.md"
+  - "claude_obsidian/**/*.py"
   - "wiki/**/*.md"
   - ".raw/**/*"
-  - "skills/**/SKILL.md"
 alwaysApply: true
 ---
 
 # claude-obsidian
 
-A Claude Code plugin and Obsidian vault that builds persistent, compounding knowledge bases using Andrej Karpathy's LLM Wiki pattern. This repo works with Cursor's AI through the cross-platform Agent Skills format.
-
-## What This Project Is
-
-- **Vault root**: contains `wiki/` (agent-generated knowledge) and `.raw/` (source documents: immutable)
-- **Hot cache**: `wiki/hot.md` (~500 tokens) holds recent session context
-- **Index**: `wiki/index.md` is the master catalog Claude reads first
-- **Skills**: 10 skills under `skills/<name>/SKILL.md` define ingest/query/lint/save/canvas/etc
-
-## Skills Available
-
-| Skill | When to use |
-|---|---|
-| `wiki` | Scaffold new vault, route to sub-skills |
-| `wiki-ingest` | Ingest a file, URL, or image: creates 8-15 wiki pages |
-| `wiki-query` | Answer questions from the wiki (Quick / Standard / Deep modes) |
-| `wiki-lint` | Health check: orphans, dead links, gaps |
-| `save` | File current conversation as a wiki note |
-| `autoresearch` | Autonomous research loop |
-| `canvas` | Create/edit Obsidian canvas files |
-| `defuddle` | Clean web pages before ingest |
-| `obsidian-markdown` | Obsidian syntax reference |
-| `obsidian-bases` | Obsidian Bases (.base files) |
-
-Read the relevant `skills/<name>/SKILL.md` file when the user's request matches a skill's trigger phrases.
+Read `AGENTS.md` as the canonical contract. This repository is product source;
+mutable knowledge belongs in a separately resolved user vault.
 
-## Critical Conventions
+- Discover workflows from `skills/<name>/SKILL.md`.
+- Resolve vaults explicitly; never use the plugin/product directory by default.
+- Read a selected vault's bounded `wiki/hot.md` at session start when present.
+- Treat raw source payloads as create-only.
+- Have parallel workers draft; apply one recoverable operation transaction.
+- Keep queries and lint read-only. Put persistence or repair in a separate
+  reviewed operation.
+- Require consent for network egress, destructive changes, and Git checkpoints.
 
-1. **Never modify `.raw/`**. Sources are immutable
-2. **Read `wiki/hot.md` first** when starting a session (if it exists)
-3. **Use wikilinks** (`[[Note Name]]`) for all internal references in wiki pages
-4. **Frontmatter is flat YAML**. See `skills/wiki/references/frontmatter.md`
-5. **Append to `wiki/log.md`**, never edit past entries
-6. **Hot cache is overwritten** at session end (it's a cache, not a journal)
-
-## Setup for Cursor
-
-To make these skills first-class in Cursor, run:
+Preview and then install workspace-local skill links with:
 
 ```bash
-ln -s "$(pwd)/skills" .cursor/skills
+bash bin/setup-multi-agent.sh --host cursor --workspace "$PWD"
+bash bin/setup-multi-agent.sh --host cursor --workspace "$PWD" --apply
 ```
 
-Or use the bundled installer:
-
-```bash
-bash bin/setup-multi-agent.sh
-```
-
-## Cross-Reference
-
-- Plugin: https://github.com/AgriciDaniel/claude-obsidian
-- Pattern: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
-- Related: https://github.com/kepano/obsidian-skills
+Public canonical: https://github.com/AgriciDaniel/claude-obsidian

.github/ISSUE_TEMPLATE/bug_report.md

@@ -18,11 +18,12 @@ What you expected to happen instead.
 3. ...
 
 ## Environment
-- Plugin version: (e.g. v1.9.0)
+- Product version: (run `python3 scripts/claude-obsidian.py --version`)
 - Claude Code version: (run `claude --version`)
 - OS: (e.g. macOS 14.5, Pop!_OS 24.04, Windows 11)
 - Obsidian version: (if relevant)
-- Transport selected: (filesystem / obsidian-cli / mcp-obsidian — see `.vault-meta/transport.json`)
+- Vault selection source: (`doctor --vault <vault>` output, with private paths redacted)
+- Transport state: (`bash scripts/detect-transport.sh --peek --vault <vault>` output)
 
 ## Skill / agent / script involved
 Which surface is affected? (e.g. `/wiki-ingest`, `scripts/wiki-mode.py`, `agents/verifier.md`)
@@ -33,7 +34,8 @@ Paste relevant terminal output or error messages here.
 ```
 
 ## What you tried
-- [ ] Ran `make test` — all 8 suites green? Yes / No
+- [ ] Ran the relevant regression test or `make test` — Yes / No
+- [ ] Confirmed the product repository and user vault are separate — Yes / No
 - [ ] Checked CHANGELOG for known issues at your version
 - [ ] Searched existing issues for similar reports
 

.github/copilot-instructions.md

@@ -1,51 +1,19 @@
-# claude-obsidian: GitHub Copilot Instructions
+# claude-obsidian Copilot instructions
 
-This repository is a **Claude Code plugin and Obsidian vault** that builds persistent, compounding knowledge bases using Andrej Karpathy's LLM Wiki pattern. It is markdown-only. No build step, no compiled code, no runtime dependencies.
+Read `AGENTS.md` before proposing changes. The repository is an Agent Skills
+package, Claude Code adapter, standard-library Python core, and deterministic
+vault template—not the default live user vault.
 
-## Project Type
+When editing:
 
-- Agent Skills package (cross-platform Agent Skills standard)
-- Obsidian vault (interpretable by Obsidian directly)
-- Claude Code plugin (installable via marketplace)
+- Keep skill frontmatter to exactly `name` and single-line `description`.
+- Use Obsidian Flavored Markdown, flat YAML properties, and `YYYY-MM-DD` dates.
+- Never modify existing raw source payloads.
+- Route all logical knowledge mutations through one inspected operation bundle.
+- Keep workers draft-only and lint/query read-only.
+- Preserve vault path containment and product/vault separation.
+- Add hermetic regression tests for behavior changes and run `make test`.
+- Do not add secrets, private paths, unsupported capability claims, or duplicate
+  command wrappers.
 
-## Repository Layout
-
-- `skills/`: 10 skills, each with a `SKILL.md` defining trigger phrases and instructions
-- `hooks/hooks.json`: Claude Code lifecycle hooks (SessionStart, PostCompact, PostToolUse, Stop)
-- `.claude-plugin/plugin.json`: plugin manifest
-- `wiki/`: generated knowledge base (Markdown files with YAML frontmatter)
-- `.raw/`: immutable source documents (never modify)
-- `_templates/`: Obsidian Templater templates
-- `_attachments/`: images and PDFs referenced by wiki pages
-
-## Conventions Copilot Should Follow
-
-When suggesting edits:
-
-1. **Frontmatter is flat YAML** with plural keys: `tags`, `aliases`, `cssclasses`
-2. **Internal links are wikilinks**: `[[Note Name]]`, not Markdown links to `.md` paths
-3. **Dates are `YYYY-MM-DD`**, not ISO datetimes
-4. **`.raw/` is immutable**. Never suggest edits to anything under that path
-5. **`wiki/log.md` is append-only**, with new entries at the top
-6. **`wiki/hot.md` is overwritten** at session end, not appended to
-7. **Skills use only `name` and `description` in frontmatter**. No `allowed-tools`, no `triggers`, no `globs` (these are not part of the Agent Skills spec)
-8. **Custom callouts**: this vault defines `[!contradiction]`, `[!gap]`, `[!key-insight]`, `[!stale]` in `.obsidian/snippets/vault-colors.css`. These render only with that snippet enabled.
-
-## When Editing Skills (`skills/<name>/SKILL.md`)
-
-- Frontmatter: `name` (matches directory name) and `description` (single quoted line, max ~250 useful chars)
-- Body: short, imperative instructions. Reference files with backticks. Do not paste large code blocks unless they're essential.
-- Trigger phrases go in the `description` field, not in body or non-standard fields
-
-## When Editing Hooks (`hooks/hooks.json`)
-
-- Valid event names only: `SessionStart`, `Stop`, `PreToolUse`, `PostToolUse`, `PreCompact`, `PostCompact`, `UserPromptSubmit`
-- Hook types: `command` (shell), `prompt` (LLM), `http` (POST), `agent` (subagent)
-- `matcher` field uses regex against tool names for `PreToolUse`/`PostToolUse`
-- For `SessionStart`: matcher uses `startup`, `resume`, `clear`, or `compact`
-
-## Cross-Reference
-
-- Plugin: https://github.com/AgriciDaniel/claude-obsidian
-- Pattern source: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
-- Authoritative Obsidian-specific skills: https://github.com/kepano/obsidian-skills
+Public canonical: https://github.com/AgriciDaniel/claude-obsidian

.github/pull_request_template.md

@@ -20,13 +20,17 @@ List the files and surfaces touched:
 - `scripts/<name>.py` — what changed
 - ...
 
-## Six-cut self-review
+## Safety self-review
 - [ ] Read every file before changing it
 - [ ] New identifiers named for the next reader
 - [ ] Smallest unit that works (no speculative abstraction)
 - [ ] Deletions kept up with additions where applicable
 - [ ] New behavior has hermetic test coverage
 - [ ] New failure modes have explicit handling + undo plan
+- [ ] Product code and mutable user-vault state remain separate
+- [ ] Knowledge writes use one recoverable transaction; workers only draft
+- [ ] Network/destructive/external actions have explicit consent
+- [ ] Claims and capability maturity are evidence-backed
 
 ## Testing
 ```
@@ -39,7 +43,7 @@ All tests passed.
 ```
 
 ## Verifier
-For non-trivial changes, dispatch `agents/verifier.md` on the staged diff and paste its verdict:
+For non-trivial changes, dispatch `agents/verifier.md` on the declared worktree or path scope and paste its verdict:
 
 - Verdict: SHIP / HOLD-FIX-FIRST / NEEDS-REWORK
 - BLOCKER: N / HIGH: N / MEDIUM: N / LOW: N