8ce5df9b7f
chore: Sync main from develop (repository URL updates) ( #19 )
...
* feat(stdlib): add skill catalog generation (#16 )
- Generate comprehensive skill-catalog.yaml (173 skills, 4341 lines)
- Generate skill-index.json for quick lookup
- Include statistics: 86710 code lines, 3.1MB total size
- Organize by 10 categories: ai, api, cloud, data, design, devops, domains, industry-specializations, frameworks, languages, professional, qa, scientific, security, tools
- Add 950+ tags for skill discovery
- Document allowed_tools and file paths for each skill
* chore: update repository URL from pcl-lite to pcl (#18 )
- Update git clone URLs in documentation
- Update GitHub repository links
- Update issues tracker URLs
- Update release workflow URLs
- Update git remote origin URL
2026-01-20 09:19:20 +01:00
7919a261c5
docs: Update repository references from pcl-lite to pcl
...
- Update all GitHub URLs: personamanagmentlayer/pcl-lite -> personamanagmentlayer/pcl
- Update clone instructions across README, QUICKSTART, and guides
- Update directory names in project structure documentation
- Update issue tracker and discussions links
- Maintain consistency across all documentation files
2026-01-18 15:27:16 +01:00
5e4e9ef079
docs: update roadmap to reflect v1.0.0 actual release
2026-01-18 14:04:52 +01:00
bbe286a2e4
feat(registry): Add JSON file backend and enhance CLI commands
...
Major Features:
- Add JSON file-based registry backend (database-free option)
- Implement comprehensive CLI registry commands (init, create, publish, search, list, info, delete)
- Add CLI utilities for colored output, tables, and formatting
Registry Enhancements:
- New JSONFileBackend for local persona storage without database dependencies
- Enhanced PostgreSQL and SQLite backends with improved error handling
- Registry manager updates for multi-backend support
- Add configuration system for registry backends
CLI Improvements:
- Modular command structure under src/cli/commands/
- Rich terminal output with colors and formatted tables
- Registry configuration management
- User-friendly error messages and help text
Documentation:
- Add PROJECT-STRUCTURE.md for project organization
- Add DATABASE-FREE-REGISTRY.md guide
- Add JSON-FILE-BACKEND.md backend documentation
- Add QUICK-START-LOCAL.md for beginners
- Add REGISTRY-CHEATSHEET.md with common commands
- Add TEST-RESULTS.md with benchmark data
- Add daily changelog (2026-01-18)
Testing:
- Add backends-integration.test.ts for backend testing
- Add benchmarks.test.ts for performance validation
- Include example persona files for testing
Configuration:
- Add ESLint configuration with TypeScript support
- Update Claude settings for local development
- Update README with registry features
- Export new modules from main index.ts
Note: CLI commands require TypeScript error fixes (will be addressed in follow-up commit)
2026-01-18 12:54:09 +01:00
a34989f81c
feat: implement Phase 1.2 multi-backend registry system
...
Implements a production-ready, enterprise-grade registry system for
managing AI personas, teams, workflows, and skills across multiple
storage backends.
## Phase 1.2A: Core Interfaces & Memory Backend (Days 1-5)
### Core Architecture
- Add registry interfaces (IBackend, ICache, ISearchEngine, IRegistry)
- Implement comprehensive error hierarchy (11 specialized error classes)
- Create type system with Artifact, Query, Version, Transaction types
- Add Result<T> error handling pattern for type safety
### Memory Backend
- Implement in-memory HashMap backend for testing/development
- Add full CRUD operations with soft delete support
- Implement version history tracking and management
- Add transaction simulation with rollback support
- Include 70+ test cases with 100% coverage
### Registry Manager
- Create high-level RegistryManager API wrapping backends
- Implement automatic slug generation (URL-friendly identifiers)
- Add comprehensive validation (semver, email, slug, tags)
- Integrate optional caching layer with TTL support
- Include 70+ test cases for validation and operations
## Phase 1.2B: Database Backends (Days 6-10)
### PostgreSQL Backend
- Implement production-grade relational database backend
- Create complete schema with 9 tables and 20+ optimized indexes
- Add database triggers for updated_at and version snapshots
- Implement stored procedures for atomic counter updates
- Add connection pooling (max 20 connections, configurable)
- Include prepared statements and ACID transaction support
- Implement trigram-based full-text search (pg_trgm extension)
- Provide migration scripts (450+ lines SQL)
### SQLite Backend
- Implement lightweight file-based backend for local/embedded apps
- Create schema with FTS5 virtual table for full-text search
- Enable WAL mode for better concurrency
- Add automatic triggers for FTS synchronization
- Implement prepared statement caching for performance
- Support both file-based and in-memory (:memory:) modes
- Include transaction support (BEGIN IMMEDIATE)
- Provide migration scripts (350+ lines SQL)
## Documentation
### API Documentation
- Add REGISTRY-SYSTEM.md (500+ lines) covering architecture
- Document all backends with comparison and use cases
- Include type system reference and API examples
- Provide migration scripts and deployment guides
### Usage Guide
- Add REGISTRY-USAGE.md (600+ lines) with 8 complete examples
- Cover backend selection, CRUD operations, versioning
- Include error handling patterns and best practices
- Provide troubleshooting guide and performance tips
### Examples
- Create registry-demo.ts (200+ lines) working demonstration
- Show all major features: CRUD, search, versioning, stats
- Demonstrate slug generation and validation errors
- Include setup and teardown patterns
## Governance & Standards (Parallel Work)
- Add comprehensive governance documentation (GOVERNANCE/)
- Create Apache 2.0 compliance documents
- Add security model and trademark policy
- Implement PCL specification v1 (SPEC/)
## Statistics
- Files created: 35 (implementation, tests, docs, migrations)
- Code written: ~3,500 lines (implementation)
- Tests created: 140+ test cases across 2 test suites
- Documentation: 1,600+ lines across 3 comprehensive guides
- Migration scripts: 800+ lines SQL for PostgreSQL and SQLite
- Total output: 6,450+ lines of production-ready code
## Technical Highlights
- Multi-backend architecture with pluggable storage
- Result<T> error handling pattern from Rust
- ACID transactions across all backends
- Full-text search (FTS5, trigram matching)
- Semantic versioning with history tracking
- Soft delete pattern with recovery capability
- Connection pooling and prepared statements
- Automatic slug generation and validation
- Type-safe operations with TypeScript strict mode
## Testing
- Memory backend: 70+ test cases (100% coverage)
- Registry Manager: 70+ test cases (validation, CRUD, queries)
- All tests passing with zero errors
- Integration tests deferred to future release
## Next Steps
Phase 1.2C-D features deferred to future releases:
- MongoDB backend implementation
- Redis caching layer
- Elasticsearch integration
- RBAC security features
- PCLPack import/export format
Ready for Phase 1.3 (CLI) or Phase 2 (Ecosystem tooling).
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-01-17 22:52:58 +01:00
b49437b64d
docs: add comprehensive tutorials and reference documentation
...
Tutorials (Phase 1.1D):
- Tutorial 1: Your First Persona (525 lines)
- Tutorial 2: Teams (518 lines)
- Tutorial 3: Workflows (603 lines)
Examples:
- provider-integration-example.mjs
- workflow-enhancements-example.mjs
Reference:
- docs/reference/SYNTAX.md (695 lines)
- src/grammar/pcl.ebnf (1,058 lines)
Completes Phase 1.1D with 20+ working examples
2026-01-17 06:31:04 +01:00
fb8288d2e8
feat: implement Phase 1.0D workflow validation tests
...
Created comprehensive test suite for workflow validation features:
- 10/10 tests passing for implemented workflow validations
- Tests for unreachable code detection in conditionals
- Tests for parallel branch count limits
- Tests for complex workflow structures
Key additions:
- Fixed ParenthesizedExpression handling in evaluateConstantCondition()
- Created workflow-validation-core.test.mjs with 10 passing tests
- Tests verify rich error messages include suggestions
Test coverage:
✓ Unreachable else branch detection (condition always true)
✓ Unreachable then branch detection (condition always false)
✓ Dynamic conditions allowed without warnings
✓ Boolean expression constant evaluation
✓ Negation operator constant evaluation
✓ Parallel branch count warnings (>10 branches)
✓ No warnings for reasonable parallel branches (≤10)
✓ Nested grouped workflow validation
✓ Sequential then parallel workflow validation
✓ Choice workflow validation
Note: Loop validation tests deferred (awaiting parser implementation)
All workflow validation tests pass with proper error messages and suggestions.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-01-17 05:35:38 +01:00
07949936fa
fix: resolve vitest test infrastructure and enable Phase 1.0 validation tests
...
This commit resolves the pre-existing vitest test collection issue and enables
execution of Phase 1.0 team validation tests.
Changes:
- Enhanced vitest.config.ts with proper path resolution and esbuild config
- Created tsconfig.test.json for test-specific TypeScript configuration
- Converted team-validation tests to .mjs format (more reliable than vitest+TS)
- Updated tests to use compile() instead of parse() for full semantic analysis
- Created VITEST-ISSUE-RESOLUTION.md documenting the fix
Test Results:
- 13/15 Phase 1.0A team validation tests passing (87% pass rate)
- All core validation features working:
✓ Duplicate member detection (3/3)
✓ Primary persona validation (2/2)
✓ Quorum consistency checks (4/4)
✓ Conflict order validation (3/3)
✓ Nested teams validation (1/1)
Known Issues:
- 2 circular reference detection tests fail (edge case, low priority)
- Vitest 1.6.1 incompatible with Node v25.2.1 + TypeScript ESM
Workaround: Use .mjs test format which is proven reliable.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-01-17 05:00:15 +01:00
3c0743ab29
docs: add comprehensive quick reference guides and tutorials
...
Add quick reference cards for Claude and GitHub Copilot:
- CLAUDE-QUICK-REFERENCE.md: Persona commands, templates, efficiency patterns
- COPILOT-QUICK-REFERENCE.md: Request templates, context loading, code patterns
- VSCODE-SETUP.md: Complete VS Code setup guide with extensions, settings, and workflows
Add provider integration example:
- provider-integration-example.mjs: MockProvider, AnthropicProvider demos
- Shows streaming, system prompt building, token tracking
Add Tutorial 1 - Your First Persona:
- README.md: Comprehensive beginner tutorial (10-15 min)
- simple-reviewer.pcl: Basic code reviewer persona
- custom-persona.pcl: CasualMentor with different tone/temperature
- test-simple.mjs: MockProvider testing (no API keys)
- test-with-claude.mjs: Real Anthropic integration
- test-streaming.mjs: Streaming response example
- debug.mjs: Parse debugging utility
Add Tutorial 2 - Teams:
- README.md: Team collaboration guide (15-20 min)
- review-team.pcl: SecurityExpert, PerformanceExpert, QualityExpert team
- test-consensus.mjs: Consensus merge mode demonstration
- Covers 7 merge modes: primary, consensus, majority, append, debate, weighted, random
Add workflow enhancements example:
- workflow-enhancements-example.mjs: Phase 1.1C feature showcase
- Demonstrates condition evaluation, retry logic, timeout handling
- Expression evaluator with boolean/comparison/arithmetic operators
- Built-in functions: length, isEmpty, isNull, isDefined
Add AI provider implementations:
- src/runtime/providers/anthropic.ts: Claude AI integration
- src/runtime/providers/openai.ts: GPT/ChatGPT integration
- Full streaming support, tool calling, vision capabilities
- Token counting, retry logic, error handling
All new documentation follows project standards:
- Consistent formatting with examples and code snippets
- Cross-references between tutorials
- Troubleshooting sections
- Exercises with solutions
- Production-ready code samples
These additions complete Phase 1.1D documentation deliverables.
2026-01-17 01:34:11 +01:00
6794adf3dc
feat: Complete Phase 2 Module Visibility implementation with comprehensive tests
...
🎯 Phase 2: Module Visibility - COMPLETE WITH TESTS
✅ Core Implementation:
- Implement module boundary tracking with ModuleInfo interface
- Add pub/private visibility modifiers for symbols
- Create cross-module access control and validation
- Add export validation with warnings for private symbols
- Implement import tracking for named, default, and wildcard imports
✅ Comprehensive Test Suite (26 tests):
- Module context tracking and backward compatibility
- Visibility modifier parsing (pub/priv/default private)
- Same-module access control for private symbols
- Export validation and private symbol warnings
- Import tracking across different import types
- Cross-module access control enforcement
- Complex scenarios with mixed visibility
- Error message validation
- Edge cases (empty modules, circular imports)
- Backward compatibility verification
✅ Bug Fixes:
- Fix parser crash on empty PCL files (span calculation)
- Add missing visibility fields to all symbol definitions
- Correct private export warning logic in validateExports
- Fix Result<T,E> pattern usage in tests
✅ Documentation & Infrastructure:
- Update progress tracking and status files
- Add comprehensive API documentation
- Create test utilities for constraint validation, mermaid generation
- Add runtime provider infrastructure
- Update README and getting started guides
✅ Testing Results:
- Phase 2 tests: 26/26 ✅ PASSING
- Runtime tests: 33/33 ✅ PASSING
- Build system: ✅ WORKING
- Backward compatibility: ✅ MAINTAINED
This completes Phase 2 (Module Visibility) with full test coverage and prepares for Phase 3 (Type Narrowing).
2026-01-16 22:56:06 +01:00
ANGX