plugin 0.2.2

2026-06-05 00:49:20 -05:00
parent 67acf8fd52
commit d37b248747
115 changed files with 5565 additions and 0 deletions
@@ -0,0 +1,53 @@
+---
+type: session-log
+status: complete
+created: 2026-06-01T22:00
+updated: 2026-06-01T22:00
+tags: [agent, session, scaffold]
+agent_written: true
+source_notes: []
+session_date: 2026-06-01
+client: claude-code
+---
+
+# Session Log
+
+## Goal
+Create a reviewable starter scaffold for a memory-oriented Obsidian vault.
+
+## Notes Read
+- [[CLAUDE]]
+- [[STRUCTURE]]
+- [[BOOTSTRAP]]
+- [[spinup]]
+
+## Actions Taken
+- Created the core folder tree.
+- Added root operating documents.
+- Added templates for high-value note types.
+- Seeded example operational notes.
+- Added API config example and review index.
+
+## Decisions Made
+- Include `_agent/` as a first-class operational layer.
+- Add a root `index.md` and `README.md` for review and navigation.
+- Include `.env.example` but not actual config.
+
+## Outputs Created
+- Starter vault scaffold
+- Root docs
+- Templates
+- Seed notes
+
+## Open Threads
+- Add plugin integration spec.
+- Add startup/shutdown hooks.
+- Add archive policy and sync policy notes.
+
+## Suggested Next Step
+Review the scaffold and then generate a plugin spec plus note CRUD contract.
+
+## Related
+- [[projects/active/vault-foundation]]
+- [[_agent/context/current-context]]
+- [[journal/daily/2026-06-01]]
@@ -0,0 +1,58 @@
+---
+type: session-log
+status: complete
+created: 2026-06-02T16:18
+updated: 2026-06-02T16:18
+tags: [agent, session, plugin, rest-api, goldbrain]
+agent_written: true
+source_notes: ["resources/references/obsidian-local-rest-api.md", "references-only/reference-obsidian-memory.plugin"]
+session_date: 2026-06-02
+client: cowork
+---
+
+# Session Log
+
+## Goal
+Prep the goldbrain vault from the reference materials, stand up and verify the Obsidian Local REST API, and build the `goldbrain-memory` CoWork plugin ready to hand off to Bryan.
+
+## Notes Read
+- [[BOOTSTRAP]], [[STRUCTURE]], [[CLAUDE]], [[spinup]]
+- [[_agent/memory/semantic/operator-preferences]], [[resources/people/bryan-gilliom]]
+- [[resources/references/obsidian-local-rest-api]]
+
+## Actions Taken
+Reviewed the references-only materials (reference vault + the existing `obsidian-memory` plugin + REST API docs). Found the vault scaffold was structurally complete but plugin/REST-readiness was thin, so filled the stub API reference with a full command reference + memory routing map and refreshed `.env.example` for goldbrain.
+
+Diagnosed a `502` from the reverse proxy: the Obsidian Local REST API plugin was bound to `127.0.0.1`. Changed binding to `0.0.0.0` and added the proxy hostname to the cert SAN; API came up clean (v4.1.2, valid TLS). Verified a full write → read → list → delete round-trip.
+
+Confirmed the scaffold copy into the live vault, then created the 24 empty subfolders that file-copy had dropped (placeholder READMEs) so the full required tree resolves over the API. Marked spin-up steps complete.
+
+Built the `goldbrain-memory` plugin (skill + 4 reference files) adapted to: operator = Bryan, base URL `goldbrainapi.mpm.to`, vault-root paths, goldbrain's PARA + `_agent/` layout, canonical frontmatter, HHMM session logs. Live-tested every documented operation.
+
+Fixed two bugs found during testing: (1) v4.1.2 PATCH requires the **full `::`-delimited heading path** (bare subheading name returns `invalid-target`); (2) `[[wikilinks]]` in YAML frontmatter break in Obsidian's reading view — migrated all 23 affected notes to move links into a body `## Related` section, retired the `related:` frontmatter field, and codified the rule in STRUCTURE.md / BOOTSTRAP.md and the plugin docs.
+
+## Decisions Made
+- Vault addressed at root (no `Projects/agents/` prefix) — goldbrain is a dedicated vault.
+- API base URL `https://goldbrainapi.mpm.to`; no `-k` needed (valid cert behind reverse proxy → `192.168.86.15:27124`).
+- API key hardcoded in the plugin only, never written into the vault (per the vault's own safety rule).
+- Rule established: no `[[wikilinks]]` in frontmatter; all cross-references live in a body `## Related` section. `source_notes` holds plain relative path strings.
+- PATCH heading targets must use the full `H1::H2` path.
+
+## Outputs Created
+- `goldbrain-memory.plugin` — installable CoWork plugin (delivered to the goldbrain root folder)
+- Full REST command reference + routing map in [[resources/references/obsidian-local-rest-api]]
+- 24 folder-placeholder READMEs; 23 notes + templates migrated for the frontmatter-link fix
+
+## Open Threads
+- [ ] Validate Claude Code direct filesystem access to the vault host (spin-up step 6).
+- [ ] Capture Bryan's real preferences in [[_agent/memory/semantic/operator-preferences]] from actual use — do not fabricate.
+- [ ] Begin the daily/session/review operating rhythm (spin-up step 8).
+
+## Suggested Next Step
+Hand off `goldbrain-memory.plugin` to Bryan, install it, and run one live session to confirm the skill triggers and that load/write land correctly through the plugin.
+
+## Related
+- [[projects/active/vault-foundation]]
+- [[resources/references/obsidian-local-rest-api]]
+- [[resources/people/bryan-gilliom]]
+- [[BOOTSTRAP]]