codymaster 4.8.0 → 7.0.0

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

@@ -1,90 +0,0 @@
----
-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

@@ -1,54 +0,0 @@
----
-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

@@ -1,38 +0,0 @@
----
-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

@@ -1,65 +0,0 @@
----
-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

@@ -1,48 +0,0 @@
----
-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

@@ -1,39 +0,0 @@
----
-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

@@ -1,42 +0,0 @@
----
-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

@@ -1,51 +0,0 @@
----
-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

@@ -1,52 +0,0 @@
----
-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

@@ -1,86 +0,0 @@
----
-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

@@ -1,80 +0,0 @@
----
-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