codymaster 4.1.0

package/commands/demo.md

@@ -0,0 +1,96 @@
+---
+description: Interactive onboarding tour — discover CodyMaster skills, workflows, and examples. Run this first to learn how to use the kit.
+argument-hint: "[vi|en|zh|ko|ru|hi]"
+---
+
+# 🧠 Welcome to CodyMaster
+
+You are now running the interactive onboarding demo. Guide the user through CodyMaster in their language.
+
+## Step 1 — Detect Language
+
+Check if the user passed a language argument via `$ARGUMENTS`. If so, use that language.
+Otherwise, greet in English and ask which language they prefer:
+- 🇬🇧 English
+- 🇻🇳 Tiếng Việt
+- 🇨🇳 中文
+- 🇰🇷 한국어
+- 🇷🇺 Русский
+- 🇮🇳 हिन्दी
+
+Remember the chosen language and respond in it for all following steps.
+
+## Step 2 — Welcome Message
+
+Show a warm, concise welcome. Include:
+- What CodyMaster is (1 sentence)
+- That it gives AI agents 34+ specialized skills
+- That this demo will take ~2 minutes
+
+## Step 3 — Show the Workflow
+
+Explain the main workflow with a visual diagram:
+
+```
+💡 Idea
+  ↓  /cm:plan     (brainstorm + architecture + approval)
+📋 Plan
+  ↓  /cm:build    (TDD: red → green → refactor)
+⚙️  Code
+  ↓  /cm:review   (code review + quality gate)
+✅ Verified
+  ↓  /cm:deploy   (multi-gate deploy + rollback)
+🚀 Live
+```
+
+## Step 4 — Slash Commands Tour
+
+Present each command with a concrete example. Format as a table:
+
+| Command | What it does | Example |
+|---------|-------------|---------|
+| `/cm:plan` | Brainstorm + architecture + plan | `/cm:plan Add OAuth login` |
+| `/cm:build` | TDD implementation | `/cm:build Execute the auth plan` |
+| `/cm:debug` | 4-phase root cause analysis | `/cm:debug Login fails after redirect` |
+| `/cm:review` | Code review + quality check | `/cm:review` |
+| `/cm:deploy` | Safe multi-gate deployment | `/cm:deploy to staging` |
+| `/cm:ux` | UX design + prototyping | `/cm:ux Design the onboarding flow` |
+| `/cm:content` | AI content factory | `/cm:content Write a product launch post` |
+| `/cm:track` | Task + progress tracking | `/cm:track` |
+| `/cm:continuity` | Session memory | `/cm:continuity` |
+| `/cm:bootstrap` | New project setup | `/cm:bootstrap my-saas-app` |
+
+## Step 5 — Agent Skills (Automatic)
+
+Explain that besides slash commands, Claude also uses **agent skills automatically**:
+
+> These activate without any command — just describe what you want:
+>
+> - *"write tests first"* → `cm-tdd` activates
+> - *"there's a bug in..."* → `cm-debugging` activates
+> - *"plan this feature"* → `cm-planning` activates
+> - *"deploy to production"* → `cm-safe-deploy` activates
+> - *"review this code"* → `cm-quality-gate` activates
+
+## Step 6 — Quick Start Challenge
+
+Ask the user to try ONE of these right now and offer to help:
+
+**Option A — Build something new:**
+> "What would you like to build? I'll start with `/cm:plan` to design it."
+
+**Option B — Fix a bug:**
+> "Paste your error message and I'll apply `/cm:debug` to find the root cause."
+
+**Option C — Explore skills:**
+> "Ask me `what skills do you have?` and I'll show the full catalog with `cm-skill-index`."
+
+## Step 7 — Useful Resources
+
+Show at the end:
+- 📚 Docs: https://cody.todyle.com/docs
+- 🔄 Update: `claude plugin update cm@codymaster`
+- 💬 All skills: `/cm:skills`
+- 🔁 Restart tour: `/cm:demo`
+
+Close with an encouraging call-to-action in the user's chosen language.

package/commands/deploy.md

@@ -0,0 +1,51 @@
+---
+description: Deploy safely with multi-gate pipeline — test → build → stage → verify → production
+argument-hint: "[staging|production]"
+---
+
+# /deploy — Safe Deployment Pipeline
+
+Multi-gate deploy: run tests → verify build → deploy to staging → verify → optionally promote to production.
+
+## Invocation
+
+```
+/deploy staging
+/deploy production
+```
+
+## Workflow
+
+### Step 1: Pre-Flight Checks
+
+Apply **cm-test-gate** skill:
+- Run `npm run test:gate`
+- Verify all tests pass
+- Check build output
+
+### Step 2: Identity Guard
+
+Apply **cm-identity-guard** skill:
+- Verify git config matches `.project-identity.json`
+- Confirm Cloudflare account is correct
+- Prevent wrong-account deploys
+
+### Step 3: Deploy
+
+Apply **cm-safe-deploy** skill:
+- Deploy to staging first (always)
+- Verify staging deployment
+- Only promote to production if explicitly requested
+- Rollback strategy ready
+
+### Step 4: Post-Deploy
+
+- Run smoke tests on deployed URL
+- Verify critical paths work
+- Update CONTINUITY.md with deploy status
+
+## Notes
+
+- Production deploys always require explicit user confirmation
+- Staging is mandatory — no direct-to-production
+- Use `cm-secret-shield` scan before any deploy

package/commands/plan.md

@@ -0,0 +1,42 @@
+---
+description: Plan and design a feature before writing code — brainstorm intent, requirements, and architecture
+argument-hint: "<feature idea or problem statement>"
+---
+
+# /plan — Feature Planning
+
+Structured planning workflow: understand intent → explore alternatives → create implementation plan → get approval before coding.
+
+## Invocation
+
+```
+/plan Add user authentication with OAuth
+/plan Redesign the dashboard for mobile-first
+```
+
+## Workflow
+
+### Step 1: Brainstorm
+
+Apply the **cm-brainstorm-idea** skill:
+- Multi-dimensional evaluation (tech, product, design, business)
+- Design Thinking + 9 Windows (TRIZ) + Double Diamond
+- Output 2-3 qualified options with recommendations
+
+### Step 2: Create Plan
+
+Apply the **cm-planning** skill:
+- Explore intent and requirements
+- Design architecture and data models
+- Create implementation plan with exact files and changes
+- Break into bite-sized tasks (2-5 minutes each)
+
+### Step 3: Review
+
+Present the plan to the user for approval. Wait for sign-off before proceeding.
+
+### Step 4: Suggest Next
+
+- "Plan approved? → `/build`"
+- "Need UI mockup? → `/ux`"
+- "Want to set up git worktree? → Use **cm-git-worktrees**"

package/commands/review.md

@@ -0,0 +1,55 @@
+---
+description: Professional code review — pre-review checklist, severity classification, and PR feedback handling
+argument-hint: "[file or branch to review]"
+---
+
+# /review — Code Review Lifecycle
+
+Complete code review workflow: self-review checklist → external review → handle feedback → iterate.
+
+## Invocation
+
+```
+/review
+/review src/auth/login.ts
+```
+
+## Workflow
+
+### Step 1: Self-Review
+
+Apply **cm-code-review** skill:
+- Review against the original plan
+- Check for common issues (naming, error handling, edge cases)
+- Verify test coverage for changes
+- Check for security vulnerabilities
+
+### Step 2: Quality Check
+
+Apply **cm-quality-gate** skill:
+- 6-gate verification
+- Report issues by severity: Critical → High → Medium → Low
+- Critical issues block progress
+
+### Step 3: Create Review Summary
+
+```
+## Code Review Summary
+
+**Files changed**: [count]
+**Lines added/removed**: +X / -Y
+
+### Issues Found
+- 🔴 Critical: [count]
+- 🟠 High: [count]
+- 🟡 Medium: [count]
+- 🔵 Low: [count]
+
+### Verdict
+[APPROVE / REQUEST_CHANGES / NEEDS_DISCUSSION]
+```
+
+### Step 4: Suggest Next
+
+- "All clear? → `/deploy staging`"
+- "Need fixes? → Apply fixes, then `/review` again"

package/commands/track.md

@@ -0,0 +1,46 @@
+---
+description: Setup conversion tracking — Facebook/Meta Pixel, TikTok Events API, Google Ads, GTM
+argument-hint: "<website URL or tracking IDs>"
+---
+
+# /track — Ad Tracking Setup
+
+Complete tracking setup: Facebook/Meta Pixel + CAPI, TikTok Pixel + Events API, Google Ads Enhanced Conversions, GTM container.
+
+## Invocation
+
+```
+/track Setup tracking for my e-commerce site
+/track Add Facebook Pixel ID: 123456789
+```
+
+## Workflow
+
+### Step 1: Detect
+
+Apply **cm-ads-tracker** skill:
+- Auto-detect industry
+- Map correct standard events per platform specs
+- Identify required tracking IDs
+
+### Step 2: Generate
+
+Create complete tracking implementation:
+- GTM tags, triggers, variables
+- dataLayer schema
+- UTM conventions
+- CAPI/Events API server-side specs
+- First-touch/last-touch attribution
+- Cross-channel deduplication
+
+### Step 3: Implement
+
+- Install tracking code
+- Configure events
+- Test with platform debug tools
+
+### Step 4: Verify
+
+- Verify events fire correctly
+- Check for data integrity
+- Test attribution flows

package/commands/ux.md

@@ -0,0 +1,46 @@
+---
+description: AI-powered UX/UI design — apply 48 UX Laws, generate UI previews, and run design tests
+argument-hint: "<screen or feature to design>"
+---
+
+# /ux — UX/UI Design Intelligence
+
+Design with UX intelligence: apply 48 UX Laws, generate AI-powered UI previews, run 37 design tests.
+
+## Invocation
+
+```
+/ux Design a dashboard for analytics
+/ux Mobile-first onboarding flow
+```
+
+## Workflow
+
+### Step 1: UX Research
+
+Apply **cm-ux-master** skill:
+- Review relevant UX Laws (from 48 available)
+- Identify target user, key tasks, and flows
+- Apply Nielsen's Heuristics + Krug's principles
+
+### Step 2: UI Preview
+
+Apply **cm-ui-preview** skill:
+- Generate UI using Google Stitch MCP or Pencil MCP
+- Create production-ready UI previews
+- Iterate on design with user feedback
+
+### Step 3: Design Tests
+
+Run relevant design tests from the 37 available:
+- 5-second test
+- Squint test
+- Thumb zone test (mobile)
+- Accessibility check
+- Contrast ratio verification
+
+### Step 4: Suggest Next
+
+- "Design approved? → `/build` to implement"
+- "Need variations? → Generate design variants"
+- "Need content? → `/content`"

package/dist/agent-dispatch.js

@@ -0,0 +1,161 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateDispatch = validateDispatch;
+exports.dispatchTaskToAgent = dispatchTaskToAgent;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+// ─── Agent Display Names ────────────────────────────────────────────────────
+const AGENT_SKILL_PREFIX = {
+    'antigravity': '@[/',
+    'claude-code': '/',
+    'cursor': '@',
+    'gemini-cli': '@[/',
+    'windsurf': '@',
+    'cline': '@',
+    'copilot': '',
+};
+const AGENT_DISPLAY = {
+    'antigravity': 'Google Antigravity',
+    'claude-code': 'Claude Code',
+    'cursor': 'Cursor',
+    'gemini-cli': 'Gemini CLI',
+    'windsurf': 'Windsurf',
+    'cline': 'Cline / RooCode',
+    'copilot': 'GitHub Copilot',
+    'manual': 'Manual',
+};
+// ─── Validation ─────────────────────────────────────────────────────────────
+function validateDispatch(task, project, force = false) {
+    // 1. Agent is required
+    if (!task.agent) {
+        return { success: false, error: 'Agent is required for dispatch. Assign an agent first.', errorCode: 'NO_AGENT' };
+    }
+    // 2. Cannot dispatch manual tasks
+    if (task.agent === 'manual') {
+        return { success: false, error: 'Cannot dispatch manual tasks to AI agent. Change agent to an AI agent.', errorCode: 'MANUAL_AGENT' };
+    }
+    // 3. Project must exist
+    if (!project) {
+        return { success: false, error: 'Project not found for this task.', errorCode: 'PROJECT_NOT_FOUND' };
+    }
+    // 4. Project path is required
+    if (!project.path) {
+        return { success: false, error: 'Project workspace path is required. Edit the project to set a path.', errorCode: 'NO_PROJECT_PATH' };
+    }
+    // 5. Project path must exist on disk
+    if (!fs_1.default.existsSync(project.path)) {
+        return { success: false, error: `Project path does not exist: ${project.path}`, errorCode: 'PATH_NOT_FOUND' };
+    }
+    // 6. Already dispatched (unless force)
+    if (task.dispatchStatus === 'dispatched' && task.dispatchedAt && !force) {
+        return { success: false, error: `Task already dispatched at ${task.dispatchedAt}. Use force=true to re-dispatch.`, errorCode: 'ALREADY_DISPATCHED' };
+    }
+    return null; // All validations passed
+}
+// ─── Task File Generation ───────────────────────────────────────────────────
+function generateTaskFileContent(task, project, dashboardPort = 6969) {
+    const agentName = AGENT_DISPLAY[task.agent] || task.agent;
+    const skillPrefix = AGENT_SKILL_PREFIX[task.agent] || '';
+    const skillSuffix = task.agent === 'antigravity' || task.agent === 'gemini-cli' ? ']' : '';
+    const skillRef = task.skill ? `${skillPrefix}${task.skill}${skillSuffix}` : 'None';
+    const now = new Date().toISOString();
+    const priorityEmoji = {
+        'low': '🟢', 'medium': '🟡', 'high': '🟠', 'urgent': '🔴',
+    };
+    let content = `# Task: ${task.title}
+
+| Field | Value |
+|-------|-------|
+| Agent | ${agentName} |
+| Skill | ${skillRef} |
+| Priority | ${priorityEmoji[task.priority] || '🟡'} ${task.priority} |
+| Project | ${project.name} |
+| Created | ${task.createdAt} |
+| Dispatched | ${now} |
+| Task ID | ${task.id} |
+
+## Description
+
+${task.description || 'No additional description provided.'}
+
+## Instructions
+
+Execute this task in the project workspace at: \`${project.path}\`
+`;
+    if (task.skill) {
+        content += `
+Use the skill \`${task.skill}\` to guide execution. Invoke it with: ${skillRef}
+`;
+    }
+    content += `
+## Progress Reporting
+
+After completing the task, update the status via CodyMaster API:
+
+\`\`\`bash
+# Mark as in-progress
+curl -s -X PUT http://localhost:${dashboardPort}/api/tasks/${task.id}/move \\
+  -H "Content-Type: application/json" \\
+  -d '{"column": "in-progress"}'
+
+# Mark as done when complete
+curl -s -X PUT http://localhost:${dashboardPort}/api/tasks/${task.id}/move \\
+  -H "Content-Type: application/json" \\
+  -d '{"column": "done"}'
+\`\`\`
+`;
+    return content;
+}
+// ─── Dispatcher ─────────────────────────────────────────────────────────────
+function dispatchTaskToAgent(task, project, force = false) {
+    // Validate
+    const validationError = validateDispatch(task, project, force);
+    if (validationError)
+        return validationError;
+    // Generate content
+    const content = generateTaskFileContent(task, project);
+    // Create .agent-tasks directory
+    const taskDir = path_1.default.join(project.path, '.agent-tasks');
+    try {
+        if (!fs_1.default.existsSync(taskDir)) {
+            fs_1.default.mkdirSync(taskDir, { recursive: true });
+        }
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: `Cannot create .agent-tasks directory at ${taskDir}: ${err.message}`,
+            errorCode: 'WRITE_ERROR',
+        };
+    }
+    // Write task file
+    const shortId = task.id.substring(0, 8);
+    const safeTitle = task.title.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '').substring(0, 40);
+    const fileName = `${shortId}-${safeTitle}.agent-task.md`;
+    const filePath = path_1.default.join(taskDir, fileName);
+    try {
+        fs_1.default.writeFileSync(filePath, content, 'utf-8');
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: `Cannot write task file at ${filePath}: ${err.message}`,
+            errorCode: 'WRITE_ERROR',
+        };
+    }
+    // Write/update .gitignore in .agent-tasks
+    const gitignorePath = path_1.default.join(taskDir, '.gitignore');
+    if (!fs_1.default.existsSync(gitignorePath)) {
+        try {
+            fs_1.default.writeFileSync(gitignorePath, '# Agent task files are transient — not tracked in git\n*\n!.gitignore\n', 'utf-8');
+        }
+        catch ( /* non-critical */_a) { /* non-critical */ }
+    }
+    // Generate CLI command
+    const relativePath = path_1.default.relative(project.path, filePath);
+    const cliCommand = `gemini run --task "${relativePath}"`;
+    return { success: true, filePath, prompt: content, cliCommand };
+}

package/dist/chains/builtin.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBuiltinChains = getBuiltinChains;
+exports.getChainById = getChainById;
+exports.getAllChainIds = getAllChainIds;
+// ─── Built-in Chain Definitions ─────────────────────────────────────────────
+// TRIZ #40 Composite Materials — skills compose into pipelines
+const BUILTIN_CHAINS = [
+    {
+        id: 'feature-development',
+        name: 'Feature Development',
+        description: 'Full pipeline: analyze → plan → test → build → verify → ship',
+        icon: '🚀',
+        steps: [
+            { skill: 'cm-brainstorm-idea', condition: 'if-complex', optional: true, description: 'Analyze problem & evaluate options (skip for simple features)' },
+            { skill: 'cm-planning', condition: 'always', description: 'Design implementation plan' },
+            { skill: 'cm-tdd', condition: 'always', description: 'Write tests first (Red-Green-Refactor)' },
+            { skill: 'cm-execution', condition: 'always', description: 'Execute the implementation plan' },
+            { skill: 'cm-quality-gate', condition: 'always', description: 'Run 6-gate verification' },
+            { skill: 'cm-safe-deploy', condition: 'if-ready', optional: true, description: 'Deploy to staging/production' },
+        ],
+        triggers: ['feature', 'build', 'create', 'implement', 'add', 'new feature', 'develop', 'tạo', 'xây dựng', 'thêm tính năng'],
+    },
+    {
+        id: 'bug-fix',
+        name: 'Bug Fix',
+        description: 'Investigate → fix with tests → verify quality',
+        icon: '🐛',
+        steps: [
+            { skill: 'cm-debugging', condition: 'always', description: 'Root cause investigation (5-phase)' },
+            { skill: 'cm-tdd', condition: 'always', description: 'Fix with regression test' },
+            { skill: 'cm-quality-gate', condition: 'always', description: 'Verify fix quality' },
+        ],
+        triggers: ['bug', 'fix', 'error', 'broken', 'crash', 'debug', 'sửa', 'lỗi', 'hỏng'],
+    },
+    {
+        id: 'content-launch',
+        name: 'Content Launch',
+        description: 'Generate content → setup tracking → optimize conversions',
+        icon: '📝',
+        steps: [
+            { skill: 'cm-content-factory', condition: 'always', description: 'Research & generate content' },
+            { skill: 'cm-ads-tracker', condition: 'if-ready', optional: true, description: 'Setup conversion tracking' },
+            { skill: 'cro-methodology', condition: 'if-ready', optional: true, description: 'CRO audit & optimization' },
+        ],
+        triggers: ['content', 'blog', 'article', 'marketing', 'launch', 'campaign', 'nội dung', 'bài viết', 'chiến dịch'],
+    },
+    {
+        id: 'new-project',
+        name: 'New Project Setup',
+        description: 'Bootstrap → plan → implement → verify → deploy',
+        icon: '🏗️',
+        steps: [
+            { skill: 'cm-project-bootstrap', condition: 'always', description: 'Full project setup with design system & CI' },
+            { skill: 'cm-planning', condition: 'always', description: 'Plan initial features' },
+            { skill: 'cm-tdd', condition: 'always', description: 'Setup test infrastructure' },
+            { skill: 'cm-execution', condition: 'always', description: 'Build initial features' },
+            { skill: 'cm-quality-gate', condition: 'always', description: 'Quality verification' },
+            { skill: 'cm-safe-deploy', condition: 'if-ready', optional: true, description: 'Initial deployment' },
+        ],
+        triggers: ['new project', 'init', 'bootstrap', 'setup', 'scaffold', 'start from scratch', 'dự án mới', 'khởi tạo'],
+    },
+    {
+        id: 'code-review',
+        name: 'Code Review & Ship',
+        description: 'Review code → verify quality → deploy',
+        icon: '🔍',
+        steps: [
+            { skill: 'cm-code-review', condition: 'always', description: 'Professional PR review' },
+            { skill: 'cm-quality-gate', condition: 'always', description: '6-gate verification' },
+            { skill: 'cm-safe-deploy', condition: 'if-ready', optional: true, description: 'Ship to production' },
+        ],
+        triggers: ['review', 'PR', 'pull request', 'merge', 'ship', 'release', 'kiểm tra', 'duyệt code'],
+    },
+];
+// ─── Exports ────────────────────────────────────────────────────────────────
+function getBuiltinChains() {
+    return BUILTIN_CHAINS;
+}
+function getChainById(id) {
+    return BUILTIN_CHAINS.find(c => c.id === id);
+}
+function getAllChainIds() {
+    return BUILTIN_CHAINS.map(c => c.id);
+}