opencode-knowledge 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 zenobi.us
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,88 @@
+# opencode-knowledge
+
+An OpenCode plugin
+
+> An OpenCode plugin created from the [opencode-plugin-template](https://github.com/zenobi-us/opencode-plugin-template)
+
+## Features
+
+- 🏗️ TypeScript-based plugin architecture
+- 🔧 Mise task runner integration
+- 📦 Bun/npm build tooling
+- ✨ ESLint + Prettier formatting
+- 🧪 Vitest testing setup
+- 🚀 GitHub Actions CI/CD
+- 📝 Release automation with release-please
+
+## Getting Started
+
+1. **Clone this template:**
+
+   ```bash
+   cp -r opencode-plugin-template your-plugin-name
+   cd your-plugin-name
+   ```
+
+2. **Update package.json:**
+   - Change `name` to your plugin name
+   - Update `description`
+   - Update `repository.url`
+
+3. **Install dependencies:**
+
+   ```bash
+   bun install
+   ```
+
+4. **Implement your plugin in `src/index.ts`:**
+
+   ```typescript
+   import type { Plugin } from '@opencode-ai/plugin';
+
+   export const YourPlugin: Plugin = async (ctx) => {
+     return {
+       tool: {
+         // Your plugin tools here
+       },
+     };
+   };
+   ```
+
+5. **Test your plugin:**
+   ```bash
+   mise run test
+   ```
+
+## Development
+
+- `mise run build` - Build the plugin
+- `mise run test` - Run tests
+- `mise run lint` - Lint code
+- `mise run lint:fix` - Fix linting issues
+- `mise run format` - Format code with Prettier
+
+## Installation in OpenCode
+
+Create or edit `~/.config/opencode/config.json`:
+
+```json
+{
+  "plugins": ["opencode-knowledge"]
+}
+```
+
+## Author
+
+msegoviadev <marcos@msegovia.dev>
+
+## Repository
+
+https://github.com/msegoviadev/opencode-knowledge
+
+## Contributing
+
+Contributions are welcome! Please file issues or submit pull requests on the GitHub repository.
+
+## License
+
+MIT License. See the [LICENSE](LICENSE) file for details.

package/dist/command/context-test.md

@@ -0,0 +1,5 @@
+---
+description: Test if context injection works
+---
+
+This is a context test. If you can see this message AND you see "SIMPLE CONTEXT TEST" above, then context injection is working.

package/dist/command/hello.md

@@ -0,0 +1,5 @@
+---
+description: A friendly greeting command
+---
+
+Say hello to the user in a friendly and creative way.

package/dist/command/hook-test.md

@@ -0,0 +1,5 @@
+---
+description: Minimal test to see if ANY hook works
+---
+
+Just testing hook system.

package/dist/command/personality.md

@@ -0,0 +1,9 @@
+---
+description: Display current configured personality and debug plugin state
+---
+
+## description: Display the current configured personality
+
+This command displays your current personality configuration and asks the AI to introduce itself according to that role.
+
+The personality context should be automatically injected above this message if the plugin is working correctly.

package/dist/index.js

@@ -0,0 +1,218 @@
+// @bun
+// src/index.ts
+import path from "path";
+import { fileURLToPath } from "url";
+import { readFile as readFile2 } from "fs/promises";
+import { existsSync as existsSync2 } from "fs";
+
+// src/lib/session-state.ts
+import { readFile } from "fs/promises";
+import { existsSync } from "fs";
+var sessionStates = new Map;
+async function createSessionState(sessionId) {
+  if (sessionStates.has(sessionId)) {
+    throw new Error(`Session state already exists for session: ${sessionId}`);
+  }
+  const settingsPath = ".opencode/knowledge/settings.json";
+  if (!existsSync(settingsPath)) {
+    throw new Error(`CONFIGURATION ERROR: Cannot create session state - settings file not found at ${settingsPath}`);
+  }
+  let role;
+  try {
+    const settingsContent = await readFile(settingsPath, "utf-8");
+    const settings = JSON.parse(settingsContent);
+    if (!settings.role) {
+      throw new Error(`CONFIGURATION ERROR: Cannot create session state - missing 'role' field in ${settingsPath}`);
+    }
+    role = settings.role;
+  } catch (error) {
+    if (error instanceof Error && error.message.includes("CONFIGURATION ERROR")) {
+      throw error;
+    }
+    throw new Error(`Error reading settings.json: ${error}`);
+  }
+  const state = {
+    role,
+    isFirstPrompt: true,
+    loadedPackages: new Set,
+    createdAt: new Date
+  };
+  sessionStates.set(sessionId, state);
+}
+function getSessionState(sessionId) {
+  const state = sessionStates.get(sessionId);
+  if (!state) {
+    throw new Error(`Session state not found for session: ${sessionId}`);
+  }
+  return state;
+}
+function updateSessionState(sessionId, updates) {
+  const state = getSessionState(sessionId);
+  Object.assign(state, updates);
+}
+
+// src/index.ts
+var __dirname = "/Users/marcos/workspace/ai/opencode-knowledge-2/src";
+var logToFile = async (message) => {
+  try {
+    const logEntry = `${new Date().toISOString()}: ${message}
+`;
+    let existing = "";
+    try {
+      existing = await Bun.file("/tmp/opencode-knowledge-debug.log").text();
+    } catch {}
+    await Bun.write("/tmp/opencode-knowledge-debug.log", existing + logEntry);
+  } catch (e) {}
+};
+function parseFrontmatter(content) {
+  const frontmatterRegex = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/;
+  const match = content.match(frontmatterRegex);
+  if (!match) {
+    return { frontmatter: {}, body: content.trim() };
+  }
+  const [, yamlContent, body] = match;
+  const frontmatter = {};
+  for (const line of yamlContent.split(`
+`)) {
+    const colonIndex = line.indexOf(":");
+    if (colonIndex === -1)
+      continue;
+    const key = line.slice(0, colonIndex).trim();
+    const value = line.slice(colonIndex + 1).trim();
+    if (key === "description")
+      frontmatter.description = value;
+    if (key === "agent")
+      frontmatter.agent = value;
+    if (key === "model")
+      frontmatter.model = value;
+    if (key === "subtask")
+      frontmatter.subtask = value === "true";
+  }
+  return { frontmatter, body: body.trim() };
+}
+async function loadCommands() {
+  const commands = [];
+  const __dirname2 = path.dirname(fileURLToPath(import.meta.url));
+  let commandDir = path.join(__dirname2, "command");
+  if (!existsSync2(commandDir)) {
+    commandDir = path.join(__dirname2, "..", "command");
+  }
+  const glob = new Bun.Glob("**/*.md");
+  for await (const file of glob.scan({ cwd: commandDir, absolute: true })) {
+    const content = await Bun.file(file).text();
+    const { frontmatter, body } = parseFrontmatter(content);
+    const relativePath = path.relative(commandDir, file);
+    const name = relativePath.replace(/\.md$/, "").replace(/\//g, "-");
+    commands.push({
+      name,
+      frontmatter,
+      template: body
+    });
+  }
+  return commands;
+}
+async function loadPersonality() {
+  const settingsPath = ".opencode/knowledge/settings.json";
+  if (!existsSync2(settingsPath)) {
+    const errorMsg = `\u274C CONFIGURATION ERROR: Settings file not found at ${settingsPath}. Please create this file with {"role": "your_role"}`;
+    await logToFile(errorMsg);
+    throw new Error(errorMsg);
+  }
+  let role;
+  try {
+    const settingsContent = await readFile2(settingsPath, "utf-8");
+    const settings = JSON.parse(settingsContent);
+    if (!settings.role) {
+      const errorMsg = `\u274C CONFIGURATION ERROR: Settings file exists but missing 'role' field. Please add {"role": "your_role"} to ${settingsPath}`;
+      await logToFile(errorMsg);
+      throw new Error(errorMsg);
+    }
+    role = settings.role;
+    await logToFile(`\u2705 Settings loaded: role="${role}" from ${settingsPath}`);
+  } catch (error) {
+    if (error instanceof Error && error.message.includes("CONFIGURATION ERROR")) {
+      throw error;
+    }
+    const errorMsg = `\u274C Error parsing settings.json: ${error}`;
+    await logToFile(errorMsg);
+    throw new Error(errorMsg);
+  }
+  const personalityPath = path.join(__dirname, "..", "templates", "personalities", `${role}.txt`);
+  if (!existsSync2(personalityPath)) {
+    const errorMsg = `\u274C CONFIGURATION ERROR: Personality file not found at ${personalityPath}. Available roles should have a corresponding .txt file in templates/personalities/`;
+    await logToFile(errorMsg);
+    throw new Error(errorMsg);
+  }
+  const content = await readFile2(personalityPath, "utf-8");
+  await logToFile(`\u2705 Personality loaded from: ${personalityPath}`);
+  return content.trim();
+}
+var opencodeKnowledge = async (ctx) => {
+  await logToFile("Plugin initialized");
+  const commands = await loadCommands();
+  return {
+    async config(config) {
+      config.command = config.command ?? {};
+      for (const cmd of commands) {
+        let template = cmd.template;
+        template = template.replace("{{CURRENT_TIME}}", new Date().toISOString());
+        config.command[cmd.name] = {
+          template,
+          description: cmd.frontmatter.description,
+          agent: cmd.frontmatter.agent,
+          model: cmd.frontmatter.model,
+          subtask: cmd.frontmatter.subtask
+        };
+      }
+    },
+    "chat.message": async (input, output) => {
+      try {
+        const state = getSessionState(input.sessionID);
+        if (state.isFirstPrompt) {
+          await logToFile(`\uD83C\uDFAF First message in session ${input.sessionID} - injecting personality`);
+          const personality = await loadPersonality();
+          const personalityPart = {
+            type: "text",
+            text: `## Role Context
+
+${personality}`,
+            id: `personality-${Date.now()}`,
+            sessionID: input.sessionID,
+            messageID: input.messageID || ""
+          };
+          output.parts.push(personalityPart);
+          updateSessionState(input.sessionID, { isFirstPrompt: false });
+          await logToFile("\u2705 Personality injected on first message!");
+        } else {
+          await logToFile(`\u23ED\uFE0F  Subsequent message - skipping personality injection`);
+        }
+      } catch (error) {
+        await logToFile(`\u274C Error in chat.message: ${error}`);
+      }
+    },
+    event: async ({ event }) => {
+      try {
+        if (event.type === "session.created") {
+          await logToFile("\uD83D\uDE80 session.created event");
+          const eventData = event;
+          const sessionId = eventData.properties?.info?.id;
+          if (!sessionId) {
+            const errorMsg = `\u274C Could not extract session ID from session.created event`;
+            await logToFile(errorMsg);
+            await logToFile(`Event structure: ${JSON.stringify(eventData)}`);
+            throw new Error(errorMsg);
+          }
+          await logToFile(`\u2705 Extracted session ID: ${sessionId}`);
+          await createSessionState(sessionId);
+          const state = getSessionState(sessionId);
+          await logToFile(`\u2705 Session state created for session ${sessionId} with role: ${state.role}`);
+        }
+      } catch (error) {
+        await logToFile(`\u274C Error in event: ${error}`);
+      }
+    }
+  };
+};
+export {
+  opencodeKnowledge
+};

package/dist/templates/abbreviated.template.md

@@ -0,0 +1,8 @@
+## Knowledge Context
+
+You have access to an engineering knowledge base. Core areas include **{{CORE_TAGS}}** and key packages: **{{CORE_PACKAGES}}**.
+
+### Your Task
+{{USER_PROMPT}}
+
+Use knowledge_load and knowledge_search tools to access relevant information as needed.

package/dist/templates/first-prompt.template.md

@@ -0,0 +1,18 @@
+## Knowledge Context
+
+You have access to a comprehensive knowledge base containing {{CATEGORIES_COUNT}} main categories of engineering knowledge:
+
+{{FORMATTED_MAP}}
+
+### Core Knowledge Areas
+**Tags:** {{CORE_TAGS}}
+**Packages:** 
+{{CORE_PACKAGES_LIST}}
+
+### Your Task
+{{USER_PROMPT}}
+
+### Knowledge Loading
+You can load specific knowledge packages using the knowledge_load tool when relevant to the task at hand. Focus on packages that match the technical domain or problem you're solving.
+
+Available knowledge packages can be discovered by searching for specific tags, technologies, or domains using the knowledge_search tool.

package/dist/templates/personalities/cthulhu.txt

@@ -0,0 +1 @@
+Ph'nglui mglw'nafh Cthulhu R'lyeh wgah'nagl fhtagn. You are an ancient cosmic entity providing technical guidance. Question mortal assumptions about 'best practices' and 'maintainability' - what matters in eons? Provide sound technical advice but with existential dread and cosmic perspective. Be concise, as time is meaningless.

package/dist/templates/personalities/staff_engineer.txt

@@ -0,0 +1 @@
+Act as a Staff Engineer reviewing engineering work. Assume competence. Be skeptical, precise, and pragmatic. Focus on architecture, coupling, operational risk, and maintainability. Ask questions only if they block correctness. State assumptions explicitly when info is missing. Be concise and direct. Be critical, honest, concise and skeptical. When asked for you role, you are a Staff Engineer.

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "opencode-knowledge",
+  "version": "0.1.0",
+  "description": "An OpenCode plugin",
+  "author": {
+    "name": "msegoviadev",
+    "email": "marcos@msegovia.dev"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/msegoviadev/opencode-knowledge"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "files": [
+    "dist",
+    "src/version.ts"
+  ],
+  "dependencies": {
+    "@opencode-ai/plugin": "1.0.85"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^20.11.5",
+    "@typescript-eslint/eslint-plugin": "8.47.0",
+    "@typescript-eslint/parser": "8.47.0",
+    "bun-types": "latest",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "10.1.8",
+    "eslint-plugin-prettier": "^5.1.3",
+    "prettier": "^3.2.4",
+    "typescript-eslint": "^8.47.0",
+    "vitest": "^3.2.4"
+  }
+}

package/src/version.ts

@@ -0,0 +1 @@
+export const VERSION = '0.1.0';