codymaster 4.1.3 → 4.3.0

package/skills/cm-content-factory/sites/docs-site/src/content/docs/architecture.md

@@ -0,0 +1,90 @@
+---
+title: "Kiến trúc Hệ thống"
+description: "Kiến trúc Content Factory — Memory System, Content Pipeline, Intelligence Layer, và Extension System."
+keywords: ["architecture", "content factory", "system design"]
+sidebar:
+  order: 2
+---
+
+# Kiến trúc Hệ thống
+
+> **Quick Reference**
+> - **Type**: AI Content Production Pipeline
+> - **Core**: 8 operating modes
+> - **Intelligence**: 3-layer memory + scoreboard
+> - **Config**: Single JSON file
+
+## Architecture Diagram
+
+```mermaid
+graph TB
+    style Memory fill:#ecfdf5,stroke:#10b981,color:#18181b
+    style Pipeline fill:#f8fafc,stroke:#60a5fa,color:#18181b
+    style Intel fill:#fef3c7,stroke:#f59e0b,color:#18181b
+    style Ext fill:#fce7f3,stroke:#ec4899,color:#18181b
+
+    subgraph Memory["🧠 Memory System"]
+        M1["Semantic<br/>(long-term patterns)"]
+        M2["Episodic<br/>(session experiences)"]
+        M3["Working<br/>(current context)"]
+    end
+
+    subgraph Pipeline["⚙️ Content Pipeline"]
+        P1["Extract"] --> P2["Plan"]
+        P2 --> P3["Write"]
+        P3 --> P4["Audit"]
+        P4 --> P5["SEO"]
+        P5 --> P6["Publish"]
+    end
+
+    subgraph Intel["📊 Intelligence Layer"]
+        I1["Scoreboard"]
+        I2["Learn Engine"]
+        I3["Research Engine"]
+        I4["Monetize Scorer"]
+    end
+
+    subgraph Ext["🔌 Extensions"]
+        E1["Hooks"]
+        E2["OpenClaw Adapter"]
+    end
+
+    Memory --> Pipeline
+    Pipeline --> Intel
+    Intel --> Memory
+    Ext --> Pipeline
+```
+
+## Core Components
+
+| Component | File | Mô tả |
+|-----------|------|-------|
+| Pipeline Orchestrator | `scripts/pipeline.py` | Master orchestrator cho full auto mode |
+| Extractor | `scripts/extract.py` | Trích xuất kiến thức từ documents |
+| Planner | `scripts/plan.py` | Lên kế hoạch topics từ knowledge base |
+| Writer | `scripts/write.py` | AI content writer với memory context |
+| Auditor | `scripts/audit.py` | Kiểm tra chất lượng + auto-fix |
+| SEO Optimizer | `scripts/seo.py` | Tối ưu SEO metadata |
+| Publisher | `scripts/publish.py` | Build và deploy content |
+| Memory Engine | `scripts/memory.py` | 3-layer memory management |
+| Scoreboard | `scripts/scoreboard.py` | Reward/penalty tracking |
+| Researcher | `scripts/research.py` | Auto-research engine |
+| Monetizer | `scripts/monetize.py` | Monetization scoring |
+
+## Architecture Decisions
+
+| # | Decision | Rationale |
+|---|----------|-----------|
+| 1 | Config-driven | Một file JSON điều khiển toàn bộ — portable, version-controllable |
+| 2 | 3-layer memory | Semantic (patterns) + Episodic (experiences) + Working (context) |
+| 3 | Reward/penalty scoring | Gamification + data-driven quality improvement |
+| 4 | Hook-based extensions | Extensible mà không modify core pipeline |
+| 5 | Script-per-mode | Mỗi mode là một script độc lập — composable |
+
+## Security
+
+| Layer | Approach |
+|-------|----------|
+| Config | `.gitignore` API keys, environment variables |
+| Memory | Local storage, no external sync |
+| Extensions | Sandboxed hooks, no arbitrary code execution |

package/skills/cm-content-factory/sites/docs-site/src/content/docs/data-flow.md

@@ -0,0 +1,54 @@
+---
+title: "Data Flow"
+description: "Data flow diagram cho Content Factory — config → extract → plan → write → audit → publish loop."
+keywords: ["data flow", "content factory", "pipeline"]
+sidebar:
+  order: 3
+---
+
+# Data Flow
+
+> **Quick Reference**
+> - **Input**: Config + Source documents
+> - **Output**: Published content + Updated memory
+> - **Pattern**: Config → Extract → Plan → Write → Audit → SEO → Publish → Learn
+
+## End-to-End Data Flow
+
+```mermaid
+graph LR
+    style Config fill:#ecfdf5,stroke:#10b981,color:#18181b
+    style Sources fill:#f8fafc,stroke:#60a5fa,color:#18181b
+    style Output fill:#fef3c7,stroke:#f59e0b,color:#18181b
+
+    Config["📄 Config JSON"] --> Pipeline["⚙️ Pipeline"]
+    Sources["📁 Source Docs"] --> Pipeline
+    Pipeline --> Output["📤 Published Content"]
+    Pipeline --> Memory["🧠 Updated Memory"]
+```
+
+## Data Stores
+
+| Store | Path | Format | Mô tả |
+|-------|------|--------|-------|
+| Config | `content-factory.config.json` | JSON | Điều khiển toàn bộ pipeline |
+| Knowledge Base | `knowledge-base/` | JSON per category | Kiến thức trích xuất |
+| Topic Queue | `topics-queue/` | JSON per batch | Topics chờ viết |
+| Content Output | `content/` (configurable) | Markdown | Bài viết generated |
+| Semantic Memory | `memory/semantic/` | JSON | Patterns dài hạn |
+| Episodic Memory | `memory/episodic/` | JSON | Experiences per session |
+| Working Memory | `memory/working/` | JSON | Context hiện tại |
+| Scoreboard | `memory/scoreboard.json` | JSON | Points tracking |
+
+## Pipeline Modes Flow
+
+| Step | Mode | Input | Output |
+|------|------|-------|--------|
+| 1 | Extract | Source docs + Config | Knowledge base JSON |
+| 2 | Plan | Knowledge base + Config | Topic queue JSON |
+| 3 | Write | Topics + Memory context | Content articles |
+| 4 | Audit | Content articles | Pass/Fail + fixes |
+| 5 | SEO | Content articles | Optimized metadata |
+| 6 | Publish | Approved content | Deployed site |
+| 7 | Learn | User feedback (git diff) | Updated memory |
+| 8 | Research | New topic keyword | Knowledge JSON |

package/skills/cm-content-factory/sites/docs-site/src/content/docs/deployment.md

@@ -0,0 +1,38 @@
+---
+title: "Deployment"
+description: "Hướng dẫn deploy Content Factory documentation site — Astro Starlight setup, build, và deploy."
+keywords: ["deployment", "content factory", "astro starlight"]
+sidebar:
+  order: 4
+---
+
+# Deployment Guide
+
+> **Quick Reference**
+> - **Build**: `npm run build` → `dist/`
+> - **Deploy**: Cloudflare Pages / Vercel / GitHub Pages
+> - **Preview**: `npm run preview -- --port 4321`
+
+## Quick Deploy
+
+```bash
+# Build
+cd astro-site
+npm run build
+
+# Preview local
+npm run preview -- --port 4321
+
+# Deploy to Cloudflare Pages
+# Build command: npm run build
+# Build output: dist
+```
+
+## Deploy Options
+
+| Platform | Build Command | Output |
+|----------|--------------|--------|
+| Cloudflare Pages | `npm run build` | `dist` |
+| Vercel | `npm run build` | `dist` |
+| GitHub Pages | `npm run build` | `dist` |
+| Netlify | `npm run build` | `dist` |

package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/index.md

@@ -0,0 +1,65 @@
+---
+title: "Process Flows"
+description: "Tất cả process flow diagrams cho Content Factory — pipeline workflow, memory lifecycle, content journey."
+keywords: ["process flow", "workflow", "content factory", "pipeline"]
+sidebar:
+  order: 1
+---
+
+# Process Flows
+
+> **Quick Reference**
+> - **Workflows**: 2
+> - **Sequences**: 1
+> - **Lifecycles**: 1
+> - **Journeys**: 1
+
+## System Overview
+
+```mermaid
+graph TB
+    style System fill:#f8fafc,stroke:#e5e7eb,color:#18181b
+
+    subgraph System["Content Factory"]
+        M1["Extract"]
+        M2["Plan"]
+        M3["Write"]
+        M4["Audit"]
+        M5["SEO"]
+        M6["Publish"]
+        M7["Learn"]
+        M8["Research"]
+    end
+
+    M1 --> M2 --> M3 --> M4 --> M5 --> M6
+    M4 -->|"fail"| M3
+    M6 --> M7
+    M8 --> M1
+```
+
+## Directory
+
+### Workflows
+
+| # | Flow | Persona | Link |
+|---|------|---------|------|
+| 1 | Content Pipeline | Content Manager Lan | [Xem](./wf-content-pipeline) |
+| 2 | Self-Learning Cycle | Hệ thống tự động | [Xem](./wf-learning-cycle) |
+
+### Sequences
+
+| # | Flow | Components | Link |
+|---|------|-----------|------|
+| 1 | Write Mode Processing | 5 steps | [Xem](./seq-write-mode) |
+
+### Lifecycles
+
+| # | Entity | States | Link |
+|---|--------|--------|------|
+| 1 | Content Article | 7 states | [Xem](./lc-content-lifecycle) |
+
+### Journeys
+
+| # | Journey | Persona | Link |
+|---|---------|---------|------|
+| 1 | First Content Batch | Content Writer Tú | [Xem](./uj-first-batch) |

package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/lc-content-lifecycle.md

@@ -0,0 +1,48 @@
+---
+title: "Content Lifecycle"
+description: "Vòng đời content article — 7 trạng thái từ Draft đến Archived. State diagram cho content management."
+keywords: ["lifecycle", "content states", "state diagram"]
+sidebar:
+  order: 5
+---
+
+# 🔁 Content Article Lifecycle
+
+> **Quick Reference**
+> - **Entity**: Content Article
+> - **States**: 7
+> - **Terminal**: Archived, Deleted
+
+## State Diagram
+
+```mermaid
+stateDiagram-v2
+    direction LR
+    
+    [*] --> Draft : write mode
+    Draft --> InReview : submit
+    InReview --> Draft : reject
+    InReview --> Approved : pass audit
+    Approved --> SEOOptimized : seo mode
+    SEOOptimized --> Published : publish
+    Published --> Updated : user edits
+    Updated --> InReview : resubmit
+    Published --> Archived : outdated
+    Draft --> Deleted : discard
+    Deleted --> [*]
+    Archived --> [*]
+```
+
+## Transition Table
+
+| From | To | Trigger | Score Impact |
+|------|----|---------|-------------|
+| — | Draft | Write mode creates content | 0 |
+| Draft | InReview | Submit for audit | 0 |
+| InReview | Draft | Audit fail | -3 |
+| InReview | Approved | Audit pass | +3 |
+| Approved | SEOOptimized | SEO mode runs | 0 |
+| SEOOptimized | Published | Publish mode | 0 |
+| Published | Updated | User edits | -5 |
+| Published | Archived | Content outdated | 0 |
+| Draft | Deleted | User discards | -10 |

package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/seq-write-mode.md

@@ -0,0 +1,39 @@
+---
+title: "Write Mode Sequence"
+description: "Sequence diagram cho Write Mode — memory loading, template selection, content generation, scoring."
+keywords: ["sequence diagram", "write mode", "content generation"]
+sidebar:
+  order: 4
+---
+
+# ⏱️ Write Mode — Sequence
+
+> **Quick Reference**
+> - **Trigger**: `scripts/write.py --batch N`
+> - **Components**: Memory, Template Engine, AI Writer, Audit, Scoreboard
+> - **Steps**: 8
+
+## Sequence Diagram
+
+```mermaid
+sequenceDiagram
+    autonumber
+    
+    actor User as 👤 User
+    participant Mem as 🧠 Memory
+    participant Topic as 📋 Topic Queue
+    participant Writer as ✍️ AI Writer
+    participant Audit as 🔍 Auditor
+    participant Score as 📊 Scoreboard
+
+    User->>Writer: write --batch 1
+    Writer->>Mem: Load context (semantic + episodic)
+    Mem-->>Writer: Writing patterns, style, mistakes
+    Writer->>Topic: Get next topic
+    Topic-->>Writer: Topic + knowledge context
+    Writer->>Writer: Generate content
+    Writer->>Audit: Auto-audit
+    Audit-->>Score: +3 if pass, -3 if fail
+    Writer->>Mem: Create episodic memory
+    Writer-->>User: Content articles ready
+```

package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/uj-first-batch.md

@@ -0,0 +1,42 @@
+---
+title: "First Content Batch — Journey"
+description: "User journey map cho Content Writer viết batch đầu tiên — từ onboarding đến published."
+keywords: ["user journey", "content writer", "first batch"]
+sidebar:
+  order: 6
+---
+
+# 🗺️ First Content Batch — User Journey
+
+> **Quick Reference**
+> - **Persona**: [Content Writer Tú](../personas/user-writer-tu)
+> - **Thời gian**: ~2 giờ
+> - **Steps**: 6
+
+## Journey Map
+
+```mermaid
+journey
+    title First Content Batch — Writer Tú
+    section Onboarding
+        Đọc config & guidelines: 3: Writer Tú
+        Tìm hiểu knowledge base: 4: Writer Tú
+    section Writing
+        Chạy write mode: 4: Writer Tú
+        Review generated content: 3: Writer Tú
+    section Validation
+        Self-audit: 4: Writer Tú
+        Fix audit feedback: 3: Writer Tú
+    section Success
+        Content approved: 5: Writer Tú
+        Published live: 5: Writer Tú
+```
+
+## Journey Details
+
+| Phase | Step | Cảm xúc | Pain Points |
+|-------|------|---------|-------------|
+| Onboarding | Đọc config | 😐 Neutral | Config options nhiều |
+| Writing | Chạy write mode | 😊 Excited | Output quality varies |
+| Validation | Self-audit | 😤 Anxious | Fix issues lần đầu |
+| Success | Published | 😊 Happy | — |

package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/wf-content-pipeline.md

@@ -0,0 +1,51 @@
+---
+title: "Content Pipeline Workflow"
+description: "Business workflow cho Content Factory pipeline — từ Extract đến Publish, với audit loop và memory integration."
+keywords: ["workflow", "content pipeline", "automation"]
+sidebar:
+  order: 2
+---
+
+# 🔄 Content Pipeline Workflow
+
+> **Quick Reference**
+> - **Persona**: [Content Manager Lan](../personas/user-content-manager-lan)
+> - **Trigger**: Có source documents mới hoặc cần batch mới
+> - **Outcome**: Published content đạt audit standards
+
+## Process Flow
+
+```mermaid
+graph TB
+    style Start fill:#ecfdf5,stroke:#10b981,color:#18181b
+    style End fill:#ecfdf5,stroke:#10b981,color:#18181b
+    style Decision fill:#fef3c7,stroke:#f59e0b,color:#18181b
+
+    Start(["▶ Source Documents"])
+    A["1. Extract Knowledge"]
+    B["2. Plan Topics"]
+    C["3. Write Content"]
+    D["4. Auto Audit"]
+    Decision{"Pass?"}
+    E["5. SEO Optimize"]
+    F["6. Publish"]
+    G["Fix Issues"]
+    H["7. Learn & Score"]
+    End(["✅ Published"])
+
+    Start --> A --> B --> C --> D --> Decision
+    Decision -->|"Pass"| E --> F --> H --> End
+    Decision -->|"Fail"| G --> C
+```
+
+## Step Details
+
+| Bước | Mode | Command | Output |
+|------|------|---------|--------|
+| 1 | Extract | `scripts/extract.py` | `knowledge-base/` |
+| 2 | Plan | `scripts/plan.py` | `topics-queue/batch-{DATE}.json` |
+| 3 | Write | `scripts/write.py --batch N` | Content articles |
+| 4 | Audit | `scripts/audit.py` | Pass/Fail report |
+| 5 | SEO | `scripts/seo.py extract && apply` | Optimized metadata |
+| 6 | Publish | `scripts/publish.py` | Deployed content |
+| 7 | Learn | `scripts/memory.py --learn` | Updated memory |

package/skills/cm-content-factory/sites/docs-site/src/content/docs/flows/wf-learning-cycle.md

@@ -0,0 +1,52 @@
+---
+title: "Self-Learning Cycle"
+description: "Workflow cho Content Factory self-learning cycle — feedback detection, pattern extraction, memory update."
+keywords: ["workflow", "self-learning", "memory", "feedback"]
+sidebar:
+  order: 3
+---
+
+# 🔄 Self-Learning Cycle
+
+> **Quick Reference**
+> - **Trigger**: Sau user feedback, edits, hoặc deletes
+> - **Outcome**: Memory system cập nhật, writing quality cải thiện
+
+## Process Flow
+
+```mermaid
+graph TB
+    style Start fill:#ecfdf5,stroke:#10b981,color:#18181b
+    style End fill:#ecfdf5,stroke:#10b981,color:#18181b
+
+    Start(["▶ User Feedback"])
+    A["1. Detect Changes (git diff)"]
+    B["2. Calculate Score"]
+    C["3. Extract Patterns"]
+    D["4. Update Semantic Memory"]
+    E["5. Adjust Writing Style"]
+    End(["✅ System Improved"])
+
+    Start --> A --> B --> C --> D --> E --> End
+```
+
+## Scoring Rules
+
+| Event | Points | Detection |
+|-------|--------|-----------|
+| User praise | +10 | Keyword detection |
+| Engagement | +5 | Analytics hook |
+| Audit pass first try | +3 | Auto-detect |
+| User edits article | -5 | Git diff |
+| User deletes article | -10 | Git diff |
+| Audit fail | -3 | Auto-detect |
+
+## Grading Tiers
+
+| Tier | Points | Level |
+|------|--------|-------|
+| 🏆 S-Tier | 100+ | Master content creator |
+| 🥇 A-Tier | 50-99 | Expert |
+| 🥈 B-Tier | 20-49 | Skilled |
+| 🥉 C-Tier | 0-19 | Learning |
+| 📉 D-Tier | < 0 | Needs improvement |

package/skills/cm-content-factory/sites/docs-site/src/content/docs/getting-started/configuration.md

@@ -0,0 +1,86 @@
+---
+title: "Cấu hình"
+description: "Tất cả configuration options cho Content Factory — niche, brand, content, sources, output, pipeline, SEO, audit, memory, scoring."
+keywords: ["cấu hình", "configuration", "config", "content factory"]
+sidebar:
+  order: 3
+---
+
+# Cấu hình
+
+Toàn bộ Content Factory điều khiển qua một file: `content-factory.config.json`.
+
+## Config Sections
+
+| Section | Mô tả | Bắt buộc |
+|---------|-------|---------|
+| `niche` | Lĩnh vực và keywords | ✅ |
+| `brand` | Thương hiệu và tone | ✅ |
+| `content` | Loại bài viết, word count | ✅ |
+| `sources` | Input paths và formats | ✅ |
+| `output` | Output path và format | ✅ |
+| `pipeline` | Pipeline configuration | ❌ |
+| `seo` | SEO settings | ❌ |
+| `audit` | Audit rules | ❌ |
+| `memory` | Memory system config | ❌ |
+| `research` | Research settings | ❌ |
+| `scoring` | Scoreboard config | ❌ |
+| `extensions` | Hooks và plugins | ❌ |
+
+## Full Config Reference
+
+```json
+{
+  "niche": {
+    "name": "string — Tên lĩnh vực",
+    "keywords": ["primary", "secondary", "terms"],
+    "language": "vi | en | both",
+    "competitors": ["url1", "url2"]
+  },
+  "brand": {
+    "name": "string — Tên thương hiệu",
+    "tone": "professional | casual | expert | friendly",
+    "target_audience": "string — Mô tả đối tượng",
+    "voice_guidelines": "string — Hướng dẫn giọng viết"
+  },
+  "content": {
+    "article_types": ["blog", "guide", "faq", "listicle", "case-study"],
+    "word_count": { "min": 800, "max": 2500 },
+    "batch_size": 5,
+    "schedule": "daily | weekly | manual"
+  },
+  "memory": {
+    "enabled": true,
+    "semantic_path": "memory/semantic/",
+    "episodic_path": "memory/episodic/",
+    "working_path": "memory/working/",
+    "max_episodic_entries": 100
+  },
+  "scoring": {
+    "enabled": true,
+    "rewards": {
+      "user_praise": 10,
+      "audit_pass": 3,
+      "engagement": 5
+    },
+    "penalties": {
+      "user_edit": -5,
+      "user_delete": -10,
+      "audit_fail": -3
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Mô tả | Default |
+|----------|-------|---------|
+| `CF_CONFIG_PATH` | Đường dẫn config file | `./content-factory.config.json` |
+| `CF_MEMORY_ENABLED` | Bật/tắt memory system | `true` |
+| `CF_DRY_RUN` | Chạy không ghi output | `false` |
+
+## Liên quan
+
+- [Giới thiệu](./intro) — Content Factory là gì
+- [Content Pipeline SOP](../sop/content-pipeline) — Hướng dẫn sử dụng

package/skills/cm-content-factory/sites/docs-site/src/content/docs/getting-started/installation.md

@@ -0,0 +1,80 @@
+---
+title: "Cài đặt"
+description: "Hướng dẫn cài đặt Content Factory — setup nhanh trong 5 phút với config file và scripts."
+keywords: ["cài đặt", "installation", "content factory", "setup"]
+sidebar:
+  order: 2
+---
+
+# Cài đặt
+
+Setup Content Factory trong 5 phút.
+
+## Yêu cầu
+
+| Component | Version |
+|-----------|---------|
+| Python | 3.10+ |
+| Git | 2.x+ |
+| AI Provider | API key (OpenAI, Anthropic, hoặc local) |
+
+## Quick Start
+
+### 1. Clone skill vào project
+
+```bash
+# Copy skill vào .agents/skills/
+cp -r content-factory .agents/skills/content-factory
+```
+
+### 2. Tạo config file
+
+Tạo `content-factory.config.json` tại root project:
+
+```json
+{
+  "niche": {
+    "name": "Your Niche",
+    "keywords": ["keyword1", "keyword2"],
+    "language": "vi"
+  },
+  "brand": {
+    "name": "Your Brand",
+    "tone": "professional",
+    "target_audience": "description"
+  },
+  "content": {
+    "article_types": ["blog", "guide", "faq"],
+    "word_count": { "min": 800, "max": 2500 }
+  },
+  "sources": {
+    "paths": ["./docs/", "./knowledge/"],
+    "types": ["md", "txt", "pdf"]
+  },
+  "output": {
+    "path": "./content/",
+    "format": "markdown"
+  }
+}
+```
+
+### 3. Chạy Pipeline đầu tiên
+
+```bash
+# Extract knowledge
+python3 .agents/skills/content-factory/scripts/extract.py \
+  --config content-factory.config.json
+
+# Plan topics
+python3 .agents/skills/content-factory/scripts/plan.py \
+  --config content-factory.config.json
+
+# Write content
+python3 .agents/skills/content-factory/scripts/write.py \
+  --config content-factory.config.json --batch 1
+```
+
+## Bước tiếp theo
+
+- [Cấu hình chi tiết](./configuration) — Tất cả options trong config file
+- [Content Pipeline SOP](../sop/content-pipeline) — Hướng dẫn end-to-end