Feature/linkedin analytics by eccentricnode · Pull Request #1 · eccentricnode/ContentEngine

eccentricnode · 2026-02-06T07:54:36Z

No description provided.

- Dual-mode web UI updates - Database schema changes - Context capture working - Demo mode functional Preparing for Ralph to implement Phase 3 Semantic Blueprints autonomously. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Created blueprints/ directory with subdirectories for: - frameworks/linkedin/ - Content structure patterns (STF, MRS, SLA, PIF) - workflows/ - Multi-step processes (Sunday Power Hour, Repurposing) - constraints/ - Brand voice and platform rules - templates/ - Handlebars prompt templates Added comprehensive README.md explaining: - Directory structure and purpose - Blueprint types (frameworks, workflows, constraints, templates) - Usage examples - File format specification - Design principles Tests: - Verify all required directories exist - Verify README exists and contains key sections - mypy: PASS - ruff: PASS - pytest: PASS (2 new tests, 64 total) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Created blueprint loader module with caching and comprehensive error handling: - load_framework(name, platform) - Load framework blueprints (STF, MRS, SLA, PIF) - load_workflow(name) - Load workflow blueprints (SundayPowerHour, etc.) - load_constraints(name) - Load constraint blueprints (BrandVoice, etc.) - clear_cache() - Cache invalidation support - list_blueprints() - Discovery of available blueprints Features: - In-memory caching for performance (controllable via use_cache param) - YAML parsing with PyYAML - Graceful error handling for missing files - Type hints and comprehensive docstrings - Cache key pattern: "{type}:{platform}:{name}" Dependencies added: - pyyaml==6.0.3 - types-pyyaml==6.0.12.20250915 (dev) Tests: - 13 new tests covering: - Successful blueprint loading - File not found errors - Invalid YAML handling - Caching behavior (full and selective) - Blueprint discovery - mypy: PASS - ruff: PASS - pytest: PASS (77 total tests) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Created template renderer module for Handlebars-style templates using Chevron: - render_template(name, context) - Render template from blueprints/templates/ - render_template_string(template, context) - Render template string directly - get_templates_dir() - Get templates directory path Features: - Mustache/Handlebars template syntax via Chevron - Support for variables, loops, conditionals, nested objects - HTML entity escaping by default for safety - Graceful error handling with clear error messages - Type hints and comprehensive docstrings Template syntax (Chevron-compatible): - Variables: {{variable}} - Loops: {{#items}}{{.}}{{/items}} - Conditionals: {{#condition}}...{{/condition}} - Inverted: {{^condition}}...{{/condition}} - Nested: {{user.name}} Dependencies added: - chevron==0.14.0 Tests: - 12 new tests covering: - Simple variable substitution - Complex templates with loops and nested data - File not found errors - Missing variables (rendered as empty string) - Conditionals and inverted sections - Nested object access - HTML entity escaping - Unicode support - mypy: PASS - ruff: PASS - pytest: PASS (89 total tests) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Added Blueprint model to database schema for optional blueprint caching: - id (Integer, primary key) - name (String, blueprint name) - category (String, framework/workflow/constraint) - platform (String, nullable - for framework platform, NULL for workflows/constraints) - data (JSON, parsed YAML blueprint data) - version (String, optional versioning) - created_at, updated_at (DateTime, timestamps) Database changes: - Added JSON import to sqlalchemy for JSON column type - Created Blueprint model class with relationships and repr - Generated Alembic migration: 4864d1c47cec - Ran migration successfully: blueprints table created Tests: - 8 comprehensive tests covering: - Create blueprint record - Read blueprint record - Update blueprint (data + version) - Delete blueprint record - Query by category - repr method - NULL platform handling (workflows/constraints) - Complex JSON data persistence - All tests use setattr() to avoid mypy assignment errors with Column types - pytest: PASS (97 total tests, 8 new) Note: Pre-existing mypy errors in database.py (Session name conflict, type annotations) not fixed as they're unrelated to this story. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Added blueprints CLI group to manage content blueprints: - `content-engine blueprints list` - List all available blueprints - `--category` option to filter by frameworks/workflows/constraints - Displays blueprints grouped by category with nice formatting Implementation: - Added @cli.group() for blueprints command group - list command queries blueprint_loader.list_blueprints() - Displays results in organized format with category headers - Error handling with logger integration CLI output format: ``` 📋 Available Blueprints FRAMEWORKS: • linkedin/STF • linkedin/MRS WORKFLOWS: • SundayPowerHour CONSTRAINTS: • BrandVoice ``` Tests: - 4 new CLI tests using Click's CliRunner: - Empty blueprints list - Category filtering - List with actual YAML files - Help command - All tests use monkeypatch to mock blueprints directory - pytest: PASS (101 total tests, 4 new) Manual testing: - uv run content-engine blueprints list ✓ - uv run content-engine blueprints --help ✓ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- Created blueprints/frameworks/linkedin/STF.yaml - Comprehensive Storytelling Framework (Problem/Tried/Worked/Lesson) - Includes structure, validation rules, compatible pillars, examples - Added best practices, anti-patterns, voice guidelines - 10 unit tests validating YAML structure and content - All tests pass (111 total) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>