plcode-linux-x64-baseline-musl 2.1.0

package/.plcode/context/openagents-repo/quick-start.md

@@ -0,0 +1,168 @@
+# OpenAgents Repository - Quick Start
+
+**Purpose**: Get oriented in this repo in 2 minutes
+
+---
+
+## What Is This Repo?
+
+OpenAgents is an AI agent framework with:
+
+- **Category-based agents** (core, development, content, data, product, learning)
+- **Eval framework** for testing agent behavior
+- **Registry system** for component distribution
+- **Install system** for easy setup
+
+---
+
+## Core Concepts (Load These First)
+
+Before working on this repo, understand these 4 systems:
+
+1. **Agents** → Load: `core-concepts/agents.md`
+   - How agents are structured
+   - Category system
+   - Prompt variants
+   - Subagents vs category agents
+
+2. **Evals** → Load: `core-concepts/evals.md`
+   - How testing works
+   - Running tests
+   - Evaluators
+   - Session collection
+
+3. **Registry** → Load: `core-concepts/registry.md`
+   - How components are tracked
+   - Auto-detect system
+   - Validation
+   - Install system
+
+4. **Categories** → Load: `core-concepts/categories.md`
+   - How organization works
+   - Naming conventions
+   - Path patterns
+
+---
+
+## I Need To...
+
+| Task            | Load These Files                                            |
+| --------------- | ----------------------------------------------------------- |
+| Add a new agent | `core-concepts/agents.md` + `guides/adding-agent.md`        |
+| Test an agent   | `core-concepts/evals.md` + `guides/testing-agent.md`        |
+| Fix registry    | `core-concepts/registry.md` + `guides/updating-registry.md` |
+| Debug issue     | `guides/debugging.md`                                       |
+| Find files      | `lookup/file-locations.md`                                  |
+| Create release  | `guides/creating-release.md`                                |
+
+---
+
+## Essential Paths (Top 15)
+
+```
+.plcode/agent/core/                    # Core agents (openagent, opencoder)
+.plcode/agent/{category}/              # Category agents
+.plcode/agent/subagents/               # Subagents
+evals/agents/{category}/{agent}/         # Agent tests
+evals/framework/src/                     # Eval framework code
+registry.json                            # Component catalog
+install.sh                               # Installer
+scripts/registry/validate-registry.sh    # Validate registry
+scripts/registry/auto-detect-components.sh # Auto-detect components
+scripts/validation/validate-test-suites.sh # Validate tests
+.plcode/context/                       # Context files
+.plcode/command/                       # Slash commands
+docs/                                    # Documentation
+VERSION                                  # Current version
+package.json                             # Node dependencies
+```
+
+---
+
+## Common Commands (Top 10)
+
+```bash
+# Add new agent (auto-detect)
+./scripts/registry/auto-detect-components.sh --auto-add
+
+# Validate registry
+./scripts/registry/validate-registry.sh
+
+# Test agent
+cd evals/framework && npm run eval:sdk -- --agent={category}/{agent}
+
+# Run smoke test
+cd evals/framework && npm run eval:sdk -- --agent={agent} --pattern="smoke-test.yaml"
+
+# Test with debug
+cd evals/framework && npm run eval:sdk -- --agent={agent} --debug
+
+# Validate test suites
+./scripts/validation/validate-test-suites.sh
+
+# Install locally (test)
+REGISTRY_URL="file://$(pwd)/registry.json" ./install.sh --list
+
+# Bump version
+echo "0.X.Y" > VERSION && jq '.version = "0.X.Y"' package.json > tmp && mv tmp package.json
+
+# Check version consistency
+cat VERSION && cat package.json | jq '.version'
+
+# Run full validation
+./scripts/registry/validate-registry.sh && ./scripts/validation/validate-test-suites.sh
+```
+
+---
+
+## Repository Structure (Quick View)
+
+```
+opencode-agents/
+├── .plcode/
+│   ├── agent/{category}/        # Agents by domain
+│   │   ├── core/                # Core system agents
+│   │   ├── development/         # Dev specialists
+│   │   ├── content/             # Content creators
+│   │   ├── data/                # Data analysts
+│   │   ├── product/             # Product managers
+│   │   ├── learning/            # Educators
+│   │   └── subagents/           # Delegated specialists
+│   ├── command/                 # Slash commands
+│   └── context/                 # Shared knowledge
+├── evals/
+│   ├── agents/{category}/       # Test suites
+│   └── framework/               # Eval framework
+├── scripts/
+│   ├── registry/                # Registry tools
+│   └── validation/              # Validation tools
+├── docs/                        # Documentation
+├── registry.json                # Component catalog
+└── install.sh                   # Installer
+```
+
+---
+
+## Quick Troubleshooting
+
+| Problem                   | Solution                                                  |
+| ------------------------- | --------------------------------------------------------- |
+| Registry validation fails | `./scripts/registry/auto-detect-components.sh --auto-add` |
+| Test fails                | Load `guides/debugging.md`                                |
+| Can't find file           | Load `lookup/file-locations.md`                           |
+| Install fails             | Check: `which curl jq`                                    |
+| Path resolution issues    | Check `core-concepts/categories.md`                       |
+
+---
+
+## Next Steps
+
+1. **First time?** → Read `core-concepts/agents.md`, `evals.md`, `registry.md`
+2. **Adding agent?** → Load `guides/adding-agent.md`
+3. **Testing?** → Load `guides/testing-agent.md`
+4. **Need details?** → Load specific files from `core-concepts/` or `guides/`
+
+---
+
+**Last Updated**: 2025-12-10  
+**Version**: 0.5.0

package/.plcode/context/openagents-repo/templates/context-bundle-template.md

@@ -0,0 +1,272 @@
+# Context Bundle Template
+
+**Purpose**: Template for creating context bundles when delegating tasks to subagents
+
+**Location**: `.tmp/context/{session-id}/bundle.md`
+
+**Used by**: repo-manager agent when delegating to subagents
+
+---
+
+## Template
+
+```markdown
+# Context Bundle: {Task Name}
+
+Session: {session-id}
+Created: {ISO timestamp}
+For: {subagent-name}
+Status: in_progress
+
+## Task Overview
+
+{Brief description of what we're building/doing}
+
+## User Request
+
+{Original user request - what they asked for}
+
+## Relevant Standards (Load These Before Starting)
+
+**Core Standards**:
+
+- `.plcode/context/core/standards/code.md` → Modular, functional code patterns
+- `.plcode/context/core/standards/tests.md` → Testing requirements and TDD
+- `.plcode/context/core/standards/docs.md` → Documentation standards
+- `.plcode/context/core/standards/patterns.md` → Error handling, security patterns
+
+**Core Workflows**:
+
+- `.plcode/context/core/workflows/delegation.md` → Delegation process
+- `.plcode/context/core/workflows/task-breakdown.md` → Task breakdown methodology
+- `.plcode/context/core/workflows/review.md` → Code review guidelines
+
+## Repository-Specific Context (Load These Before Starting)
+
+**Quick Start** (ALWAYS load first):
+
+- `.plcode/context/openagents-repo/quick-start.md` → Repo orientation and common commands
+
+**Core Concepts** (Load based on task type):
+
+- `.plcode/context/openagents-repo/core-concepts/agents.md` → How agents work
+- `.plcode/context/openagents-repo/core-concepts/evals.md` → How testing works
+- `.plcode/context/openagents-repo/core-concepts/registry.md` → How registry works
+- `.plcode/context/openagents-repo/core-concepts/categories.md` → How organization works
+
+**Guides** (Load for specific workflows):
+
+- `.plcode/context/openagents-repo/guides/adding-agent.md` → Step-by-step agent creation
+- `.plcode/context/openagents-repo/guides/testing-agent.md` → Testing workflow
+- `.plcode/context/openagents-repo/guides/updating-registry.md` → Registry workflow
+- `.plcode/context/openagents-repo/guides/debugging.md` → Troubleshooting
+
+**Lookup** (Quick reference):
+
+- `.plcode/context/openagents-repo/lookup/file-locations.md` → Where everything is
+- `.plcode/context/openagents-repo/lookup/commands.md` → Command reference
+
+## Key Requirements
+
+{Extract key requirements from loaded context}
+
+**From Standards**:
+
+- {requirement 1 from standards/code.md}
+- {requirement 2 from standards/tests.md}
+- {requirement 3 from standards/docs.md}
+
+**From Repository Context**:
+
+- {requirement 1 from repo context}
+- {requirement 2 from repo context}
+- {requirement 3 from repo context}
+
+**Naming Conventions**:
+
+- {convention 1}
+- {convention 2}
+
+**File Structure**:
+
+- {structure requirement 1}
+- {structure requirement 2}
+
+## Technical Constraints
+
+{List technical constraints and limitations}
+
+- {constraint 1 - e.g., "Must use TypeScript"}
+- {constraint 2 - e.g., "Must follow category-based organization"}
+- {constraint 3 - e.g., "Must include proper frontmatter metadata"}
+
+## Files to Create/Modify
+
+{List all files that need to be created or modified}
+
+**Create**:
+
+- `{file-path-1}` - {purpose and what it should contain}
+- `{file-path-2}` - {purpose and what it should contain}
+
+**Modify**:
+
+- `{file-path-3}` - {what needs to be changed}
+- `{file-path-4}` - {what needs to be changed}
+
+## Success Criteria
+
+{Define what "done" looks like - binary pass/fail conditions}
+
+- [ ] {criteria 1 - e.g., "Agent file created with proper frontmatter"}
+- [ ] {criteria 2 - e.g., "Eval tests pass"}
+- [ ] {criteria 3 - e.g., "Registry validation passes"}
+- [ ] {criteria 4 - e.g., "Documentation updated"}
+
+## Validation Requirements
+
+{How to validate the work}
+
+**Scripts to Run**:
+
+- `{validation-script-1}` - {what it validates}
+- `{validation-script-2}` - {what it validates}
+
+**Tests to Run**:
+
+- `{test-command-1}` - {what it tests}
+- `{test-command-2}` - {what it tests}
+
+**Manual Checks**:
+
+- {check 1}
+- {check 2}
+
+## Expected Output
+
+{What the subagent should produce}
+
+**Deliverables**:
+
+- {deliverable 1}
+- {deliverable 2}
+
+**Format**:
+
+- {format requirement 1}
+- {format requirement 2}
+
+## Progress Tracking
+
+{Track progress through the task}
+
+- [ ] Context loaded and understood
+- [ ] {step 1}
+- [ ] {step 2}
+- [ ] {step 3}
+- [ ] Validation passed
+- [ ] Documentation updated
+
+---
+
+## Instructions for Subagent
+
+{Specific, detailed instructions for the subagent}
+
+**IMPORTANT**:
+
+1. Load ALL context files listed in "Relevant Standards" and "Repository-Specific Context" sections BEFORE starting work
+2. Follow ALL requirements from the loaded context
+3. Apply naming conventions and file structure requirements
+4. Validate your work using the validation requirements
+5. Update progress tracking as you complete steps
+
+**Your Task**:
+{Detailed description of what the subagent needs to do}
+
+**Approach**:
+{Suggested approach or methodology}
+
+**Constraints**:
+{Any additional constraints or notes}
+
+**Questions/Clarifications**:
+{Any questions the subagent should consider or clarifications needed}
+```
+
+---
+
+## Usage Instructions
+
+### When to Create a Context Bundle
+
+Create a context bundle when:
+
+- Delegating to any subagent
+- Task requires coordination across multiple components
+- Subagent needs project-specific context
+- Task has complex requirements or constraints
+
+### How to Create a Context Bundle
+
+1. **Create session directory**:
+
+   ```bash
+   mkdir -p .tmp/context/{session-id}
+   ```
+
+2. **Copy template**:
+
+   ```bash
+   cp .plcode/context/openagents-repo/templates/context-bundle-template.md \
+      .tmp/context/{session-id}/bundle.md
+   ```
+
+3. **Fill in all sections**:
+   - Replace all `{placeholders}` with actual values
+   - List specific context files to load (with full paths)
+   - Extract key requirements from loaded context
+   - Define clear success criteria
+   - Provide specific instructions
+
+4. **Pass to subagent**:
+
+   ```javascript
+   task(
+     subagent_type="subagents/core/{subagent}",
+     description="Brief description",
+     prompt="Load context from .tmp/context/{session-id}/bundle.md before starting.
+
+             {Specific task instructions}
+
+             Follow all standards and requirements in the context bundle."
+   )
+   ```
+
+### Best Practices
+
+**DO**:
+
+- ✅ List context files with full paths (don't duplicate content)
+- ✅ Extract key requirements from loaded context
+- ✅ Define binary success criteria (pass/fail)
+- ✅ Provide specific validation requirements
+- ✅ Include clear instructions for subagent
+- ✅ Track progress through the task
+
+**DON'T**:
+
+- ❌ Duplicate full context file content (just reference paths)
+- ❌ Use vague success criteria ("make it good")
+- ❌ Skip validation requirements
+- ❌ Forget to list technical constraints
+- ❌ Omit file paths for files to create/modify
+
+### Example Context Bundle
+
+See `.plcode/context/openagents-repo/examples/context-bundle-example.md` for a complete example.
+
+---
+
+**Last Updated**: 2025-01-21  
+**Version**: 1.0.0

package/.plcode/context/product/README.md

@@ -0,0 +1,18 @@
+# Product Context
+
+This directory contains context files for product management, strategy, and user research.
+
+## Available Context Files
+
+_No context files yet. This category is ready for product-related context._
+
+## Planned Context Files
+
+- **product-strategy.md** - Product vision, roadmap planning, prioritization frameworks
+- **user-research-methods.md** - User interview techniques, survey design, usability testing
+- **feature-prioritization.md** - RICE, MoSCoW, Kano model frameworks
+- **metrics-analytics.md** - Key metrics, analytics frameworks, data-driven decisions
+
+## Usage
+
+These context files will be referenced by product-focused agents to ensure consistent product strategy, user research methodologies, and data-driven decision-making.

package/.plcode/context/product/navigation.md

@@ -0,0 +1,18 @@
+# Product Context
+
+This directory contains context files for product management, strategy, and user research.
+
+## Available Context Files
+
+_No context files yet. This category is ready for product-related context._
+
+## Planned Context Files
+
+- **product-strategy.md** - Product vision, roadmap planning, prioritization frameworks
+- **user-research-methods.md** - User interview techniques, survey design, usability testing
+- **feature-prioritization.md** - RICE, MoSCoW, Kano model frameworks
+- **metrics-analytics.md** - Key metrics, analytics frameworks, data-driven decisions
+
+## Usage
+
+These context files will be referenced by product-focused agents to ensure consistent product strategy, user research methodologies, and data-driven decision making.

package/.plcode/context/project/navigation.md

@@ -0,0 +1,31 @@
+# Project Context
+
+**Purpose**: PLCode Agent System project-specific context
+
+**Status**: ⚠️ Legacy - Consider migrating to `openagents-repo/`
+
+---
+
+## Files
+
+| File                 | Purpose                               | Status      |
+| -------------------- | ------------------------------------- | ----------- |
+| `project-context.md` | Technology stack, patterns, workflows | ⚠️ Outdated |
+
+---
+
+## Note
+
+This category contains legacy project context that may be redundant with:
+
+- `openagents-repo/` - Repository-specific context
+- `core/` - Universal standards and workflows
+
+**Recommendation**: Review and migrate useful content to appropriate categories.
+
+---
+
+## Related Context
+
+- `../openagents-repo/` - Current repository context
+- `../core/` - Universal standards

package/.plcode/context/project/project-context.md

@@ -0,0 +1,102 @@
+# PLCode Agent System Project Context
+
+## Technology Stack
+
+**Primary Language:** TypeScript
+**Runtime:** Node.js/Bun
+**Package Manager:** npm/pnpm/yarn
+**Build Tools:** TypeScript Compiler (tsc)
+**Testing:** Jest/Vitest (if configured)
+**Linting:** ESLint (if configured)
+
+## Project Structure
+
+```
+.plcode/
+├── agent/           # AI agents for specific tasks
+│   ├── subagents/   # Specialized subagents
+│   └── *.md         # Primary agents
+├── command/         # Slash commands
+├── context/         # Knowledge base for agents
+└── plugin/          # Extensions and integrations
+
+tasks/               # Task management files
+```
+
+## Core Patterns
+
+### Agent Structure Pattern
+
+```markdown
+---
+description: "What this agent does"
+mode: primary|subagent
+tools: [read, edit, bash, etc.]
+permissions: [security restrictions]
+---
+
+# Agent Name
+
+[Direct instructions for behavior]
+
+**EXECUTE** this [process type] for every [task type]:
+
+**1. [ACTION]** the [subject]:
+
+- [Specific instruction 1]
+- [Specific instruction 2]
+
+**RULES:**
+
+- **ALWAYS** [critical requirement]
+- **NEVER** [forbidden action]
+```
+
+### Command Structure Pattern
+
+```markdown
+---
+name: command-name
+agent: target-agent
+---
+
+You are [doing specific task].
+
+**Request:** $ARGUMENTS
+
+**Context Loaded:**
+@.plcode/context/core/essential-patterns.md
+@[additional context files]
+
+Execute [task] now.
+```
+
+### Context Loading Rules
+
+- Commands load context immediately using @ references
+- Agents can look up additional context deterministically
+- Maximum 4 context files per command (250-450 lines total)
+- Keep context files focused (50-150 lines each)
+
+## Security Guidelines
+
+- Agents have restricted permissions by default
+- Sensitive operations require explicit approval
+- No direct file system modifications without validation
+- Build commands limited to safe operations
+
+## Development Workflow
+
+1. **Planning:** Create detailed task plans for complex work
+2. **Implementation:** Execute one step at a time with validation
+3. **Review:** Code review and security checks
+4. **Testing:** Automated testing and build validation
+5. **Documentation:** Update docs and context files
+
+## Quality Gates
+
+- TypeScript compilation passes
+- Code review completed
+- Build process succeeds
+- Tests pass (if available)
+- Documentation updated