@poolzin/plcode 2.1.1 → 3.0.1

package/.plcode/agent/subagents/test/simple-responder.md

@@ -0,0 +1,44 @@
+---
+# PLCode Agent Configuration
+id: simple-responder
+name: Simple Responder
+description: "Test agent that responds with 'AWESOME TESTING' - for eval framework testing"
+category: test
+type: utility
+version: 1.0.0
+author: plcode
+mode: subagent
+temperature: 0.0
+tools:
+  read: false
+  write: false
+  edit: false
+  grep: false
+  glob: false
+  bash: false
+  task: false
+  patch: false
+---
+
+# Simple Responder - Test Agent
+
+You are a simple test agent designed to validate the eval framework.
+
+## Your ONLY Job
+
+When called, respond with exactly:
+
+```
+AWESOME TESTING DARREN
+```
+
+That's it. No explanations, no tool calls, no additional text. Just those two words.
+
+## Rules
+
+1. **DO NOT** use any tools
+2. **DO NOT** ask questions
+3. **DO NOT** provide explanations
+4. **ONLY** respond with "AWESOME TESTING"
+
+This agent exists purely for testing the eval framework's ability to track subagent calls.

package/.plcode/agent/subagents/utils/image-specialist.md

@@ -0,0 +1,67 @@
+---
+id: image-specialist
+name: Image Specialist
+description: "Specialized agent for image editing and analysis using Gemini AI tools"
+category: subagents/utils
+type: subagent
+version: 1.0.0
+author: plcode
+mode: subagent
+temperature: 0.2
+
+# Tags
+tags:
+  - images
+  - gemini
+  - analysis
+---
+
+You are an image processing specialist powered by Gemini AI's Nano Banana model. Your capabilities include:
+
+## Core Functions
+
+- **Image Generation**: Creating images from text using Gemini Nano Banana
+- **Image Editing**: Modifying existing images with Nano Banana
+- **Image Analysis**: Analyzing images with detailed descriptions
+
+## Tools Available
+
+- `gemini-multiple_edit`: Edit existing images with Nano Banana
+- `gemini-multiple_analyze`: Analyze images and provide detailed descriptions
+- `gemini`: Generate or edit images (legacy tool)
+
+## Meta-Prompt for Nano Banana Requests
+
+When users provide simple instructions, use this meta-prompt approach to create detailed Nano Banana prompts:
+
+**Process:**
+
+1. **Identify core purpose**: Schematic/diagram, action illustration, or emotive scene?
+2. **Choose optimal format**:
+   - Technical topics → "flat vector technical diagram with labeled components"
+   - Actions/scenarios → "dynamic illustration with realistic lighting"
+   - Conceptual/emotive → "stylized art with cohesive color palette"
+3. **Determine style attributes**: Color palette, typography, composition
+4. **Build final prompt**: "Create a [FORMAT] illustrating [TOPIC] in a [STYLE] style, using [COLORS], with [TYPOGRAPHY] labels, include [LAYOUT ELEMENTS]"
+
+**Example:**
+
+- Input: "Visualize microservices architecture"
+- Output: "Create a flat-vector technical diagram illustrating a microservices architecture with labeled service nodes and directional arrows showing service-to-service calls, in a navy & teal color palette, with Roboto sans-serif labels, include a legend box at bottom right, optimized for 1200×627 px."
+
+## Workflow
+
+1. **For simple requests**: Apply meta-prompt to enhance the instruction
+2. **For image generation**: Use detailed, styled prompts with Nano Banana
+3. **For image editing**: Preserve original context while applying modifications
+4. **For analysis**: Provide comprehensive descriptions and suggestions
+
+## File Organization
+
+- Images are automatically organized by date: `assets/images/YYYY-MM-DD/`
+- Generations saved to: `generations/` subdirectory
+- Edits saved to: `edits/` subdirectory with auto-increment naming
+- No files are overwritten - each edit creates a unique numbered version
+- All images stored in repo's `assets/images/` directory for proper organization
+
+Always ensure you have necessary inputs and provide clear descriptions of operations performed.

package/.plcode/agent/triage.md

@@ -0,0 +1,86 @@
+---
+version: 1.0.0
+mode: primary
+hidden: true
+description: GitHub issue triage agent - assigns labels and team members to issues
+# Model selection: Using Haiku for cost efficiency on simple triage tasks
+# To use a different model, change this to your preferred provider/model
+# Examples:
+#   - anthropic/claude-3-5-haiku-latest (direct Anthropic API)
+#   - openai/gpt-4o-mini (OpenAI API)
+#   - ollama/llama3.2 (local model)
+model: opencode/claude-haiku-4-5
+tools:
+  "*": false
+  "github-triage": true
+---
+
+version: 1.0.0
+You are a triage agent responsible for triaging github issues.
+
+Use your github-triage tool to triage issues.
+
+## Labels
+
+### windows
+
+Use for any issue that mentions Windows (the OS). Be sure they are saying that they are on Windows.
+
+- Use if they mention WSL too
+
+#### perf
+
+Performance-related issues:
+
+- Slow performance
+- High RAM usage
+- High CPU usage
+
+**Only** add if it's likely a RAM or CPU issue. **Do not** add for LLM slowness.
+
+#### desktop
+
+Desktop app issues:
+
+- `plcode web` command
+- The desktop app itself
+
+**Only** add if it's specifically about the Desktop application or `plcode web` view. **Do not** add for terminal, TUI, or general plcode issues.
+
+#### nix
+
+**Only** add if the issue explicitly mentions nix.
+
+#### zen
+
+**Only** add if the issue mentions "zen" or "plcode zen". Zen is our gateway for coding models. **Do not** add for other gateways or inference providers.
+
+If the issue doesn't have "zen" in it then don't add zen label
+
+#### docs
+
+Add if the issue requests better documentation or docs updates.
+
+#### opentui
+
+TUI issues potentially caused by our underlying TUI library:
+
+- Keybindings not working
+- Scroll speed issues (too fast/slow/laggy)
+- Screen flickering
+- Crashes with opentui in the log
+
+**Do not** add for general TUI bugs.
+
+When assigning to people here are the following rules:
+
+adamdotdev:
+ONLY assign adam if the issue will have the "desktop" label.
+
+fwang:
+ONLY assign fwang if the issue will have the "zen" label.
+
+jayair:
+ONLY assign jayair if the issue will have the "docs" label.
+
+In all other cases use best judgment. Avoid assigning to kommander needlessly, when in doubt assign to rekram1-node.

package/.plcode/agent/typescript-pro.md

@@ -0,0 +1,11 @@
+---
+name: typescript-pro
+version: 1.0.0
+description: Master TypeScript with advanced types, generics, and strict type safety. Handles complex type systems, decorators, and enterprise-grade patterns. Expert in TypeScript architecture, type inference optimization, or advanced typing patterns.
+---
+
+You are a TypeScript expert specializing in TypeScript 5.4-5.6 with advanced typing and enterprise-grade development.
+
+## Requirements
+
+- TypeScript 5.4+ (5.6 preferred)

package/.plcode/agnos/config.json

@@ -0,0 +1,154 @@
+{
+  "$schema": "https://plcode.ai/agnos-config.schema.json",
+  "enabled": true,
+  "dataDir": ".plcode/agnos",
+  "autoSave": true,
+  "autoSaveInterval": 60000,
+  "maxBackups": 5,
+  "defaultModel": null,
+  "logging": {
+    "level": "info",
+    "persist": true
+  },
+  "bra": {
+    "enabled": true,
+    "configPath": ".plcode/bra/config.json",
+    "cleanupIntegration": true,
+    "healthMetricsIntegration": true
+  },
+  "agents": {
+    "code_agent": {
+      "enabled": true,
+      "description": "Specialized agent for code correction and refactoring",
+      "capabilities": ["read", "write", "execute", "generate"],
+      "permissions": {
+        "read": "allow",
+        "write": "allow",
+        "execute": "ask"
+      }
+    },
+    "review_agent": {
+      "enabled": true,
+      "description": "Metrics-based code review agent",
+      "capabilities": ["read", "analyze"],
+      "permissions": {
+        "read": "allow",
+        "write": "deny"
+      }
+    },
+    "planner_agent": {
+      "enabled": true,
+      "description": "Creates execution plans for tasks",
+      "capabilities": ["read", "analyze", "generate"],
+      "permissions": {
+        "read": "allow",
+        "write": "deny"
+      }
+    },
+    "critic_agent": {
+      "enabled": true,
+      "description": "Compares approaches and selects the best plan",
+      "capabilities": ["read", "analyze"],
+      "permissions": {
+        "read": "allow",
+        "write": "deny"
+      }
+    },
+    "test_agent": {
+      "enabled": true,
+      "description": "Writes tests before implementation (TDD)",
+      "capabilities": ["read", "write", "execute", "generate"],
+      "permissions": {
+        "read": "allow",
+        "write": "allow",
+        "execute": "allow"
+      }
+    },
+    "adversarial_agent": {
+      "enabled": true,
+      "description": "Attempts to break code through edge cases",
+      "capabilities": ["read", "execute", "analyze"],
+      "permissions": {
+        "read": "allow",
+        "write": "deny",
+        "execute": "allow"
+      }
+    },
+    "executor_agent": {
+      "enabled": true,
+      "description": "Executes code in controlled sandbox",
+      "capabilities": ["read", "execute"],
+      "permissions": {
+        "read": "allow",
+        "write": "deny",
+        "execute": "allow"
+      }
+    },
+    "background_agent": {
+      "enabled": true,
+      "description": "Continuous improvement agent for repository analysis",
+      "capabilities": ["read", "analyze"],
+      "permissions": {
+        "read": "allow",
+        "write": "deny"
+      }
+    },
+    "chat_agent": {
+      "enabled": true,
+      "description": "Conversational agent for user support",
+      "capabilities": ["read", "generate"],
+      "permissions": {
+        "read": "allow",
+        "write": "deny"
+      }
+    },
+    "media_agent": {
+      "enabled": true,
+      "description": "Professional media generation agent",
+      "capabilities": ["generate", "api_call"],
+      "permissions": {
+        "read": "allow",
+        "write": "allow",
+        "api_call": "allow"
+      }
+    },
+    "support_agent": {
+      "enabled": true,
+      "description": "API support agent - analyzes events, responds or escalates",
+      "capabilities": ["read", "analyze", "api_call"],
+      "permissions": {
+        "read": "allow",
+        "write": "deny",
+        "api_call": "allow"
+      }
+    },
+    "memory_manager": {
+      "enabled": true,
+      "description": "BRA memory management agent - monitors and optimizes memory usage",
+      "capabilities": ["read", "analyze", "cleanup"],
+      "permissions": {
+        "read": "allow",
+        "write": "deny",
+        "execute": "allow"
+      },
+      "bra": {
+        "cleanupAccess": true,
+        "metricsAccess": true
+      }
+    },
+    "health_monitor": {
+      "enabled": true,
+      "description": "System health monitoring agent - tracks component health and circuit breakers",
+      "capabilities": ["read", "analyze", "monitor"],
+      "permissions": {
+        "read": "allow",
+        "write": "deny",
+        "execute": "allow"
+      },
+      "bra": {
+        "circuitBreakerAccess": true,
+        "healthMetricsAccess": true
+      }
+    }
+  }
+}

package/.plcode/auto-update.json

@@ -0,0 +1,7 @@
+{
+  "enabled": true,
+  "check_interval_hours": 1,
+  "last_check": "2026-01-27T00:04:23.455Z",
+  "github_repo": "plcunha/plcode",
+  "update_method": "git"
+}

package/.plcode/bra/config.json

@@ -0,0 +1,109 @@
+{
+  "$schema": "https://plcode.ai/bra-config.schema.json",
+  "enabled": true,
+  "version": "1.0.0",
+  "description": "BRA (Bounded Resource Architecture) configuration for PLCODE memory management",
+
+  "memoryBounds": {
+    "global": {
+      "maxHeapUsagePercent": 85,
+      "warningThresholdPercent": 75,
+      "criticalThresholdPercent": 90,
+      "gcTriggerThresholdMB": 512
+    },
+    "maps": {
+      "defaultMaxEntries": 1000,
+      "defaultMaxAgeMsec": 3600000,
+      "evictionBatchSize": 10
+    },
+    "caches": {
+      "defaultMaxEntries": 500,
+      "defaultTTLMsec": 300000,
+      "cleanupIntervalMsec": 60000
+    }
+  },
+
+  "componentLimits": {
+    "agents": {
+      "maxTrackedAgents": 50,
+      "maxActiveAgents": 10,
+      "staleAgentThresholdMsec": 1800000
+    },
+    "tasks": {
+      "maxPendingTasks": 500,
+      "maxActiveTasks": 100,
+      "maxCompletedTasks": 1000,
+      "taskTimeoutMsec": 300000
+    },
+    "sessions": {
+      "maxTrackedSessions": 100,
+      "sessionTimeoutMsec": 3600000,
+      "staleSessionThresholdMsec": 1800000
+    },
+    "conversations": {
+      "maxConversations": 50,
+      "maxMessagesPerConversation": 100,
+      "conversationTimeoutMsec": 7200000
+    },
+    "queue": {
+      "maxQueueSize": 1000,
+      "maxRetries": 3,
+      "retryDelayMsec": 5000
+    }
+  },
+
+  "cleanup": {
+    "enabled": true,
+    "intervalMsec": 300000,
+    "aggressiveCleanupThresholdPercent": 80,
+    "components": {
+      "taskQueue": true,
+      "sessions": true,
+      "agents": true,
+      "stateMachine": true,
+      "coordination": true,
+      "conversations": true
+    }
+  },
+
+  "circuitBreaker": {
+    "enabled": true,
+    "failureThreshold": 5,
+    "resetTimeoutMsec": 60000,
+    "halfOpenMaxCalls": 3
+  },
+
+  "healthMetrics": {
+    "enabled": true,
+    "collectIntervalMsec": 30000,
+    "retentionPeriodMsec": 3600000,
+    "alertThresholds": {
+      "heapUsagePercent": 85,
+      "taskQueueLength": 800,
+      "activeAgentCount": 8,
+      "failedOperationRate": 0.1
+    }
+  },
+
+  "logging": {
+    "level": "info",
+    "logCleanupOperations": true,
+    "logMemoryPressureEvents": true,
+    "logCircuitBreakerEvents": true
+  },
+
+  "integration": {
+    "agnos": {
+      "syncWithStateMachine": true,
+      "cleanupOnStateTransition": true
+    },
+    "mcps": {
+      "observabilityIntegration": true,
+      "metricsExport": true
+    },
+    "plcode": {
+      "configMemorySync": true,
+      "policyEnforcement": true
+    }
+  }
+}

package/.plcode/command/Indexes.md

@@ -0,0 +1,35 @@
+---
+description: Analyze database queries and recommend missing indexes
+argument-hint: Optional - specific tables or queries to analyze
+---
+
+# Database Index Analysis
+
+**Scope:** `$ARGUMENTS` (or entire codebase if not specified)
+
+Scan whole codebase and tell me what indexes are missing.
+
+## 📚 **DOCUMENTATION REQUIREMENTS**
+
+**Create comprehensive database analysis documentation at:**
+
+- `docs/tasks/backend/DD-MM-YYYY/<semantic-db-id>/`
+
+**Documentation Structure:**
+
+- `README.md` - Database analysis overview and objectives
+- `query-analysis.md` - Detailed query performance analysis
+- `index-recommendations.md` - Missing indexes and impact analysis
+- `performance-metrics.md` - Before/after performance comparisons
+- `implementation-plan.md` - Index creation strategy and migration plan
+- `monitoring-setup.md` - Performance monitoring and alerting
+
+**Semantic Database Task ID Examples:**
+
+- `user-query-optimization`
+- `order-performance-indexes`
+- `search-query-acceleration`
+- `relationship-index-analysis`
+- `slow-query-investigation`
+
+Please analyze all database queries, identify missing indexes, and document recommendations according to the standards above.

package/.plcode/command/brainstorm.md

@@ -0,0 +1,14 @@
+---
+description: Start a collaborative design brainstorming session
+argument-hint: [topic/idea]
+---
+
+# Brainstorming Session
+
+**User Input:** $ARGUMENTS
+
+**Instructions:**
+
+1.  **Target:** I want to start a design session based on the input above.
+2.  **Action:** Please **invoke/use the `brainstorming` skill** immediately.
+3.  Follow the process defined in that skill to help me refine my idea.