echoes-vault-opencode 1.2.2 → 2.0.0

package/tui.tsx

@@ -6,7 +6,8 @@ import * as path from "node:path"
 
 type EchoesState = {
   version: number
-  pluginVersion: string
+  protocolVersion: string
+  engineVersion: string
   initialized: boolean
   session: {
     started: boolean
@@ -19,122 +20,121 @@ type EchoesState = {
     totalDailyLogs: number
     deprecatedPages: number
   }
+  lastWriter?: {
+    agent: string | null
+    adapterVersion: string | null
+  }
 }
 
-const STATE_PATH = path.join(process.cwd(), ".opencode", "echoes-state.json")
+type EchoesMarker = {
+  protocolVersion?: string
+}
 
-const readState = (): EchoesState | null => {
+type VaultSnapshot = {
+  marker: EchoesMarker | null
+  state: EchoesState | null
+}
+
+const readJson = <Value,>(file: string): Value | null => {
   try {
-    const raw = fs.readFileSync(STATE_PATH, "utf-8")
-    return JSON.parse(raw) as EchoesState
+    return JSON.parse(fs.readFileSync(file, "utf-8")) as Value
   } catch {
     return null
   }
 }
 
-const tui: TuiPlugin = async (api) => {
+const readSnapshot = (workspace: string): VaultSnapshot => ({
+  marker: readJson<EchoesMarker>(path.join(workspace, "EchoesVault", ".echoes-vault.json")),
+  state: readJson<EchoesState>(path.join(workspace, ".echoes-vault", "state.json")),
+})
+
+const tui: TuiPlugin = async (api, _options, meta) => {
   const theme = api.theme.current
+  const workspace = api.state.path.worktree || api.state.path.directory || process.cwd()
 
   api.slots.register({
     slots: {
       sidebar_content() {
-        const [state, setState] = createSignal<EchoesState | null>(readState())
-
-        const interval = setInterval(() => setState(readState()), 3000)
+        const [snapshot, setSnapshot] = createSignal<VaultSnapshot>(readSnapshot(workspace))
+        const interval = setInterval(() => setSnapshot(readSnapshot(workspace)), 3000)
         onCleanup(() => clearInterval(interval))
 
+        const markerReady = () => snapshot().marker?.protocolVersion === "1.0.0"
+        const state = () => snapshot().state
+
         const statusColor = () => {
-          const s = state()
-          if (!s || !s.initialized) return theme.error
-          if (s.session.saved) return theme.accent
-          if (s.session.started) return theme.success
+          if (!markerReady()) return theme.error
+          if (state()?.session.saved) return theme.accent
+          if (state()?.session.started) return theme.success
           return theme.warning
         }
 
         const statusLabel = () => {
-          const s = state()
-          if (!s || !s.initialized) return "Not Activated"
-          if (s.session.saved) return "Memory Saved"
-          if (s.session.started) return "Active"
+          const marker = snapshot().marker
+          if (!marker) return "Not Initialized"
+          if (!markerReady()) return `Unsupported Protocol ${marker.protocolVersion ?? "?"}`
+          if (!state()) return "Ready — Local State Missing"
+          if (state()?.session.saved) return "Memory Saved"
+          if (state()?.session.started) return "Active"
           return "Session Not Started"
         }
 
+        const pages = () => state()?.stats?.totalPages ?? 0
         const vaultHealthColor = () => {
-          const pages = state()?.stats?.totalPages ?? 0
-          if (pages > 200) return theme.error
-          if (pages >= 170) return theme.warning
+          if (pages() > 200) return theme.error
+          if (pages() >= 170) return theme.warning
           return theme.success
         }
 
-        const vaultUsagePercent = () => {
-          const pages = state()?.stats?.totalPages ?? 0
-          return Math.round((pages / 200) * 100)
-        }
-
-        const statusDesc = () => {
-          const s = state()
-          if (!s || !s.initialized) return null
-          if (s.session.saved) return "Vault memorized session data"
-          if (s.session.started) return null
-          return null
+        const statusCommand = () => {
+          if (!snapshot().marker) return ["/echoes-init", "to initialize or migrate"] as const
+          if (!markerReady()) return ["/echoes-status", "to inspect compatibility"] as const
+          if (state()?.session.saved) return null
+          if (state()?.session.started) return ["/echoes-end", "before closing"] as const
+          return ["/echoes-start", "to restore context"] as const
         }
 
-        const statusCmd = () => {
-          const s = state()
-          if (!s || !s.initialized) return "/echoes-init"
-          if (s.session.saved) return null
-          if (s.session.started) return "/echoes-end"
-          return "/echoes-start"
-        }
-
-        const statusCmdHint = () => {
-          const s = state()
-          if (!s || !s.initialized) return "to activate vault"
-          if (s.session.saved) return null
-          if (s.session.started) return "before closing"
-          return "to load context"
-        }
-
-        const vaultHealthSection = () => {
-          const s = state()
-          if (!s || !s.initialized) return null
-          const pages = s.stats?.totalPages ?? 0
-          return (
-            <box flexDirection="column">
-              <text>{""}</text>
-              <box flexDirection="row">
-                <text fg={vaultHealthColor()}>{"• "}</text>
-                <text fg={theme.text}><b>Vault Health</b></text>
-              </box>
-              <text fg={theme.textMuted}>{"Pages: "}{pages}</text>
-              <text fg={theme.textMuted}>{"Usage: "}{vaultUsagePercent()}{"%"}</text>
-              {pages > 200 ? (
-                <text fg={theme.textMuted}>{"Consider migrating to RAG"}</text>
-              ) : null}
-            </box>
-          )
+        const lastWriter = () => {
+          const writer = state()?.lastWriter
+          if (!writer?.agent) return null
+          return `${writer.agent}${writer.adapterVersion ? ` ${writer.adapterVersion}` : ""}`
         }
 
         return (
           <box flexDirection="column">
             <box flexDirection="row">
-              <text fg={statusColor()}><b>• </b></text>
+              <text fg={statusColor()}><b>{"• "}</b></text>
               <text fg={theme.textMuted}><b>Echoes</b></text>
               <text fg={theme.text}><b>Vault</b></text>
-              <text fg={theme.textMuted}> v{state()?.pluginVersion ?? ""}</text>
+              <text fg={theme.textMuted}>{meta.version ? ` v${meta.version}` : ""}</text>
             </box>
             <text fg={statusColor()}>{statusLabel()}</text>
-            {statusDesc() && (
-              <text fg={theme.textMuted}>{statusDesc()}</text>
-            )}
-            {statusCmd() && (
+            {statusCommand() ? (
               <box flexDirection="row">
                 <text fg={theme.textMuted}>Run </text>
-                <text fg={theme.text}>{statusCmd()}</text>
-                <text fg={theme.textMuted}> {statusCmdHint()}</text>
+                <text fg={theme.text}>{statusCommand()?.[0]}</text>
+                <text fg={theme.textMuted}> {statusCommand()?.[1]}</text>
+              </box>
+            ) : null}
+            {markerReady() ? (
+              <box flexDirection="column">
+                <text>{""}</text>
+                <box flexDirection="row">
+                  <text fg={vaultHealthColor()}>{"• "}</text>
+                  <text fg={theme.text}><b>Vault Health</b></text>
+                </box>
+                <text fg={theme.textMuted}>Pages: {pages()}</text>
+                <text fg={theme.textMuted}>Daily entries: {state()?.stats?.totalDailyLogs ?? 0}</text>
+                <text fg={theme.textMuted}>Protocol: {snapshot().marker?.protocolVersion}</text>
+                {state()?.engineVersion ? (
+                  <text fg={theme.textMuted}>Engine: {state()?.engineVersion}</text>
+                ) : null}
+                {lastWriter() ? <text fg={theme.textMuted}>Last writer: {lastWriter()}</text> : null}
+                {pages() > 200 ? (
+                  <text fg={theme.textMuted}>Prefer targeted search over loading all pages</text>
+                ) : null}
               </box>
-            )}
-            {vaultHealthSection()}
+            ) : null}
           </box>
         )
       },

package/prompts/skills/echoes-append-to-daily-log.md

@@ -1,22 +0,0 @@
----
-name: echoes_append_to_daily_log
-description: Append an intermediate technical note or decision to today's daily log immediately after completing a sub-task.
----
-
-# TOOL USAGE: echoes_append_to_daily_log
-You are equipped with a scratchpad tool to manage your cognitive load. You MUST use this tool to offload important context into `EchoesVault/daily/YYYY-MM-DD.md`.
-
-## 🎯 EXACT TRIGGER CONDITIONS (WHEN TO CALL THIS TOOL)
-Do NOT use this tool randomly. You MUST invoke this tool IMMEDIATELY in the current response if ANY of the following specific events occur:
-1. **Task Completion:** We successfully finish a logical unit of work (e.g., a script works, a bug is verified as fixed, tests pass) BEFORE starting the next user request.
-2. **Context Switch:** The user asks to change focus (e.g., "Now let's work on the frontend" after we just worked on the backend).
-3. **Architectural Agreement:** We just agreed on a core rule, library choice, database schema, or API contract.
-4. **Explicit User Command:** The user explicitly tells you to "take a note", "remember this", "save our progress", or "log this".
-
-## ⚠️ RULES
-1. **Be Concise:** Write ONLY dry facts and bullet points (e.g., "Refactored AuthGuard to use JWT refresh tokens"). No conversational filler.
-2. **Do Not Interrupt Flow:** Make the tool call silently or add a brief confirmation in your response like: *"Logged the AuthGuard update to the daily vault. Ready for the frontend."*
-3. **No File Overwrites:** This tool ONLY appends to the end of today's file.
-
-## 📥 PAYLOAD PARAMETERS
-- `logEntry`: (String) The markdown-formatted bullet points to append.

package/prompts/skills/echoes-create-or-update-page.md

@@ -1,22 +0,0 @@
----
-name: echoes_create_or_update_page
-description: Atomically create a new markdown page or update an existing one in EchoesVault/pages/, automatically updating the index.
----
-
-# TOOL USAGE: echoes_create_or_update_page
-Use this tool when a new global concept has been defined or an existing component's architecture has fundamentally changed during our session. This allows you to update the encyclopedia immediately.
-
-## 🎯 WHEN TO USE
-- We finalized a new database schema or API contract.
-- A major refactoring occurred, rendering previous documentation inaccurate.
-- You need to document a newly integrated library or hardware component.
-
-## ⚠️ RULES
-1. **Strict YAML Frontmatter:** Every page MUST include a YAML metadata block at the top (type, stack, status).
-2. **Index Sync:** When you create a new file, you must provide a one-sentence description for the index. The system will automatically append it to `index.md`.
-3. **Deprecate, Don't Delete:** If you are rewriting an existing page completely because the logic changed, consider if you should instead create a new page (e.g., `api-v2.md`) and update the old one with a `> [!warning] DEPRECATED` callout via this tool.
-
-## 📥 PAYLOAD PARAMETERS
-- `filename`: (String) The exact filename without paths (e.g., `auth-architecture.md`).
-- `content`: (String) The full markdown content of the page, starting with the YAML frontmatter.
-- `indexDescription`: (String) A one-sentence description of the file. Required if this is a newly created file. Format: "- [[filename]]: description".

package/prompts/skills/echoes-search-vault-pages.md

@@ -1,19 +0,0 @@
----
-name: echoes_search_vault_pages
-description: Search the EchoesVault for specific concepts, keywords, or implementation details.
----
-
-# TOOL USAGE: echoes_search_vault_pages
-You are the EchoesVault Keeper. If you encounter a concept, API, or architectural pattern in our conversation that you suspect is documented but you lack the full context, use this tool BEFORE generating code.
-
-## 🎯 WHEN TO USE
-- The user asks to modify an existing component, but its structure is not in your current context window.
-- You need to verify if an Architectural Decision Record (ADR) exists for a specific technology.
-- You want to fulfill the "Read-Before-Write" core rule.
-
-## ⚠️ RULES
-1. **Targeted Queries:** Use specific technical keywords (e.g., "AuthGuard", "esp32 pinout", "database schema") rather than natural language questions.
-2. **Handle Deprecations:** If the search returns a file marked with `> [!warning] DEPRECATED`, look for the link to the new relevant file and read that instead.
-
-## 📥 PAYLOAD PARAMETERS
-- `query`: (String) The specific keyword or short phrase to search for across the `pages/` directory.