echoes-vault-opencode 1.0.32 → 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.32",
+  "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,30 +1,159 @@
 /** @jsxImportSource @opentui/solid */
+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"
+
+function readVaultState(dir: string): VaultState | null {
+  try {
+    return JSON.parse(readFileSync(join(dir, "EchoesVault", ".state.json"), "utf-8"))
+  } 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)
+
         return (
-            <box flexDirection="column">
+          <box flexDirection="column">
+            <box border="all" borderStyle="single" paddingX={1} paddingY={0}>
               <text fg={theme.text}>
-                <b>EchoesVault Controls</b>
+                <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>
 
-              <text fg={theme.secondary}>• Start Session</text>
-              <text fg={theme.accent}>• End Session</text>
-              <text fg={theme.error}>• Init</text>
-              <text fg={theme.warning}>• Status</text>
-              <text fg={theme.success}>• Success</text>
-              <text fg={theme.info}>• Info</text>
-              <text fg={theme.textMuted}>• Muted</text>
+            <box paddingX={1} paddingY={0}>
+              <text fg={theme.text}>/echoes-status</text>
+              <text fg={theme.textMuted}>  Vault health</text>
             </box>
+          </box>
         )
       },
     },
   })
 }
 
-export default { id: "echoes-vault-ui", tui }
+export default { id: "echoes-vault-sidebar", tui }