Rewrite as user-agnostic "quicksilver" plugin

Rename echo-memory/ECHO -> quicksilver/Quicksilver throughout and make the plugin self-configuring per operator: - First-run flow: prompt for endpoint FQDN, API key, and operator name/role; verify; persist to a local config file (~/.quicksilver/quicksilver-config.json). - Two-layer setup detection: local config (is this install configured?) + in-vault marker (is the vault scaffolded?). Key never stored in the vault. - Replace hardcoded endpoint/key in all curl examples with $BASE/$AUTH loaded from the config file. - Genericize all "Jason"/"Bryan goldbrain"/MPM/wISP references to "the operator"; keep Jason as architect credit (README + plugin.json author). - Personalize memory to the configured operator (name/role seeded into operator-preferences and the vault marker). - Add echo-vault.md -> quicksilver-vault.md rename migration. - Rebuild packaged quicksilver.plugin; add docs/quicksilver-plan.md. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-07 08:06:51 -05:00
parent 3ba73b2d48
commit d90abde29e
25 changed files with 400 additions and 167 deletions
@@ -0,0 +1,12 @@
+# Quicksilver Memory Vault
+
+This Obsidian vault is the persistent memory substrate ("second brain") for its operator. It is read and written across Claude / CoWork sessions through the Obsidian Local REST API.
+
+**This vault holds data, not logic.** All operating procedure — how the vault is bootstrapped, how notes are routed, the taxonomy, frontmatter conventions, and safety rules — lives in the **`quicksilver` plugin**, which is the single source of truth. There are intentionally no `CLAUDE.md` / `BOOTSTRAP.md` / `STRUCTURE.md` control docs in this vault; updating or porting Quicksilver means updating or installing the plugin, not editing files here.
+
+- **Layout:** see the plugin's `references/vault-layout.md`.
+- **Operating contract & safety:** see the plugin's `references/operating-contract.md`.
+- **Bootstrap / repair:** see the plugin's `references/bootstrap.md`.
+- **Version marker:** `_agent/quicksilver-vault.md` records the schema version and bootstrap date.
+
+Folders: `inbox/`, `journal/`, `projects/`, `areas/`, `resources/`, `decisions/`, `reviews/`, `archive/`, and the agent subtree `_agent/`.
@@ -0,0 +1,25 @@
+---
+type: context-bundle
+status: active
+created: {{DATE}}
+updated: {{DATE}}
+tags: [agent, context]
+agent_written: true
+source_notes: []
+scope:
+refresh_strategy: on-demand
+---
+
+# Current Context
+
+## Scope
+<!-- The single active scope. Replaced (PATCH replace) on each scope switch. -->
+
+## Scope History
+<!-- Dated bullets of prior scopes, newest first: `- {{DATE}}: <prior scope summary>`. Trim to ~10. -->
+
+## Active Priorities
+
+## Open Questions
+
+## Related
@@ -0,0 +1,3 @@
+# Inbox — Captures
+
+Quick captures land here as date-prefixed lines (`- {{DATE}}: <thing>`), one per line, via POST. Triage routes durable items to their proper home (see the quicksilver skill's Inbox Triage). Don't delete originals on triage — the processing log is the audit trail.
@@ -0,0 +1,32 @@
+---
+type: semantic-memory
+status: active
+created: {{DATE}}
+updated: {{DATE}}
+tags: [agent, semantic-memory, operator]
+agent_written: true
+source_notes: []
+confidence: low
+last_reviewed: {{DATE}}
+---
+
+# Operator Preferences
+
+## Operator
+{{OPERATOR}} — {{ROLE}}.
+<!-- Captured at first run. Expand to one paragraph as facts are confirmed; do not fabricate beyond what the operator stated. -->
+
+## Fact / Pattern
+<!-- Promoted, deduped, timeless rules. No date prefix. Add only when a rule is stable. -->
+
+## Observations
+<!-- Timestamped raw observations. Default landing zone for new evidence: `- {{DATE}}: ...` -->
+
+## Evidence
+
+## Recommendation or Implication
+
+## Review Notes
+Seeded empty at bootstrap ({{DATE}}). Raise confidence once preferences are confirmed through day-to-day use.
+
+## Related
@@ -0,0 +1,22 @@
+---
+type: reference
+status: active
+created: {{DATE}}
+updated: {{DATE}}
+tags: [agent, system, marker]
+agent_written: true
+source_notes: []
+schema_version: 1
+bootstrapped: {{DATE}}
+managed_by: quicksilver-plugin
+operator: {{OPERATOR}}
+---
+
+# Quicksilver Vault Marker
+
+This file marks the vault as bootstrapped by the **quicksilver plugin** and records its schema version. The plugin's loading procedure GETs this file as its "is this vault set up?" probe; a `404` triggers a fresh bootstrap.
+
+- `schema_version` — bumped by the plugin when the vault layout changes; a mismatch is the hook for a migration pass (see `references/bootstrap.md`).
+- `operator` — the vault owner's name, captured at first run. Non-secret identity only.
+- **No secret is ever stored here.** The API endpoint and key live in the local config file (`~/.quicksilver/quicksilver-config.json`), never in the vault.
+- Do not hand-edit. The plugin owns this file.
@@ -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
@@ -0,0 +1,25 @@
+---
+type: decision
+status: complete
+created: {{date:YYYY-MM-DD}}
+updated: {{date:YYYY-MM-DD}}
+tags: [decision]
+agent_written: true
+source_notes: []
+decision_date: {{date:YYYY-MM-DD}}
+impact: medium
+---
+
+# Decision Title
+
+## Context
+
+## Decision
+
+## Rationale
+
+## Consequences
+
+## Follow-Up
+
+## Related
@@ -0,0 +1,25 @@
+---
+type: daily-note
+status: active
+created: {{date:YYYY-MM-DD}}
+updated: {{date:YYYY-MM-DD}}
+tags: [daily, journal]
+agent_written: false
+source_notes: []
+---
+
+# {{date:YYYY-MM-DD}}
+
+## Top Priorities
+
+## Schedule / Commitments
+
+## Open Loops
+
+## Notes
+
+## Context for AI
+
+## Agent Log
+
+## Related
@@ -0,0 +1,26 @@
+---
+type: review
+status: active
+created: {{date:gggg-[W]WW}}
+updated: {{date:gggg-[W]WW}}
+tags: [review, weekly]
+agent_written: true
+source_notes: []
+period: weekly
+---
+
+# Weekly Review
+
+## Completed Work
+
+## Open Loops
+
+## Stale Projects
+
+## Decisions
+
+## Priorities Next Week
+
+## Agent Notes
+
+## Related
@@ -0,0 +1,31 @@
+---
+type: project
+status: active
+created: {{date:YYYY-MM-DD}}
+updated: {{date:YYYY-MM-DD}}
+tags: [project]
+agent_written: false
+source_notes: []
+owner:
+review_cycle: weekly
+---
+
+# Project Name
+
+## Purpose
+
+## Status
+
+## Goals
+
+## Current Context
+
+## Open Loops
+
+## Key Decisions
+
+## Related Notes
+
+## Session History
+
+## Related