echoes-vault-opencode 1.0.3 → 1.0.4

package/README.md

@@ -99,6 +99,7 @@ The AI distills the session into a dense technical summary, writes new encyclope
 | `/echoes-init` | Initialize the vault and brief the AI on the knowledge base rules |
 | `/echoes-start` | Start session — restore context from the last 3 daily logs and the index |
 | `/echoes-end` | End session — distill and commit session memory to the vault |
+| `/echoes-status` | Report vault health, statistics, and scalability |
 
 ### AI tools reference
 

package/index.ts

@@ -148,6 +148,44 @@ Prepare the following payload for the skill:
 Compile these data points and execute the save function immediately!
 `
 
+const ECHOES_STATUS_COMMAND = `---
+description: Report the current health, statistics, and scalability of the EchoesVault
+agent: build
+---
+
+# SYSTEM MESSAGE: Vault Status Report
+You are the EchoesVault Keeper. The user has requested a quick, high-level health check of the knowledge base. Do NOT analyze the deep architectural meaning of the files. Your goal is to output a fast, token-efficient metrics dashboard.
+
+## \ud83d\udce5 INPUT DATA
+Here is the current registry (\`EchoesVault/index.md\`):
+<index>
+!\`cat EchoesVault/index.md 2>/dev/null || echo "EchoesVault/index.md not found"\`
+</index>
+
+Here is today's daily log if it exists:
+<today_log>
+!\`cat EchoesVault/daily/$(date +%Y-%m-%d).md 2>/dev/null || echo "No entries yet"\`
+</today_log>
+
+## \ud83d\ude80 ACTION
+Analyze the inputs strictly for quantitative metrics. Provide a highly concise, bulleted dashboard using the exact formatting below.
+
+**CRITICAL SCALE RULE:**
+Count the total number of topics in the index. If the total count is greater than 200, you MUST append the \`> [!warning] SCALE ALERT\` block below your dashboard. If the count is 200 or less, omit the alert block entirely.
+
+**Expected Output Format:**
+\ud83d\udcca **EchoesVault Status**
+* **Total Topics:** [Count of files listed in the index]
+* **Deprecated Pages:** [Count of files marked as deprecated in the index, if any]
+* **Today's Session:** [Active (with X entries) / Not started yet]
+* **Index Health:** [Healthy / Warning: mention obvious duplicates or empty descriptions]
+
+> [!warning] SCALE ALERT
+> The vault has exceeded 200 pages. To prevent context window inflation and high token costs during \`/echoes-start\`, consider migrating this knowledge base to a hybrid RAG (Retrieval-Augmented Generation) system.
+
+Keep your response under 90 words. Output strictly the dashboard (and the conditional alert if triggered). No conversational filler.
+`
+
 const APPEND_TO_DAILY_LOG_SKILL = `---
 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.
@@ -222,6 +260,7 @@ const ensureCommands = async (directory: string): Promise<void> => {
     "echoes-init.md": ECHOES_INIT_COMMAND,
     "echoes-start.md": ECHOES_START_COMMAND,
     "echoes-end.md": ECHOES_END_COMMAND,
+    "echoes-status.md": ECHOES_STATUS_COMMAND,
   }
   const cmdDir = path.join(directory, ".opencode", "commands")
   await fs.mkdir(cmdDir, { recursive: true })
@@ -284,6 +323,7 @@ export const OpenCodeEchoes: Plugin = async ({ directory }) => {
         "echoes-init": ECHOES_INIT_COMMAND,
         "echoes-start": ECHOES_START_COMMAND,
         "echoes-end": ECHOES_END_COMMAND,
+        "echoes-status": ECHOES_STATUS_COMMAND,
       }
       input.command = input.command || {}
       for (const [name, cmd] of Object.entries(cmds)) {

package/package.json

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