echoes-vault-opencode 1.0.3 → 1.0.5

package/README.md

@@ -52,6 +52,15 @@ status: active
 
 ## Installation
 
+### Via OpenCode UI (recommended)
+
+1. Press <kbd>control</kbd> + <kbd>P</kbd> to open the command palette
+2. Select **Install plugin**
+3. Enter the package name: `echoes-vault-opencode`
+4. Restart OpenCode
+
+### Manual
+
 Add the plugin to your `opencode.json`:
 
 ```json
@@ -99,6 +108,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
 
@@ -121,6 +131,10 @@ Skills guide the AI on *when* and *how* to use the tools above. They are loaded
 | `echoes_search_vault_pages` | When to search the vault before generating code |
 | `echoes_create_or_update_page` | When to create vs. update a page, deprecation rules |
 
+## Support the project
+
+EchoesVault is built on top of [OpenCode](https://opencode.ai/go?ref=EZW07YHVTG). If you find this plugin useful, consider subscribing to **OpenCode GO** — it unlocks unlimited usage and directly funds the platform this plugin depends on. There's a 50% discount available via [this link](https://opencode.ai/go?ref=EZW07YHVTG).
+
 ## License
 
 [MIT](LICENSE)

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 })
@@ -264,7 +303,7 @@ const parseCommandFrontmatter = (cmd: string): { template: string; description?:
   return { template: match[2], description: frontmatter.description, agent: frontmatter.agent }
 }
 
-export const OpenCodeEchoes: Plugin = async ({ directory }) => {
+const OpenCodeEchoes: Plugin = async ({ directory }) => {
   const paths = resolveVaultPaths(directory)
   const indexFile = path.join(paths.vault, "index.md")
 
@@ -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)) {
@@ -494,5 +534,5 @@ export const OpenCodeEchoes: Plugin = async ({ directory }) => {
   }
 }
 
-export default OpenCodeEchoes
-export { OpenCodeEchoes as server }
+export default { server: OpenCodeEchoes }
+export { OpenCodeEchoes }

package/package.json

@@ -1,9 +1,15 @@
 {
   "name": "echoes-vault-opencode",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "EchoesVault — persistent memory plugin for OpenCode. Obsidian-style knowledge base with daily logs, encyclopedia pages, and session resumption.",
   "type": "module",
   "main": "index.ts",
+  "exports": {
+    "./server": {
+      "import": "./index.ts",
+      "types": "./index.ts"
+    }
+  },
   "files": [
     "index.ts"
   ],