@fpr1m3/opencode-pai-plugin 1.0.1 → 1.1.1

package/README.md

@@ -13,12 +13,13 @@ This project is an OpenCode-compatible clone of the hook system from **Dan Miess
 ## Features
 
 ### 1. Identity & Context Injection
-*   **Core Skill Loading**: Automatically injects your `skills/core/SKILL.md` (from `PAI_DIR`) into the system prompt.
+*   **Core Skill Loading**: Automatically injects your `skill/core/SKILL.md` (from `PAI_DIR`) into the system prompt.
 *   **Dynamic Substitution**: Supports placeholders like `{{DA}}`, `{{DA_COLOR}}`, and `{{ENGINEER_NAME}}` for personalized interactions.
 *   **Project Requirements**: Automatically detects and loads `.opencode/dynamic-requirements.md` from your current project, allowing for task-specific instructions.
 
-### 2. Intelligent History & Logging
+### 2. Intelligent History & Logging (UOCS)
 *   **Real-time Event Capture**: Logs all tool calls and SDK events to `PAI_DIR/history/raw-outputs` in an analytics-ready JSONL format.
+*   **Universal Output Capture System (UOCS)**: Automatically parses assistant responses for structured sections (SUMMARY, ANALYSIS, etc.) and generates artifacts in `decisions/`, `learnings/`, `research/`, or `execution/` based on context.
 *   **Session Summaries**: Generates human-readable Markdown summaries in `PAI_DIR/history/sessions` at the end of every session, tracking files modified, tools used, and commands executed.
 *   **Agent Mapping**: Tracks session-to-agent relationships (e.g., mapping a subagent session to its specialized type).
 
@@ -36,7 +37,7 @@ The plugin centers around the `PAI_DIR` environment variable.
 
 | Variable | Description | Default |
 | :--- | :--- | :--- |
-| `PAI_DIR` | Root directory for PAI skills and history | `$XDG_CONFIG_HOME/opencode` |
+| `PAI_DIR` | Root directory for PAI skill and history | `$XDG_CONFIG_HOME/opencode` |
 | `DA` | Name of your Digital Assistant | `PAI` |
 | `ENGINEER_NAME` | Your name/identity | `Operator` |
 | `DA_COLOR` | UI color theme for your DA | `blue` |
@@ -55,7 +56,7 @@ Add the plugin to your global `opencode.json` configuration file (typically loca
 
 Upon first run, the plugin will automatically:
 1. Detect or create your `PAI_DIR` (default: `$XDG_CONFIG_HOME/opencode`).
-2. Initialize the required directory structure for skills and history.
+2. Initialize the required directory structure for skill and history.
 3. Create a default `SKILL.md` core identity if one does not exist.
 
 ## Development & Testing
@@ -72,7 +73,7 @@ We provide scripts to verify the plugin in a pristine environment:
 
 ---
 
-**Note**: This plugin is designed to work with the PAI ecosystem. While it auto-initializes a basic structure, you can customize your identity by editing `$PAI_DIR/skills/core/SKILL.md`.
+**Note**: This plugin is designed to work with the PAI ecosystem. While it auto-initializes a basic structure, you can customize your identity by editing `$PAI_DIR/skill/core/SKILL.md`.
 
 ---
 

package/dist/index.js

@@ -1,5 +1,5 @@
 import { Logger } from './lib/logger';
-import { PAI_DIR } from './lib/paths';
+import { PAI_DIR, HISTORY_DIR } from './lib/paths';
 import { validateCommand } from './lib/security';
 import { join } from 'path';
 import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'fs';
@@ -8,10 +8,16 @@ import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'fs';
  */
 function ensurePAIStructure() {
     const dirs = [
-        join(PAI_DIR, 'skills', 'core'),
-        join(PAI_DIR, 'history', 'raw-outputs'),
-        join(PAI_DIR, 'history', 'sessions'),
-        join(PAI_DIR, 'history', 'system-logs'),
+        join(PAI_DIR, 'skill', 'core'),
+        join(HISTORY_DIR, 'raw-outputs'),
+        join(HISTORY_DIR, 'sessions'),
+        join(HISTORY_DIR, 'learnings'),
+        join(HISTORY_DIR, 'decisions'),
+        join(HISTORY_DIR, 'research'),
+        join(HISTORY_DIR, 'execution', 'features'),
+        join(HISTORY_DIR, 'execution', 'bugs'),
+        join(HISTORY_DIR, 'execution', 'refactors'),
+        join(HISTORY_DIR, 'system-logs'),
     ];
     for (const dir of dirs) {
         if (!existsSync(dir)) {
@@ -24,7 +30,7 @@ function ensurePAIStructure() {
             }
         }
     }
-    const coreSkillPath = join(PAI_DIR, 'skills', 'core', 'SKILL.md');
+    const coreSkillPath = join(PAI_DIR, 'skill', 'core', 'SKILL.md');
     if (!existsSync(coreSkillPath)) {
         const defaultSkill = `# PAI Core Identity
 You are {{DA}}, a Personal AI Infrastructure. 
@@ -89,9 +95,9 @@ export const PAIPlugin = async ({ worktree }) => {
     let currentSessionId = null;
     // Auto-initialize PAI infrastructure if needed
     ensurePAIStructure();
-    // Load CORE skill content from $PAI_DIR/skills/core/SKILL.md
+    // Load CORE skill content from $PAI_DIR/skill/core/SKILL.md
     let coreSkillContent = '';
-    const coreSkillPath = join(PAI_DIR, 'skills', 'core', 'SKILL.md');
+    const coreSkillPath = join(PAI_DIR, 'skill', 'core', 'SKILL.md');
     if (existsSync(coreSkillPath)) {
         try {
             coreSkillContent = readFileSync(coreSkillPath, 'utf-8');
@@ -152,18 +158,25 @@ export const PAIPlugin = async ({ worktree }) => {
                     process.stderr.write(`\x1b]0;Agent: ${type}...\x07`);
                 }
             }
-            // Handle assistant completion (Tab Titles)
+            // Handle assistant completion (Tab Titles & UOCS)
             if (event.type === 'message.updated') {
                 const info = anyEvent.properties?.info;
-                if (info?.author === 'assistant' && info?.content) {
-                    const content = typeof info.content === 'string' ? info.content : '';
+                const role = info?.role || info?.author;
+                if (role === 'assistant') {
+                    // Robust content extraction
+                    const content = info?.content || info?.text || '';
+                    const contentStr = typeof content === 'string' ? content : '';
                     // Look for COMPLETED: line (can be prefaced by 🎯 or just text)
-                    const completedMatch = content.match(/(?:🎯\s*)?COMPLETED:\s*(.+?)(?:\n|$)/i);
+                    const completedMatch = contentStr.match(/(?:🎯\s*)?COMPLETED:\s*(.+?)(?:\n|$)/i);
                     if (completedMatch) {
                         const completedLine = completedMatch[1].trim();
                         // Set Tab Title
                         const tabTitle = generateTabTitle(completedLine);
                         process.stderr.write(`\x1b]0;${tabTitle}\x07`);
+                        // UOCS: Process response for artifact generation
+                        if (logger && contentStr) {
+                            await logger.processAssistantMessage(contentStr);
+                        }
                     }
                 }
             }

package/dist/lib/logger.d.ts

@@ -29,6 +29,11 @@ export declare class Logger {
         metadata: any;
     }): void;
     generateSessionSummary(): Promise<string | null>;
+    processAssistantMessage(content: string): Promise<void>;
+    private parseStructuredResponse;
+    private isLearningCapture;
+    private determineArtifactType;
+    private createArtifact;
     logError(context: string, error: any): void;
     private writeEvent;
     flush(): void;

package/dist/lib/logger.js

@@ -208,6 +208,109 @@ This session summary was automatically generated by the PAI OpenCode Plugin.
             return null;
         }
     }
+    async processAssistantMessage(content) {
+        try {
+            const sections = this.parseStructuredResponse(content);
+            if (Object.keys(sections).length === 0)
+                return;
+            const agentRole = this.getAgentForSession(this.sessionId);
+            const isLearning = this.isLearningCapture(sections);
+            const type = this.determineArtifactType(agentRole, isLearning, sections);
+            await this.createArtifact(type, content, sections);
+        }
+        catch (error) {
+            this.logError('ProcessAssistantMessage', error);
+        }
+    }
+    parseStructuredResponse(content) {
+        const sections = {};
+        const sectionHeaders = [
+            'SUMMARY', 'ANALYSIS', 'ACTIONS', 'RESULTS', 'STATUS', 'CAPTURE', 'NEXT', 'STORY EXPLANATION', 'COMPLETED'
+        ];
+        for (const header of sectionHeaders) {
+            const regex = new RegExp(`${header}:\\s*([\\s\\S]*?)(?=\\n(?:${sectionHeaders.join('|')}):|$)`, 'i');
+            const match = content.match(regex);
+            if (match && match[1]) {
+                sections[header] = match[1].trim();
+            }
+        }
+        return sections;
+    }
+    isLearningCapture(sections) {
+        const indicators = ['fixed', 'solved', 'discovered', 'lesson', 'troubleshoot', 'debug', 'root cause', 'learning', 'bug', 'issue', 'resolved'];
+        const textToSearch = ((sections['ANALYSIS'] || '') + ' ' + (sections['RESULTS'] || '')).toLowerCase();
+        let count = 0;
+        for (const indicator of indicators) {
+            if (textToSearch.includes(indicator)) {
+                count++;
+            }
+        }
+        return count >= 2;
+    }
+    determineArtifactType(agentRole, isLearning, sections) {
+        const summary = (sections['SUMMARY'] || '').toLowerCase();
+        if (agentRole === 'architect')
+            return 'DECISION';
+        if (agentRole === 'researcher' || agentRole === 'pentester')
+            return 'RESEARCH';
+        if (agentRole === 'engineer' || agentRole === 'designer') {
+            if (summary.includes('fix') || summary.includes('bug') || summary.includes('issue'))
+                return 'BUG';
+            if (summary.includes('refactor') || summary.includes('improve') || summary.includes('cleanup'))
+                return 'REFACTOR';
+            return 'FEATURE';
+        }
+        return isLearning ? 'LEARNING' : 'WORK';
+    }
+    async createArtifact(type, content, sections) {
+        const now = new Date();
+        const timestamp = now.toISOString()
+            .replace(/:/g, '')
+            .replace(/\..+/, '')
+            .replace('T', '-');
+        const yearMonth = timestamp.substring(0, 7);
+        const summary = sections['SUMMARY'] || 'no-summary';
+        const slug = summary.toLowerCase()
+            .replace(/[^\w\s-]/g, '')
+            .replace(/\s+/g, '-')
+            .substring(0, 50);
+        const filename = `${timestamp}_${type}_${slug}.md`;
+        let subdir = 'execution';
+        if (type === 'LEARNING')
+            subdir = 'learnings';
+        else if (type === 'DECISION')
+            subdir = 'decisions';
+        else if (type === 'RESEARCH')
+            subdir = 'research';
+        else if (type === 'WORK')
+            subdir = 'sessions';
+        else {
+            // For BUG, REFACTOR, FEATURE
+            if (type === 'BUG')
+                subdir = join('execution', 'bugs');
+            else if (type === 'REFACTOR')
+                subdir = join('execution', 'refactors');
+            else
+                subdir = join('execution', 'features');
+        }
+        const targetDir = join(HISTORY_DIR, subdir, yearMonth);
+        if (!existsSync(targetDir)) {
+            mkdirSync(targetDir, { recursive: true });
+        }
+        const filePath = join(targetDir, filename);
+        const agentRole = this.getAgentForSession(this.sessionId);
+        const frontmatter = `---
+capture_type: ${type}
+timestamp: ${new Date().toISOString()}
+session_id: ${this.sessionId}
+executor: ${agentRole}
+${sections['SUMMARY'] ? `summary: ${sections['SUMMARY'].replace(/"/g, '\\"')}` : ''}
+---
+
+${content}
+`;
+        writeFileSync(filePath, redactString(frontmatter), 'utf-8');
+    }
     logError(context, error) {
         try {
             const now = new Date();

package/dist/lib/paths.js

@@ -25,7 +25,7 @@ export const PAI_DIR = process.env.PAI_DIR
  * Common PAI directories
  */
 export const HOOKS_DIR = join(PAI_DIR, 'hooks');
-export const SKILLS_DIR = join(PAI_DIR, 'skills');
+export const SKILLS_DIR = join(PAI_DIR, 'skill');
 export const AGENTS_DIR = join(PAI_DIR, 'agents');
 export const HISTORY_DIR = join(PAI_DIR, 'history');
 export const COMMANDS_DIR = join(PAI_DIR, 'commands');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fpr1m3/opencode-pai-plugin",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "type": "module",
   "description": "Personal AI Infrastructure (PAI) plugin for OpenCode",
   "main": "dist/index.js",

package/dist/lib/context-loader.d.ts

@@ -1 +0,0 @@
-export declare function getCoreContext(baseDir: string, env: NodeJS.ProcessEnv): string;

package/dist/lib/context-loader.js

@@ -1,21 +0,0 @@
-import { readFileSync, existsSync } from 'fs';
-import { join } from 'path';
-import { getSkillsDir } from './paths';
-export function getCoreContext(baseDir, env) {
-    const skillsDir = getSkillsDir(baseDir);
-    const coreSkillPath = join(skillsDir, 'core', 'SKILL.md');
-    if (!existsSync(coreSkillPath)) {
-        console.warn(`Core skill file not found at ${coreSkillPath}`);
-        return '';
-    }
-    let content = readFileSync(coreSkillPath, 'utf-8');
-    // Variable replacement
-    const replacements = {
-        '{{DA}}': env.DA_NAME || 'PAI',
-        '{{ENGINEER_NAME}}': env.USER_NAME || env.USER || 'Engineer',
-    };
-    for (const [key, value] of Object.entries(replacements)) {
-        content = content.replaceAll(key, value);
-    }
-    return content;
-}

package/dist/lib/notifier.d.ts

@@ -1 +0,0 @@
-export declare function notifyVoiceServer(message: string): Promise<void>;

package/dist/lib/notifier.js

@@ -1,12 +0,0 @@
-export async function notifyVoiceServer(message) {
-    try {
-        await fetch('http://localhost:8888/notify', {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ message }),
-        });
-    }
-    catch (error) {
-        // Ignore errors if server is not running
-    }
-}