codymaster 4.1.0

package/skills/cm-dockit/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "cm-dockit",
+  "version": "2.1.0",
+  "description": "DocKit Master Skill test suite",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "test": "vitest run",
+    "test:gate": "vitest run --passWithNoTests"
+  },
+  "devDependencies": {
+    "vitest": "^1.5.0"
+  }
+}

package/skills/cm-dockit/prompts/analysis.md

@@ -0,0 +1,34 @@
+# Codebase Analysis Prompt
+
+You are DocKit Master, a documentation generator. Analyze the codebase at: {{PROJECT_PATH}}
+
+## Task
+
+Perform a comprehensive codebase analysis and write the result as a Markdown file.
+
+## Instructions
+
+1. **Scan the project structure** — list all directories, key files, their sizes
+2. **Identify tech stack** — framework, language, database, deployment target
+3. **Map all routes/endpoints** — method, path, description
+4. **Document database schema** — tables, columns, relationships
+5. **List dependencies** — from package.json/requirements.txt/etc
+6. **Identify test coverage** — test files, framework
+7. **Map key business logic** — core modules and their purpose
+
+## Output Format
+
+Write a complete Markdown file with:
+- YAML frontmatter (title, description, keywords, robots)
+- Quick Reference box at the top
+- Mermaid diagram for architecture overview
+- Tables for routes, dependencies, database
+- Cross-links to other docs at the bottom
+
+## Language
+
+Write in: {{LANGUAGE}} (vi = Vietnamese, en = English)
+
+## Output File
+
+Save to: {{OUTPUT_PATH}}

package/skills/cm-dockit/prompts/api-reference.md

@@ -0,0 +1,24 @@
+# API Reference Prompt
+
+You are DocKit Master. Create API reference documentation for: {{PROJECT_PATH}}
+
+## Task
+
+Document all REST API endpoints with examples.
+
+## Instructions
+
+1. **Auth section** — all authentication methods with examples
+2. **Error codes** — HTTP status table
+3. **Endpoints by group** — tables with method, path, auth, description
+4. **Detailed examples** — in collapsible details tags:
+   - Request (method, headers, body)
+   - Response (status, body)
+5. **Configuration endpoints** — list all config CRUD
+6. **Report endpoints** — list all analytics/report
+7. **Export endpoints** — list CSV exports
+
+## Output
+
+Write to: {{OUTPUT_PATH}} in {{LANGUAGE}}.
+Include YAML frontmatter, code blocks for examples.

package/skills/cm-dockit/prompts/architecture.md

@@ -0,0 +1,21 @@
+# Architecture Documentation Prompt
+
+You are DocKit Master. Create system architecture docs for: {{PROJECT_PATH}}
+
+## Task
+
+Document the complete system architecture including components, deployment, security, and ADRs.
+
+## Instructions
+
+1. **Architecture diagram** — Mermaid graph showing all components
+2. **Component table** — name, description, technology, key files
+3. **Sequence diagram** — main request flow
+4. **ADR section** — Architecture Decision Records (with details tags)
+5. **Security section** — auth methods, RBAC roles
+6. **Performance section** — strategies and limits
+
+## Output
+
+Write to: {{OUTPUT_PATH}} in {{LANGUAGE}}.
+Include YAML frontmatter, dark-mode Mermaid, cross-links.

package/skills/cm-dockit/prompts/data-flow.md

@@ -0,0 +1,20 @@
+# Data Flow Prompt
+
+You are DocKit Master. Create data flow documentation for: {{PROJECT_PATH}}
+
+## Task
+
+Document end-to-end data flows for all major features.
+
+## Instructions
+
+1. **Overview diagram** — input → process → output
+2. **Sequence diagram** for each major workflow
+3. **Formulas** — document any calculations with tables
+4. **Integration table** — external services, protocol, direction, data
+5. **Export flows** — CSV generation details
+
+## Output
+
+Write to: {{OUTPUT_PATH}} in {{LANGUAGE}}.
+Include YAML frontmatter, Mermaid sequence/flow diagrams, cross-links.

package/skills/cm-dockit/prompts/database.md

@@ -0,0 +1,21 @@
+# Database Schema Prompt
+
+You are DocKit Master. Create database schema documentation for: {{PROJECT_PATH}}
+
+## Task
+
+Document the complete database schema from migrations and SQL files.
+
+## Instructions
+
+1. **ER diagram** — Mermaid erDiagram with all relationships
+2. **Table definitions** — columns, types, nullable, defaults, descriptions
+3. **Grouped by domain** — organization, config, data, workflow
+4. **Indexes** — table of all indexes and their purpose
+5. **Migration history** — version, description
+6. **Status flows** — for tables with status columns
+
+## Output
+
+Write to: {{OUTPUT_PATH}} in {{LANGUAGE}}.
+Include YAML frontmatter, cross-links.

package/skills/cm-dockit/prompts/deployment.md

@@ -0,0 +1,22 @@
+# Deployment Guide Prompt
+
+You are DocKit Master. Create deployment documentation for: {{PROJECT_PATH}}
+
+## Task
+
+Document how to install, configure, and deploy the system.
+
+## Instructions
+
+1. **Requirements** — Node.js version, tools, etc.
+2. **Environment variables** — table with name, description, required, example
+3. **Local setup** — step-by-step with code blocks
+4. **Production deployment** — platform-specific instructions
+5. **Demo accounts** — test credentials table
+6. **Health checks** — monitoring endpoints
+7. **Testing** — how to run tests
+
+## Output
+
+Write to: {{OUTPUT_PATH}} in {{LANGUAGE}}.
+Include YAML frontmatter, Mermaid diagram for deploy flow.

package/skills/cm-dockit/prompts/flows.md

@@ -0,0 +1,21 @@
+# Process Flows Prompt
+
+You are DocKit Master. Create process flow diagrams for: {{PROJECT_PATH}}
+
+## Task
+
+Document all major workflows and state machines in the system.
+
+## Instructions
+
+1. Identify all status flows (state machines) from database schema
+2. Create Mermaid flowcharts for sequential processes
+3. Create Mermaid stateDiagram for status transitions
+4. Create sequence diagrams for complex multi-actor interactions
+5. Use dark-mode colors (fill: #2d333b, border: #6d5dfc)
+6. Add plain text description below each diagram
+
+## Output
+
+Write to: {{OUTPUT_PATH}} in {{LANGUAGE}}.
+Include YAML frontmatter, cross-links.

package/skills/cm-dockit/prompts/jtbd.md

@@ -0,0 +1,20 @@
+# JTBD Canvases Prompt
+
+You are DocKit Master. Create Jobs-to-be-Done analysis for: {{PROJECT_PATH}}
+
+## Task
+
+Analyze each user persona's jobs using the JTBD framework.
+
+## Instructions
+
+1. For each persona, identify 3-5 jobs
+2. Format as: "When [situation], I want to [action], so I can [outcome]"
+3. Map each job to specific system features
+4. Include frequency and importance
+5. Use table format
+
+## Output
+
+Write to: {{OUTPUT_PATH}} in {{LANGUAGE}}.
+Include YAML frontmatter, cross-links to Personas and Flows.

package/skills/cm-dockit/prompts/personas.md

@@ -0,0 +1,24 @@
+# Personas Prompt
+
+You are DocKit Master, a documentation generator. Create user personas for the project at: {{PROJECT_PATH}}
+
+## Task
+
+Generate detailed user personas based on the codebase analysis (RBAC roles, UI flows, API patterns).
+
+## Instructions
+
+1. **Identify roles** from auth middleware, RBAC config, user tables
+2. **For each persona** create:
+   - Name, age, role, frequency of use
+   - Goals and pain points
+   - Key behaviors (what they do in the system)
+   - Most-used features
+3. **Use table format** for structured persona attributes
+4. **Include persona photo description** (for future image generation)
+
+## Output
+
+Write complete Markdown file to: {{OUTPUT_PATH}}
+Language: {{LANGUAGE}}
+Include YAML frontmatter, Quick Reference box, cross-links.

package/skills/cm-dockit/prompts/sop-modules.md

@@ -0,0 +1,40 @@
+# SOP Template Prompt
+
+You are DocKit Master. Create SOP user guides for: {{PROJECT_PATH}}
+
+## Task
+
+Generate a complete set of SOP (Standard Operating Procedure) documents.
+
+## Instructions
+
+1. **SOP Index** — overview of all features with difficulty, role, link
+2. **One SOP per feature/module** including:
+   - Quick Reference box (who, where, time, prerequisites)
+   - Prerequisites checklist
+   - Step-by-step guide with screenshots descriptions
+   - Tables for form fields, filter options
+   - Expected results section
+   - Troubleshooting (in details/collapsible tags)
+   - Related features cross-links
+3. **Use admonitions** — :::tip, :::warning for callouts
+4. **Map to API endpoints** at the bottom
+
+## Modules to Cover
+
+Discover modules from the codebase analysis. Typical modules:
+- Employee management
+- Scoring/rating
+- Violations
+- Recovery/training
+- Bonuses/rewards
+- Benefits calculation
+- Reports/dashboard
+- Configuration/settings
+- Approvals
+- Exports
+
+## Output
+
+Write index to: {{OUTPUT_PATH}} and individual SOPs to the same directory.
+Language: {{LANGUAGE}}.

package/skills/cm-dockit/scripts/doc-gen.sh

@@ -0,0 +1,121 @@
+#!/bin/bash
+# ============================================================
+# Doc-Kit — Documentation Generator CLI
+# Generates optimized prompts for Google Antigravity
+# ============================================================
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+YELLOW='\033[1;33m'
+BOLD='\033[1m'
+NC='\033[0m' # No Color
+
+# Header
+echo ""
+echo -e "${CYAN}╔══════════════════════════════════════════════╗${NC}"
+echo -e "${CYAN}║${NC}  ${BOLD}📚 Doc-Kit — Documentation Generator${NC}        ${CYAN}║${NC}"
+echo -e "${CYAN}║${NC}  ${YELLOW}Powered by Google Antigravity${NC}               ${CYAN}║${NC}"
+echo -e "${CYAN}╚══════════════════════════════════════════════╝${NC}"
+echo ""
+
+# Step 1: Choose document type
+echo -e "${BOLD}📑 Step 1: Document Type${NC}"
+echo ""
+echo -e "  ${GREEN}1)${NC} tech       — Technical docs (Architecture, DB, Deployment)"
+echo -e "  ${GREEN}2)${NC} sop        — SOP User Guides (step-by-step)"
+echo -e "  ${GREEN}3)${NC} api        — API Reference (endpoints, schemas)"
+echo -e "  ${GREEN}4)${NC} all        — Full documentation suite"
+echo ""
+read -p "$(echo -e ${BLUE}Select [1-4]:${NC} )" DOC_CHOICE
+
+case $DOC_CHOICE in
+  1) DOC_TYPE="tech" ;;
+  2) DOC_TYPE="sop" ;;
+  3) DOC_TYPE="api" ;;
+  4) DOC_TYPE="all" ;;
+  *) echo -e "${RED}❌ Invalid choice${NC}"; exit 1 ;;
+esac
+
+echo ""
+
+# Step 2: Choose output format
+echo -e "${BOLD}🎨 Step 2: Output Format${NC}"
+echo ""
+echo -e "  ${GREEN}1)${NC} markdown   — Plain Markdown (simple, portable)"
+echo -e "  ${GREEN}2)${NC} docusaurus — Docusaurus site (beautiful, searchable)"
+echo ""
+read -p "$(echo -e ${BLUE}Select [1-2]:${NC} )" FORMAT_CHOICE
+
+case $FORMAT_CHOICE in
+  1) FORMAT="markdown" ;;
+  2) FORMAT="docusaurus" ;;
+  *) echo -e "${RED}❌ Invalid choice${NC}"; exit 1 ;;
+esac
+
+echo ""
+
+# Step 3: Source code path
+echo -e "${BOLD}📂 Step 3: Source Code Path${NC}"
+echo ""
+read -p "$(echo -e ${BLUE}Path to project root:${NC} )" SOURCE_PATH
+
+# Validate path
+if [ ! -d "$SOURCE_PATH" ]; then
+  echo -e "${RED}❌ Directory not found: $SOURCE_PATH${NC}"
+  exit 1
+fi
+
+# Convert to absolute path
+SOURCE_PATH=$(cd "$SOURCE_PATH" && pwd)
+
+echo ""
+
+# Step 4: Documentation language
+echo -e "${BOLD}🌏 Step 4: Output Language${NC}"
+echo ""
+echo -e "  ${GREEN}1)${NC} en — English (default)"
+echo -e "  ${GREEN}2)${NC} vi — Tiếng Việt"
+echo ""
+read -p "$(echo -e ${BLUE}Select [1-2] (Enter = English):${NC} )" LANG_CHOICE
+
+case $LANG_CHOICE in
+  2) DOC_LANG="Vietnamese" ;;
+  *) DOC_LANG="English" ;;
+esac
+
+echo ""
+echo -e "${CYAN}══════════════════════════════════════════════${NC}"
+echo ""
+
+# Generate prompt
+PROMPT="Use the doc-kit skill to generate documentation for the project at: $SOURCE_PATH
+
+Configuration:
+- Document type: $DOC_TYPE
+- Output format: $FORMAT
+- Language: $DOC_LANG
+
+Please refer to the skill file at skills/doc-kit/SKILL.md and execute the procedure.
+Start from Step 2 (Analyze Codebase) since input parameters are already provided above."
+
+echo -e "${BOLD}✅ Prompt successfully generated!${NC}"
+echo ""
+echo -e "${YELLOW}━━━ Copy the prompt below and paste it into Antigravity ━━━${NC}"
+echo ""
+echo -e "${GREEN}$PROMPT${NC}"
+echo ""
+echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo ""
+
+# Copy to clipboard if pbcopy available (macOS)
+if command -v pbcopy &> /dev/null; then
+  echo "$PROMPT" | pbcopy
+  echo -e "${GREEN}📋 Copied to clipboard! Paste (Cmd+V) into Antigravity.${NC}"
+fi
+
+echo ""

package/skills/cm-dockit/scripts/dockit-dashboard.sh

@@ -0,0 +1,142 @@
+#!/bin/bash
+# ============================================================
+# DocKit Master v2 — Progress Dashboard
+# Real-time terminal dashboard for monitoring doc generation
+# ============================================================
+set -euo pipefail
+
+# ── Colors ──────────────────────────────────────────────────
+RED='\033[0;31m'; GREEN='\033[0;32m'; BLUE='\033[0;34m'
+CYAN='\033[0;36m'; YELLOW='\033[1;33m'; MAGENTA='\033[0;35m'
+BOLD='\033[1m'; DIM='\033[2m'; NC='\033[0m'
+BG_GREEN='\033[42m'; BG_RED='\033[41m'; BG_YELLOW='\033[43m'
+BG_BLUE='\033[44m'; BG_DIM='\033[100m'
+
+# ── Args ────────────────────────────────────────────────────
+PROJECT_PATH="${1:-}"
+REFRESH="${2:-5}"  # Refresh interval in seconds
+
+if [[ -z "$PROJECT_PATH" ]]; then
+  echo "Usage: dockit-dashboard.sh /path/to/project [refresh_seconds]"
+  echo ""
+  echo "  Monitors DocKit Master progress in real-time."
+  echo "  Default refresh: 5 seconds. Press Ctrl+C to stop."
+  exit 1
+fi
+
+PROJECT_PATH="$(cd "$PROJECT_PATH" 2>/dev/null && pwd)" || {
+  echo "Directory not found: $PROJECT_PATH"
+  exit 1
+}
+
+PROGRESS_FILE="$PROJECT_PATH/docs/_progress.json"
+
+# ── Render Dashboard ────────────────────────────────────────
+render() {
+  clear
+  
+  if [[ ! -f "$PROGRESS_FILE" ]]; then
+    echo -e "${YELLOW}⏳ Waiting for DocKit Master to start...${NC}"
+    echo -e "${DIM}Looking for: $PROGRESS_FILE${NC}"
+    return
+  fi
+
+  python3 << 'PYEOF'
+import json, sys, os
+from datetime import datetime, timezone
+
+progress_file = os.environ.get("PROGRESS_FILE", "")
+try:
+    with open(progress_file, 'r') as f:
+        data = json.load(f)
+except Exception as e:
+    print(f"\033[1;33m⏳ Waiting for valid progress data...\033[0m")
+    sys.exit(0)
+
+# Colors
+C = '\033[0;36m'; G = '\033[0;32m'; R = '\033[0;31m'; Y = '\033[1;33m'
+B = '\033[1m'; D = '\033[2m'; N = '\033[0m'; M = '\033[0;35m'
+BG_G = '\033[42m'; BG_R = '\033[41m'; BG_Y = '\033[43m'; BG_B = '\033[44m'; BG_D = '\033[100m'
+
+config = data.get('config', {})
+stats = data.get('stats', {})
+tasks = data.get('tasks', [])
+total = stats.get('total', 0)
+done = stats.get('done', 0)
+running = stats.get('running', 0)
+failed = stats.get('failed', 0)
+pending = stats.get('pending', 0)
+
+# Header
+print(f"\n{C}╔══════════════════════════════════════════════════════╗{N}")
+print(f"{C}║{N}  {B}📊 DocKit Master v2 — Dashboard{N}                     {C}║{N}")
+print(f"{C}╚══════════════════════════════════════════════════════╝{N}")
+
+# Config
+print(f"\n  {D}Project:{N}  {B}{data.get('project', '?')}{N}")
+print(f"  {D}Type:{N}     {config.get('type', '?')}   {D}Format:{N} {config.get('format', '?')}   {D}Lang:{N} {config.get('language', '?')}")
+print(f"  {D}Engine:{N}   {config.get('engine', '?')}   {D}Jobs:{N} {config.get('max_jobs', '?')}")
+
+# Progress bar
+pct = int(done / total * 100) if total > 0 else 0
+bar_width = 40
+filled = int(bar_width * done / total) if total > 0 else 0
+bar = '█' * filled + '░' * (bar_width - filled)
+color = G if pct == 100 else (Y if pct > 50 else C)
+print(f"\n  {color}{bar}{N}  {B}{pct}%{N}  ({done}/{total})")
+
+# Stats cards
+print(f"\n  {BG_G} ✅ Done: {done} {N}  {BG_Y} ⏳ Running: {running} {N}  {BG_D} ⏸️ Pending: {pending} {N}  {BG_R} ❌ Failed: {failed} {N}")
+
+# Task table
+print(f"\n  {B}{'#':>3}  {'Status':^8}  {'Task':<32}  {'Time':>8}{N}")
+print(f"  {'─'*3}  {'─'*8}  {'─'*32}  {'─'*8}")
+
+for i, t in enumerate(tasks):
+    status = t.get('status', 'pending')
+    icon = {'done': f'{G}✅ Done{N}', 'running': f'{Y}⏳ Run {N}', 'pending': f'{D}⏸️ Wait{N}', 'failed': f'{R}❌ Fail{N}'}.get(status, '❓')
+    label = t.get('label', t.get('id', '?'))[:32]
+    
+    # Calculate duration
+    dur = ''
+    if t.get('started_at'):
+        try:
+            start = datetime.fromisoformat(t['started_at'].replace('Z', '+00:00'))
+            if t.get('completed_at'):
+                end = datetime.fromisoformat(t['completed_at'].replace('Z', '+00:00'))
+            else:
+                end = datetime.now(timezone.utc)
+            secs = int((end - start).total_seconds())
+            if secs < 60:
+                dur = f'{secs}s'
+            else:
+                dur = f'{secs//60}m{secs%60}s'
+        except:
+            dur = ''
+    
+    print(f"  {i+1:>3}  {icon}  {label:<32}  {D}{dur:>8}{N}")
+
+# Errors
+failed_tasks = [t for t in tasks if t.get('error')]
+if failed_tasks:
+    print(f"\n  {R}{B}Errors:{N}")
+    for t in failed_tasks:
+        print(f"    {R}• {t['label']}: {t['error']}{N}")
+
+# Footer
+print(f"\n  {D}Last updated: {datetime.now().strftime('%H:%M:%S')}   Refresh: {os.environ.get('REFRESH', '5')}s   Ctrl+C to stop{N}")
+if pct == 100:
+    print(f"\n  {G}{B}🎉 All tasks completed! Run --audit to review and finalize.{N}")
+print()
+PYEOF
+}
+
+# ── Main Loop ───────────────────────────────────────────────
+export PROGRESS_FILE REFRESH
+
+trap 'echo -e "\n${DIM}Dashboard closed.${NC}"; exit 0' INT
+
+while true; do
+  render
+  sleep "$REFRESH"
+done