echoes-vault-opencode 1.0.33 → 1.0.34

package/index.ts

@@ -58,6 +58,72 @@ 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
@@ -317,6 +383,9 @@ 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)
+
   return {
     config: async (input) => {
       const cmds: Record<string, string> = {
@@ -416,6 +485,8 @@ const OpenCodeEchoes: Plugin = async ({ directory }) => {
 
           await fs.writeFile(idxFile, indexContent)
 
+          await markSaved(paths.vault)
+
           return [
             `✅ Memory committed to EchoesVault.`,
             `- Daily log: EchoesVault/daily/${today}.md`,
@@ -441,6 +512,9 @@ 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`
         },
       }),
@@ -455,6 +529,7 @@ 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")
@@ -501,6 +576,7 @@ 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)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "echoes-vault-opencode",
-  "version": "1.0.33",
+  "version": "1.0.34",
   "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,101 +1,97 @@
 /** @jsxImportSource @opentui/solid */
-import { createSignal } from "solid-js"
+import { readFileSync } from "node:fs"
+import { join } from "node:path"
 import type { TuiPlugin } from "@opencode-ai/plugin/tui"
 
+type SessionState = {
+  started: boolean
+  saved: boolean
+  lastStart: string | null
+  lastSave: string | null
+}
+
+type VaultState = {
+  version: number
+  initialized: boolean
+  session: SessionState
+}
+
 type VaultStatus = "uninitialized" | "idle" | "working" | "saved"
 
-const KV = "echoes_vault_state"
+function readVaultState(dir: string): VaultState | null {
+  try {
+    return JSON.parse(readFileSync(join(dir, "EchoesVault", ".state.json"), "utf-8"))
+  } catch {
+    return null
+  }
+}
 
-const STATUS_META: Record<VaultStatus, { label: string; description: string; colorKey: string }> = {
+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',
-    colorKey: "error",
   },
   idle: {
     label: "Vault idle",
-    description: 'Run /echoes-start to restore context from vault',
-    colorKey: "warning",
+    description: 'Run /echoes-start to restore context',
   },
   working: {
     label: "Vault active",
-    description: 'Run /echoes-end before closing to save session memory',
-    colorKey: "success",
+    description: 'Run /echoes-end before closing to save session',
   },
   saved: {
     label: "Session saved",
     description: 'Memory committed to EchoesVault',
-    colorKey: "accent",
   },
 }
 
-function computeStatus(init: boolean, started: boolean, ended: boolean): VaultStatus {
-  if (!init) return "uninitialized"
-  if (ended) return "saved"
-  if (started) return "working"
-  return "idle"
+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 [getInit, setInit] = createSignal(false)
-  const [getStarted, setStarted] = createSignal(false)
-  const [getEnded, setEnded] = createSignal(false)
-
-  try {
-    const raw = api.kv.get<{ initialized: boolean }>(KV)
-    if (raw?.initialized) setInit(true)
-  } catch {}
-
-  function persist() {
-    try { api.kv.set(KV, { initialized: getInit() }) } catch {}
-  }
-
-  function handleCommand(cmd: "init" | "start" | "end") {
-    if (cmd === "init") {
-      setInit(true)
-      setStarted(false)
-      setEnded(false)
-    } else if (cmd === "start") {
-      setStarted(true)
-      setEnded(false)
-    } else if (cmd === "end") {
-      setEnded(true)
-    }
-    persist()
-  }
-
-  api.event.on("session.created", () => {
-    setStarted(false)
-    setEnded(false)
-  })
-
-  api.event.on("session.idle", () => {
-    if (getStarted() && !getEnded()) {
-      setStarted(false)
-    }
-  })
-
-  api.event.on("message.part.updated", (event: any) => {
-    try {
-      const part = event?.properties?.part
-      if (!part) return
-      const text: string = part.text ?? part.content ?? ""
-      if (typeof text !== "string") return
-
-      if (text.includes("/echoes-init")) handleCommand("init")
-      else if (text.includes("/echoes-start")) handleCommand("start")
-      else if (text.includes("/echoes-end")) handleCommand("end")
-    } catch {}
-  })
+  const dir = api.state.path.directory
 
   api.slots.register({
     slots: {
       sidebar_content() {
-        const status = computeStatus(getInit(), getStarted(), getEnded())
+        const state = readVaultState(dir)
+        const status = getStatus(state)
         const meta = STATUS_META[status]
-        const color = (theme as any)[meta.colorKey] ?? theme.text
+        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)
 
         return (
           <box flexDirection="column">
@@ -115,6 +111,19 @@ const tui: TuiPlugin = async (api) => {
               <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>