dotfiles/claude/memory/project-obsidian-vault-practice.md

name, description, metadata

name	description	metadata
project-obsidian-vault-practice	Canonical tracker for the Obsidian vault workstream — turning root-and-branch from an archive into a practice, beginning with a ratified Frontmatter Specification v1.0.0. Holds the operational facts (the vault is NOT a git repo; it mirrors to ~/_Dev/david-root-and-branch-vault-git), the applied-pass record, and the open tail. Read before any vault work.	node_type type modified memory project 2026-08-20T09:08:17Z

Obsidian vault — from archive to practice

Steward's goal, stated 2026-08-19: "optimizing my Obsidian usage and setting up a regular workflow to have the important parts of our work captured there… My instinct is that I could make better use of it. I want to create an Obsidian 'spec' like we have done for all of our serious projects."

The tool boundary, from the steward, so it is not re-elicited:

tool	role
Drafts.app	scratchpad; ephemeral text, or text destined elsewhere. Kept essentially empty at the end of every week.
Notes.app (Mac/iOS)	confidential material, as locked notes.
Obsidian (root-and-branch)	notes that must not be lost. "So far, a sort of archive."

Scope note: the vault is also the Compass — the steward's personal operating system. ~/CLAUDE.md says: reference it, never write to it. That standing rule was suspended for this workstream by explicit authorization ("I authorize the Compass ones too", 2026-08-19), for the named mechanical passes only. It is not a general licence.

---

Operational facts — do not re-derive

• The vault folder is NOT a git repository. ~/Library/Mobile Documents/iCloud~md~obsidian/Documents/David, root-and-branch has no .git.
• It mirrors to ~/_Dev/david-root-and-branch-vault-git (remote: git.skemantix.com/David/david-root-and-branch-vault-git). An automated job commits Mirror sync <timestamp> on its own schedule — so steward hand-edits land in git without anyone asking.
• Working reports and machine-readable changelogs live in ~/dotfiles/obsidian/: vault-frontmatter-inventory-2026-08-19.md, vault-frontmatter-pass1-followups-2026-08-19.md, vault-governance-block-round2-2026-08-19.md, vault-round3-archive-and-relations-2026-08-19.md, plus fm_inventory.json, pass2-changelog.json, pass2-flags.json.
• The spec is in the vault, not in dotfiles: 00. Compass/Frontmatter Specification.md.
• ⚠ verify-before-compose.sh fires on Write|Edit, and this work runs through Bash. A vault hook wired the same way would not fire on how the work actually runs. Noted 2026-08-19, unfixed.

---

Chronological log

2026-08-19 — census, spec, two passes (session died unwrapped; see session-2026-08-19-the-vault-got-a-spec-the-links-were-already-broken)

• Four read-only census rounds before any edit. 2,519 notes parsed, no sampling. 400 distinct keys over 5,867 instances; 68% of notes have no frontmatter at all. 66 keys consumed, 29 written-by-template-and-read-by-nothing, 305 orphaned.
• Round 2/3 findings that changed the design: owner was one job in three spellings (cut); canonical was one name doing two jobs (self-descriptive vs pointer-elsewhere); the hypothesis that pointer-form marks archival tested negative — 65 of 67 pointers sit outside 99. Archive. What actually distinguishes Archive is decay in practice, declaration in name only: status: archived on 2.3% of it, 90% receiving no wikilink from any live note, and no archival policy note anywhere in the vault.
• Frontmatter Specification v1.0.0 ratified and placed in 00. Compass/. First principle: storage and lifecycle are orthogonal — the folder says nothing; only status: declares.
• Pass 1 and pass 2 applied and pushed. 949ff14 31d8e1f 3d47bd2 00e741d 4c364e9 fab8fb0 (511 edits / 268 files) aee615d.
• End state: owner 0 · change_log 0 · domain 0 · revisions 90 · canonical 159 · see_canonical 3 · confidence 9 · links 8 kept-and-flagged. YAML parse errors 16, unchanged.
• Two executor tooling defects caught before applying (§6 handler covered block-style lists only — would have done 29 notes of 90 and reported success; §7 logged a retirement it did not perform). Both found by re-censusing an applied copy, not by reading the changelog.
• The jurist corrected its own "88 recoverable" reading: those were self-descriptive values resolving to themselves by construction. Only 3 of 66 pointers were genuinely recoverable.

2026-08-20 — the steward opened Obsidian, and the links were already broken

Checked against the mirror's history, not inferred. Coffee log (brew_temp: [[94–96°C]]) and homeopathy ([[Ignatia amara — The Medicine of the Sigh]] naming a title where the file is Ignatia amara.md) are both pre-existing; pass 2 never touched the homeopathy note and touched only linked_note→linked_daily_note in the coffee log.

But the passes are not innocent. §7 flattened nested links.parents — inert YAML Obsidian did not render — into top-level parents/children/peers, which made 194 already-unresolvable targets render as clickable-and-broken in the properties UI. The breakage was surfaced, not created. The pass report did not predict this, and it should have.

2026-08-23 — status check: four items verified against substrate, and one NEW regression found

Asked where the workstream stood; verified rather than relayed. Items 1–4 confirmed live, with two unit corrections: related was counted by the tracker in targets (194 unresolvable) and a file-count (122 notes / 213 targets now) is not comparable to it; and canonical: 159 is a frontmatter count — a naive grep '^canonical:' returns 239 because it also catches body text. The tracker was right and the quick instrument was wrong. YAML parse errors independently re-measured at 16, matching.

⚠ NEW — the vault has a write path the spec does not govern, and it silently reverted pass 2. Mirror sync a58fc00 (2026-08-22 23:52) changed 14 files and ran against the spec: owner 0 → 9, change_log 0 → 9, revisions 90 → 81, and canonical: true was replaced by pointer-form paths. All 9 sit in one subtree, 08. Notes/CapableMind/thinking-mirror/chamber/archive/orientation/.

Mechanism — SUPERSEDES the first reading filed earlier the same day. The earlier entry named "a job mirrors docs/thinking/David/" and pointed at the launchd agent. Wrong agent. Matching upstream content is not evidence of which path wrote it, and the launchd job targets a different folder entirely. The actual writer is /wrap-up §7, which rsyncs ~/_Dev/CapableMind-AI/docs/thinking/David/ → 08. Notes/CapableMind/thinking-mirror/ at every wrap. The 2026-08-22 wrap ran it at 23:42; vaultsync committed the result at 23:52 as a58fc00.

⚠ There are TWO mirrors of the same source into two different vault folders, and neither knows about the other:

writer	destination	state
/wrap-up §7 (every wrap)	08. Notes/CapableMind/thinking-mirror	live — 251 files, 0 diff from upstream
com.dglidden.thinking-mirror (launchd, 48 h)	00. Compass/00b. Constellations/CapableMind/thinking-mirror	dead — 151 files, 115 behind, frozen since 2026-03-13

The launchd job is failing and cannot say so. launchctl list reports last exit 1; the script ends rsync … > /dev/null 2>&1, so its own plist StandardOutPath receives nothing and the log has been 0 bytes since 10 Mar. Precedent for the cause is in session-ledger-2026-04-16.md: the vaultsync agent failed the same silent way for weeks — macOS TCC / Full Disk Access, rsync under launchd against an iCloud path, exit 23 — and was fixed by granting FDA. Same shape here, never fixed. ⚠ Exit 1 is not exit 23, so the TCC diagnosis is a strong hypothesis, NOT established. A manual --dry-run of the exact command succeeds (exit 0) when run interactively, which is consistent with TCC but does not prove it.

The reframe that resolves this: you do not edit a mirror. Applying the frontmatter spec to a derived tree is a category error — the edits cannot survive their next sync, and pass 2's edits to both mirror trees were void the moment they were written. This is not misbehaviour by the mirror.

Not fixed — the disposition is a design choice, not a [FIX]: exclude the subtree from the spec's scope · apply the spec upstream in CapableMind-AI · or declare mirrored notes not-spec-governed and say so in the spec. Steward's call.

Item 5 sharpened. 01. Daily/ holds 11 notes, the most recent 2025-09-04 — nearly a year old, and the Daily-Notes plugin is not configured. There is no dormant capture habit to revive; the practice would be built from nothing. 00a. _inbox holds 11 notes.

---

Current state — OPEN

1. ⚠ A defect of ours: see_canonical: "[[Index]]" in 09. Atlas of Roots/00. Atlas of Roots — Index.md, converted from canonical: 09. Atlas of Roots/index.md, a file that does not exist. The only Index.md notes are 08. Notes/Tools & Workflow/Index.md and a Catalan 00. Index/index.md. It resolves to the wrong note or none — 1 of the 3 pointers §3 wrote. Same basename flaw the jurist corrected as a number that afternoon, landed in an applied edit as a mechanism.
2. 194 unresolvable related targets, left bare and flagged by §6.
3. 63 residual canonical pointers — each a note that named an authority for itself and lost track of where it lives. Steward's eyes wanted here most: this is the population canonical was actually describing, invisible while 157 path-strings sat behind one field name.
4. 16 YAML parse errors, unchanged across both passes — never in scope, never addressed.
5. The actual goal has not been started. Everything so far is hygiene on an archive. "A regular workflow to have the important parts of our work captured there" — the capture practice, the thing that would make the vault a practice rather than a tidier archive — has not been designed. Do not let the frontmatter tail stand in for it.
6. ✅ RESOLVED 2026-08-23 — the two mirrors are now one, and it reports. Steward chose: keep /wrap-up §7, retire the launchd agent. Done and verified: agent unloaded · plist removed from ~/Library/LaunchAgents/ and from ~/dotfiles/config/capablemind/ (load-bearing — setup-capablemind.sh:135 copies every *.plist there into LaunchAgents, so leaving it would resurrect the retired job) · deployed script removed · stale tree deleted after three independent no-loss checks · /wrap-up §7 rewritten to name itself the only writer, forbid edits to the derived tree, and report the outcome with its exit code in §8 · spec bumped to v1.0.1 with principle 7 + §1a declaring mirrored trees out of scope. Commit f1c91d9. End state verified: live archive 251 files, 0 diff from upstream; stale tree gone; agent gone.

---

What remains — and what it is worth

Items 1–4 are the frontmatter tail: real, bounded, and not the goal. Item 5 is the goal.

• 1 is ours and wrong (one bad pointer) — smallest real debt, ~10 minutes once its correct target is decided.
• 2, 3 are steward-judgement work, not executor work: 73 pointer-form canonical values and 213 related targets need an eye that knows what the notes mean.
• 4 (16 YAML parse errors) has never been in scope and is a session-sized bite.
• 5 — the capture practice — has still not been started, and the 2026-08-23 check made it sharper, not smaller: 01. Daily/ holds 11 notes, newest 2025-09-04, and the Daily Notes plugin is unconfigured. There is no dormant habit to revive. ⚠ Note for whoever designs it: 00. Compass/00b. Constellations/CapableMind/ already contains daily-log/ and sessions/ folders. Read those before designing anything — a capture practice may already have been attempted here, and re-inventing over it would be the third duplicate mirror in spirit.