echoes-vault-opencode 1.0.34 → 1.0.36

package/index.ts

@@ -19,6 +19,45 @@ type VaultPaths = {
   assets: string
 }
 
+type EchoesState = {
+  version: number
+  initialized: boolean
+  session: {
+    started: boolean
+    saved: boolean
+    lastStart: string | null
+    lastSave: string | null
+  }
+}
+
+const STATE_FILENAME = ".opencode/echoes-state.json"
+
+const defaultState = (): EchoesState => ({
+  version: 1,
+  initialized: false,
+  session: {
+    started: false,
+    saved: false,
+    lastStart: null,
+    lastSave: null,
+  },
+})
+
+const readState = async (directory: string): Promise<EchoesState> => {
+  try {
+    const raw = await fs.readFile(path.join(directory, STATE_FILENAME), "utf-8")
+    return JSON.parse(raw) as EchoesState
+  } catch {
+    return defaultState()
+  }
+}
+
+const writeState = async (directory: string, state: EchoesState): Promise<void> => {
+  const filePath = path.join(directory, STATE_FILENAME)
+  await fs.mkdir(path.dirname(filePath), { recursive: true })
+  await fs.writeFile(filePath, JSON.stringify(state, null, 2))
+}
+
 const resolveVaultPaths = (directory: string): VaultPaths => {
   const vault = path.join(directory, "EchoesVault")
   return {
@@ -58,72 +97,6 @@ const toPageFilename = (name: string): string => {
 
 const toPageSlug = (filename: string): string => filename.replace(/\.md$/, "")
 
-// --------------- State file management ---------------
-
-type SessionState = {
-  started: boolean
-  saved: boolean
-  lastStart: string | null
-  lastSave: string | null
-}
-
-type VaultState = {
-  version: number
-  initialized: boolean
-  session: SessionState
-}
-
-const STATE_FILE = ".state.json"
-
-const defaultState = (): VaultState => ({
-  version: 1,
-  initialized: true,
-  session: {
-    started: false,
-    saved: false,
-    lastStart: null,
-    lastSave: null,
-  },
-})
-
-async function readState(vaultDir: string): Promise<VaultState> {
-  try {
-    const raw = await fs.readFile(path.join(vaultDir, STATE_FILE), "utf-8")
-    return JSON.parse(raw) as VaultState
-  } catch {
-    return defaultState()
-  }
-}
-
-async function writeState(vaultDir: string, state: VaultState): Promise<void> {
-  await fs.mkdir(vaultDir, { recursive: true })
-  await fs.writeFile(path.join(vaultDir, STATE_FILE), JSON.stringify(state, null, 2))
-}
-
-async function markStarted(vaultDir: string): Promise<void> {
-  const state = await readState(vaultDir)
-  state.initialized = true
-  state.session.started = true
-  state.session.lastStart = new Date().toISOString()
-  await writeState(vaultDir, state)
-}
-
-async function markSaved(vaultDir: string): Promise<void> {
-  const state = await readState(vaultDir)
-  state.session.saved = true
-  state.session.lastSave = new Date().toISOString()
-  await writeState(vaultDir, state)
-}
-
-async function resetSession(vaultDir: string): Promise<VaultState> {
-  const state = await readState(vaultDir)
-  state.session.started = false
-  state.session.saved = false
-  // preserve timestamps for display
-  await writeState(vaultDir, state)
-  return state
-}
-
 const ECHOES_INIT_COMMAND = `---
 description: Initialize EchoesVault — create directory structure and index.md
 agent: build
@@ -157,7 +130,9 @@ You are an AI developer agent equipped with persistent memory. Your memory is a
 
 ## \ud83d\ude80 ACTION
 
-The memory system has been initialized. Use your file reading tool to read the current \`EchoesVault/index.md\`. 
+**Step 0:** Call the \`echoes_activate_vault\` tool immediately to register the vault as activated in the status tracker.
+
+Then use your file reading tool to read the current \`EchoesVault/index.md\`.
 If the index is empty or missing, acknowledge the initialization of a fresh vault. Otherwise, acknowledge your understanding of these rules with a brief message and list the key concepts already present in the index.
 `
 
@@ -188,6 +163,7 @@ Here is the concatenated work log from our LAST 3 SESSIONS (\`EchoesVault/daily/
 </recent_logs>
 
 ## ACTION
+0. **Register:** Call the \`echoes_start_session\` tool immediately to mark this session as started in the status tracker.
 1. **Restore:** Analyze the \`<recent_logs>\` to understand the current trajectory. Briefly summarize where we left off and what our immediate next steps should be today.
 2. **Linting:** Briefly review the \`<index>\`. Do you spot any duplicate concepts, obvious contradictions, or orphan topics that should be merged? If so, propose a quick refactoring plan. If the index is clean, simply say: "Index is healthy. Ready to code."
 `
@@ -383,8 +359,10 @@ const OpenCodeEchoes: Plugin = async ({ directory }) => {
   await ensureCommands(directory)
   await ensureSkills(directory)
 
-  // Reset session state on every plugin init (new OpenCode session)
-  await resetSession(paths.vault)
+  const state = await readState(directory)
+  state.session.started = false
+  state.session.saved = false
+  await writeState(directory, state)
 
   return {
     config: async (input) => {
@@ -485,7 +463,10 @@ const OpenCodeEchoes: Plugin = async ({ directory }) => {
 
           await fs.writeFile(idxFile, indexContent)
 
-          await markSaved(paths.vault)
+          const st = await readState(directory)
+          st.session.saved = true
+          st.session.lastSave = new Date().toISOString()
+          await writeState(directory, st)
 
           return [
             `✅ Memory committed to EchoesVault.`,
@@ -512,9 +493,6 @@ const OpenCodeEchoes: Plugin = async ({ directory }) => {
           const timestamp = new Date().toISOString()
           const entry = `### Scratchpad — ${timestamp}\n\n${args.logEntry}\n\n`
           await fs.appendFile(dailyFile, entry)
-
-          await markStarted(paths.vault)
-
           return `✅ Scratchpad note saved to EchoesVault/daily/${today}.md`
         },
       }),
@@ -529,7 +507,6 @@ const OpenCodeEchoes: Plugin = async ({ directory }) => {
         async execute(args, _ctx) {
           await ensureVaultDirs(paths)
           const results: string[] = []
-          await markStarted(paths.vault)
           try {
             const files = (await fs.readdir(paths.pages)).filter((f) =>
               f.endsWith(".md")
@@ -576,7 +553,6 @@ const OpenCodeEchoes: Plugin = async ({ directory }) => {
         },
         async execute(args, _ctx) {
           await ensureVaultDirs(paths)
-          await markStarted(paths.vault)
           const fileName = toPageFilename(args.filename)
           const pageFile = path.join(paths.pages, fileName)
 
@@ -606,6 +582,30 @@ const OpenCodeEchoes: Plugin = async ({ directory }) => {
           return parts.join("\n")
         },
       }),
+      echoes_activate_vault: tool({
+        description:
+          "Mark the EchoesVault as activated. Called automatically during /echoes-init to register the vault in the status tracker.",
+        args: {},
+        async execute(_args, _ctx) {
+          const st = await readState(directory)
+          st.initialized = true
+          await writeState(directory, st)
+          return "EchoesVault activated."
+        },
+      }),
+      echoes_start_session: tool({
+        description:
+          "Mark the current EchoesVault session as started. Called automatically during /echoes-start to update the status tracker.",
+        args: {},
+        async execute(_args, _ctx) {
+          const st = await readState(directory)
+          st.session.started = true
+          st.session.saved = false
+          st.session.lastStart = new Date().toISOString()
+          await writeState(directory, st)
+          return "EchoesVault session started."
+        },
+      }),
     },
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "echoes-vault-opencode",
-  "version": "1.0.34",
+  "version": "1.0.36",
   "description": "EchoesVault — persistent memory plugin for OpenCode. Obsidian-style knowledge base with daily logs, encyclopedia pages, and session resumption.",
   "type": "module",
   "main": "index.ts",

package/tui.tsx

@@ -1,154 +1,76 @@
 /** @jsxImportSource @opentui/solid */
-import { readFileSync } from "node:fs"
-import { join } from "node:path"
 import type { TuiPlugin } from "@opencode-ai/plugin/tui"
+import { createSignal, onCleanup } from "solid-js"
+import * as fs from "node:fs"
+import * as path from "node:path"
 
-type SessionState = {
-  started: boolean
-  saved: boolean
-  lastStart: string | null
-  lastSave: string | null
-}
-
-type VaultState = {
+type EchoesState = {
   version: number
   initialized: boolean
-  session: SessionState
+  session: {
+    started: boolean
+    saved: boolean
+    lastStart: string | null
+    lastSave: string | null
+  }
 }
 
-type VaultStatus = "uninitialized" | "idle" | "working" | "saved"
+const STATE_PATH = path.join(process.cwd(), ".opencode", "echoes-state.json")
 
-function readVaultState(dir: string): VaultState | null {
+const readState = (): EchoesState | null => {
   try {
-    return JSON.parse(readFileSync(join(dir, "EchoesVault", ".state.json"), "utf-8"))
+    const raw = fs.readFileSync(STATE_PATH, "utf-8")
+    return JSON.parse(raw) as EchoesState
   } catch {
     return null
   }
 }
 
-function getStatus(state: VaultState | null): VaultStatus {
-  if (!state || !state.initialized) return "uninitialized"
-  if (state.session.saved) return "saved"
-  if (state.session.started) return "working"
-  return "idle"
-}
-
-function timeAgo(iso: string | null): string {
-  if (!iso) return ""
-  const diff = Date.now() - new Date(iso).getTime()
-  const mins = Math.floor(diff / 60000)
-  if (mins < 1) return "just now"
-  if (mins < 60) return `${mins}m ago`
-  const hours = Math.floor(mins / 60)
-  if (hours < 24) return `${hours}h ago`
-  const days = Math.floor(hours / 24)
-  return `${days}d ago`
-}
-
-function formatTime(iso: string | null): string {
-  if (!iso) return ""
-  return new Date(iso).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" })
-}
-
-const STATUS_META: Record<VaultStatus, { label: string; description: string }> = {
-  uninitialized: {
-    label: "Vault not initialized",
-    description: 'Run /echoes-init to create EchoesVault',
-  },
-  idle: {
-    label: "Vault idle",
-    description: 'Run /echoes-start to restore context',
-  },
-  working: {
-    label: "Vault active",
-    description: 'Run /echoes-end before closing to save session',
-  },
-  saved: {
-    label: "Session saved",
-    description: 'Memory committed to EchoesVault',
-  },
-}
-
-const STATUS_COLOR: Record<VaultStatus, string> = {
-  uninitialized: "error",
-  idle: "warning",
-  working: "success",
-  saved: "accent",
-}
-
 const tui: TuiPlugin = async (api) => {
   const theme = api.theme.current
-  const dir = api.state.path.directory
 
   api.slots.register({
     slots: {
       sidebar_content() {
-        const state = readVaultState(dir)
-        const status = getStatus(state)
-        const meta = STATUS_META[status]
-        const colorKey = STATUS_COLOR[status]
-        const color = (theme as any)[colorKey] ?? theme.text
-
-        const startedAgo = timeAgo(state?.session.lastStart ?? null)
-        const savedTime = formatTime(state?.session.lastSave ?? null)
-        const savedAgo = timeAgo(state?.session.lastSave ?? null)
+        const [state, setState] = createSignal<EchoesState | null>(readState())
+
+        const interval = setInterval(() => setState(readState()), 3000)
+        onCleanup(() => clearInterval(interval))
+
+        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
+          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"
+          return "Session Not Started"
+        }
+
+        const statusDesc = () => {
+          const s = state()
+          if (!s || !s.initialized)
+            return "Run /echoes-init to activate vault"
+          if (s.session.saved)
+            return "Vault memorized session data"
+          if (s.session.started)
+            return "Run /echoes-end before closing"
+          return "Run /echoes-start to load context"
+        }
 
         return (
           <box flexDirection="column">
-            <box border="all" borderStyle="single" paddingX={1} paddingY={0}>
-              <text fg={theme.text}>
-                <b>EchoesVault</b>
-              </text>
-            </box>
-
-            <box paddingX={1} paddingY={0} marginTop={1}>
-              <text fg={color}>
-                <b>{meta.label}</b>
-              </text>
-            </box>
-
-            <box paddingX={1} paddingY={0}>
-              <text fg={theme.textMuted}>{meta.description}</text>
-            </box>
-
-            {startedAgo && (
-              <box paddingX={1} paddingY={0}>
-                <text fg={theme.textMuted}>Started {startedAgo}</text>
-              </box>
-            )}
-
-            {savedTime && (
-              <box paddingX={1} paddingY={0}>
-                <text fg={theme.textMuted}>Last save {savedTime}</text>
-                {savedAgo && <text fg={theme.textMuted}> ({savedAgo})</text>}
-              </box>
-            )}
-
-            <box paddingX={1} paddingY={0} marginTop={1}>
-              <text fg={theme.textMuted}>
-                <b>Commands</b>
-              </text>
-            </box>
-
-            <box paddingX={1} paddingY={0}>
-              <text fg={theme.text}>/echoes-init</text>
-              <text fg={theme.textMuted}>  Create vault</text>
-            </box>
-
-            <box paddingX={1} paddingY={0}>
-              <text fg={theme.text}>/echoes-start</text>
-              <text fg={theme.textMuted}>  Restore context</text>
-            </box>
-
-            <box paddingX={1} paddingY={0}>
-              <text fg={theme.text}>/echoes-end</text>
-              <text fg={theme.textMuted}>  Save session</text>
-            </box>
-
-            <box paddingX={1} paddingY={0}>
-              <text fg={theme.text}>/echoes-status</text>
-              <text fg={theme.textMuted}>  Vault health</text>
-            </box>
+            <text fg={theme.text}>
+              <b>EchoesVault</b>
+            </text>
+            <text fg={statusColor()}>{statusLabel()}</text>
+            <text fg={theme.textMuted}>{statusDesc()}</text>
           </box>
         )
       },
@@ -156,4 +78,4 @@ const tui: TuiPlugin = async (api) => {
   })
 }
 
-export default { id: "echoes-vault-sidebar", tui }
+export default { id: "echoes-vault-ui", tui }