first push

2026-06-04 16:20:56 -05:00
parent a663de4f29
commit 392ae7bbe3
111 changed files with 5312 additions and 0 deletions
@@ -0,0 +1,45 @@
+---
+type: context-bundle
+status: active
+created: 2026-06-01
+updated: 2026-06-01
+tags: [agent, context]
+agent_written: true
+source_notes: []
+scope: vault-foundation
+refresh_strategy: on-demand
+---
+
+# Current Context
+
+## Scope
+Initial scaffold review for a Claude Code + Obsidian memory vault.
+
+## Active Priorities
+- Review scaffold folders.
+- Review templates.
+- Review root docs.
+- Plan REST API and CoWork plugin alignment.
+
+## Relevant Entities
+- [[projects/active/vault-foundation]]
+- [[resources/references/obsidian-local-rest-api]]
+- [[resources/people/jason-stedwell]]
+
+## Key Decisions
+- Separate durable knowledge from operational agent state.
+- Preserve portability across direct filesystem and API-driven clients.
+
+## Open Questions
+- Which note types should the plugin create directly?
+- Should decisions live by project only, or by date and project?
+- What should the session end hook write automatically?
+
+## Source Notes
+- [[journal/daily/2026-06-01]]
+- [[projects/active/vault-foundation]]
+
+## Related
+- [[projects/active/vault-foundation]]
+- [[journal/daily/2026-06-01]]
+- [[_agent/sessions/2026-06-01-2200-initial-vault-scaffold]]
@@ -0,0 +1,3 @@
+# Heartbeat
+
+Use this folder for periodic state snapshots, compression summaries, and maintenance reports.
@@ -0,0 +1,5 @@
+# episodic/
+
+Episodic memory: notable events and outcomes, what happened and when.
+
+> Placeholder so this folder persists (empty dirs are dropped by file copies and git). Safe to delete once the folder has real content.
@@ -0,0 +1,34 @@
+---
+type: semantic-memory
+status: active
+created: 2026-06-01
+updated: 2026-06-02
+tags: [agent, semantic-memory, preferences]
+agent_written: true
+source_notes: []
+confidence: medium
+last_reviewed: 2026-06-02
+---
+
+# Operator Preferences
+
+## Operator
+The **primary operator** of this vault is [[resources/people/bryan-gilliom]] (Bryan Gilliom, CEO of Message Point Media). Unless stated otherwise, "the operator" below refers to Bryan. [[resources/people/jason-stedwell]] is the vault's architect/creator and a possible future collaborator; preferences attributed to the vault's design originate with Jason and should not be assumed to be Bryan's until observed.
+
+## Fact / Pattern
+The vault is built around structured systems, clear roadmaps, durable documentation, and implementation-ready scaffolds. Bryan's own working preferences are not yet established and should be captured from real interactions rather than assumed.
+
+## Evidence
+The vault's design and request history (root documentation, structural guidance, setup walkthroughs, plugin-oriented direction) reflect Jason's design intent as architect. No direct evidence of Bryan's preferences has been recorded yet.
+
+## Recommendation or Implication
+Default to explicit files, repeatable workflows, and low-ambiguity structure when extending this vault. As Bryan uses the system, record observed preferences here with evidence and raise confidence accordingly — do not fabricate.
+
+## Review Notes
+Reconfirm and attribute preferences to Bryan once direct interactions provide evidence; revisit at the start of the plugin development workflow.
+
+## Related
+- [[CLAUDE]]
+- [[resources/people/bryan-gilliom]]
+- [[resources/people/jason-stedwell]]
+- [[projects/active/vault-foundation]]
@@ -0,0 +1,30 @@
+---
+type: working-memory
+status: active
+created: 2026-06-01T22:00
+updated: 2026-06-01T22:00
+tags: [agent, working-memory]
+agent_written: true
+source_notes: []
+expires_after: 48h
+---
+
+# Working Context
+
+## Active Focus
+Starter scaffold review and refinement.
+
+## Recent Decisions
+- Include root navigation notes.
+- Include config example for future REST/API use.
+
+## Open Threads
+- Add hooks, policies, and plugin CRUD docs.
+
+## Relevant Links
+- [[index]]
+- [[README]]
+
+## Related
+- [[_agent/context/current-context]]
+- [[projects/active/vault-foundation]]
@@ -0,0 +1,5 @@
+# briefs/
+
+Agent-generated briefs.
+
+> Placeholder so this folder persists (empty dirs are dropped by file copies and git). Safe to delete once the folder has real content.
@@ -0,0 +1,5 @@
+# drafts/
+
+Agent-generated drafts.
+
+> Placeholder so this folder persists (empty dirs are dropped by file copies and git). Safe to delete once the folder has real content.
@@ -0,0 +1,5 @@
+# summaries/
+
+Agent-generated summaries.
+
+> Placeholder so this folder persists (empty dirs are dropped by file copies and git). Safe to delete once the folder has real content.
@@ -0,0 +1,5 @@
+# synthesis/
+
+Agent-generated synthesis across notes.
+
+> Placeholder so this folder persists (empty dirs are dropped by file copies and git). Safe to delete once the folder has real content.
@@ -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]]
@@ -0,0 +1,3 @@
+# Active Skills
+
+Store reusable agent skills here with clear triggers, versioning, and expected outputs.
@@ -0,0 +1,5 @@
+# archived/
+
+Retired agent skills.
+
+> Placeholder so this folder persists (empty dirs are dropped by file copies and git). Safe to delete once the folder has real content.
@@ -0,0 +1,27 @@
+---
+type: context-bundle
+status: active
+created: {{date:YYYY-MM-DD}}
+updated: {{date:YYYY-MM-DD}}
+tags: [agent, context]
+agent_written: true
+source_notes: []
+scope:
+refresh_strategy: on-demand
+---
+
+# Context Bundle Title
+
+## Scope
+
+## Active Priorities
+
+## Relevant Entities
+
+## Key Decisions
+
+## Open Questions
+
+## Source Notes
+
+## Related
@@ -0,0 +1,23 @@
+---
+type: semantic-memory
+status: active
+created: {{date:YYYY-MM-DD}}
+updated: {{date:YYYY-MM-DD}}
+tags: [agent, semantic-memory]
+agent_written: true
+source_notes: []
+confidence: high
+last_reviewed: {{date:YYYY-MM-DD}}
+---
+
+# Semantic Memory Title
+
+## Fact / Pattern
+
+## Evidence
+
+## Recommendation or Implication
+
+## Review Notes
+
+## Related
@@ -0,0 +1,29 @@
+---
+type: session-log
+status: complete
+created: {{date:YYYY-MM-DDTHH:mm}}
+updated: {{date:YYYY-MM-DDTHH:mm}}
+tags: [agent, session]
+agent_written: true
+source_notes: []
+session_date: {{date:YYYY-MM-DD}}
+client: claude-code
+---
+
+# Session Log
+
+## Goal
+
+## Notes Read
+
+## Actions Taken
+
+## Decisions Made
+
+## Outputs Created
+
+## Open Threads
+
+## Suggested Next Step
+
+## Related
@@ -0,0 +1,22 @@
+---
+type: working-memory
+status: active
+created: {{date:YYYY-MM-DDTHH:mm}}
+updated: {{date:YYYY-MM-DDTHH:mm}}
+tags: [agent, working-memory]
+agent_written: true
+source_notes: []
+expires_after: 48h
+---
+
+# Working Context
+
+## Active Focus
+
+## Recent Decisions
+
+## Open Threads
+
+## Relevant Links
+
+## Related