@heyai-rules/pilo-masterkit 1.2.2 → 3.1.0

package/src/lib/installer.js

@@ -1,140 +1,386 @@
 const fs = require('fs-extra');
 const path = require('node:path');
+const { CORE_FILES, STACKS } = require('./manifests/stacks');
 
-async function install(config) {
-  const { targetDir, language, scale, productType, agentName } = config;
-
-  // 1. Copy .agent directory
-  const sourceAgentDir = path.join(__dirname, '..', '..', '.agent');
-  const targetAgentDir = path.join(targetDir, '.agent');
+/**
+ * Filter files based on manifest
+ */
+async function copyFilteredAgent(sourceDir, targetDir, stackPaths) {
+  const allPatterns = [...CORE_FILES, ...stackPaths];
+  await fs.ensureDir(targetDir);
   
-  if (await fs.pathExists(sourceAgentDir)) {
-    await fs.copy(sourceAgentDir, targetAgentDir, { overwrite: true });
-  }
+  const filterFunc = (src, dest) => {
+    const relPath = path.relative(sourceDir, src).replace(/\\/g, '/');
+    if (relPath === '') return true; // root
+    
+    return allPatterns.some(pattern => {
+      if (pattern.endsWith('/**')) {
+        const base = pattern.replace('/**', '');
+        return relPath === base || relPath.startsWith(base + '/');
+      }
+      return relPath === pattern || relPath.startsWith(pattern + '/');
+    });
+  };
 
-  // 2. Clean State - Remove existing 8 doc folders if they exist
+  await fs.copy(sourceDir, targetDir, { filter: filterFunc, overwrite: true });
+}
+
+/**
+ * Common doc folder setup
+ */
+async function setupDocs(targetDir, locale) {
   const docsDir = path.join(targetDir, 'docs');
-  const docFolders = ['lessons', 'reports', 'plans', 'status', 'tasks', 'logs', 'walkthroughs', 'producs'];
+  const docFolders = ['lessons', 'reports', 'plans', 'status', 'tasks', 'logs', 'walkthroughs', 'products'];
+  const isVi = (locale || 'vi') === 'vi';
+  const desc = isVi ? 'Thư mục theo chuẩn Pilo Masterkit.' : 'Standard Pilo Masterkit directory.';
 
   for (const folder of docFolders) {
     const folderPath = path.join(docsDir, folder);
-    
-    // Nếu thư mục đã tồn tại -> Xoá sạch để reset ngữ cảnh cũ
     if (await fs.pathExists(folderPath)) {
-      await fs.emptyDir(folderPath); // Xóa hết content bên trong nhưng giữ folder
+      await fs.emptyDir(folderPath);
     } else {
-      await fs.ensureDir(folderPath); // Nếu chưa có thì tạo mới
+      await fs.ensureDir(folderPath);
     }
     
-    // 3. Create fresh documentation files
     await fs.writeFile(
       path.join(folderPath, 'README.md'),
-      `# ${folder.toUpperCase()}\n\nThư mục theo chuẩn Pilo Masterkit. Dữ liệu từ các phiên làm việc cũ đã được dọn dẹp sạch sẽ.\n`
+      `# ${folder.toUpperCase()}\n\n${desc}\n`
     );
   }
+}
+
+/**
+ * Inject AI Host templates with interpolation & localization
+ */
+async function injectAIHost(targetDir, aiHost, config = {}) {
+  const templatesRoot = path.join(__dirname, '..', 'templates');
+  
+  const hostMap = {
+    claude: { src: 'claude', files: ['CLAUDE.md'] },
+    gemini: { src: 'gemini', files: ['GEMINI.md'] },
+    cursor: { src: 'cursor', files: ['pilo-masterkit.mdc'], targetSubDir: '.cursor/rules' },
+    github: { src: 'github', files: ['copilot-instructions.md'], targetSubDir: '.github' },
+    codex: { src: 'codex', files: ['AGENTS.md'] }
+  };
+
+  const hostConfig = hostMap[aiHost];
+  if (!hostConfig) return;
+
+  // Prepare variables
+  const name = config.agentName || "Pilo";
+  const locale = config.locale || 'vi';
+  const isVi = locale === 'vi';
+  
+  let trigger;
+  if (isVi) {
+    trigger = `Chào ${name}/Chào AI, Thức dậy đi ${name}/Thức dậy đi AI, Trỗi dậy đi ${name}/AI, Summon ${name}/AI`;
+  } else {
+    trigger = `Hey ${name}/Hey AI, Wakeup ${name}/Wakeup AI, Trỗi dậy đi ${name}/AI, Summon ${name}/AI`;
+  }
 
-  // 4. Generate GEMINI.md
-  // Using the template logic dictated by user choices
-  const langDisplay = language === 'vi' ? 'TIẾNG VIỆT' : 'ENGLISH';
-  let scaleDisplay = '';
-  switch(scale) {
-    case 'instant': scaleDisplay = 'INSTANT (MVP Nhanh gọn)'; break;
-    case 'creative': scaleDisplay = 'CREATIVE (Nghiên cứu Sandbox)'; break;
-    case 'enterprise': scaleDisplay = 'SME ENTERPRISE (Clean code ổn định)'; break;
+  const vars = {
+    agentName: name,
+    productType: config.type || (isVi ? "Dự án chung" : "General Project"),
+    scaleDisplay: config.scope || (isVi ? "Cá nhân" : "Personal Edition"),
+    langDisplay: isVi ? 'TIẾNG VIỆT' : 'ENGLISH',
+    triggerDisplay: trigger,
+    moduleList: [
+      "- rules/CORE_RULES.md",
+      "- rules/SECURITY_ARMOR.md",
+      "- rules/QUALITY_ASSURANCE.md",
+      "- rules/COMMUNICATION.md"
+    ].join('\n')
+  };
+
+  const sourceDir = path.join(templatesRoot, hostConfig.src);
+  for (const destFileName of hostConfig.files) {
+    let sourceFileName = destFileName;
+    if (destFileName.endsWith('.md')) {
+        const localizedSource = destFileName.replace('.md', '.' + locale + '.md');
+        if (await fs.pathExists(path.join(sourceDir, localizedSource))) {
+            sourceFileName = localizedSource;
+        }
+    }
+    
+    const srcFile = path.join(sourceDir, sourceFileName);
+    const destDir = hostConfig.targetSubDir ? path.join(targetDir, hostConfig.targetSubDir) : targetDir;
+    const destFile = path.join(destDir, destFileName);
+    
+    await fs.ensureDir(destDir);
+    if (await fs.pathExists(srcFile)) {
+      let content = await fs.readFile(srcFile, 'utf8');
+      
+      for (const [key, value] of Object.entries(vars)) {
+        const regex = new RegExp(`\\$\\{${key}\\}`, 'g');
+        content = content.replace(regex, value);
+      }
+      
+      await fs.writeFile(destFile, content);
+    }
   }
+}
+
+/**
+ * Generate PILO_WIKI.md - Bilingual custom slash commands wiki
+ */
+async function generateWiki(targetDir, config = {}) {
+  const locale = config.locale || 'vi';
+  const isVi = locale === 'vi';
+  const name = config.agentName || 'Pilo';
+  const stacks = Array.isArray(config.stack) ? config.stack : (config.stack ? [config.stack] : []);
+  const deploy = config.deploy || 'custom';
+
+  // Core commands (always present)
+  const coreCommands = {
+    vi: [
+      { cmd: '/plan', desc: 'Lập kế hoạch chi tiết, đánh giá rủi ro trước khi thực thi.' },
+      { cmd: '/debug', desc: 'Sửa lỗi có hệ thống với bảng nguyên nhân gốc (Root Cause Analysis).' },
+      { cmd: '/status', desc: 'Kiểm tra trạng thái Agent và tiến độ công việc.' },
+      { cmd: '/clean-memory', desc: 'Dọn dẹp và nén ngữ cảnh làm việc, tránh "loãng" bộ nhớ.' },
+      { cmd: '/tdd', desc: 'Phát triển hướng kiểm thử (Test-Driven Development).' },
+      { cmd: '/code-review', desc: 'Đánh giá mã nguồn theo tiêu chuẩn chất lượng cao.' },
+      { cmd: '/enhance', desc: 'Nâng cấp và mở rộng tính năng hiện có.' },
+      { cmd: '/create', desc: 'Khởi tạo luồng ứng dụng mới từ đầu.' },
+    ],
+    en: [
+      { cmd: '/plan', desc: 'Create detailed implementation plan with risk assessment.' },
+      { cmd: '/debug', desc: 'Systematic debugging with Root Cause Analysis.' },
+      { cmd: '/status', desc: 'Check Agent status and project progress.' },
+      { cmd: '/clean-memory', desc: 'Clean and compress working context to avoid memory bloat.' },
+      { cmd: '/tdd', desc: 'Test-Driven Development workflow.' },
+      { cmd: '/code-review', desc: 'Code review against high-quality standards.' },
+      { cmd: '/enhance', desc: 'Upgrade and extend existing features.' },
+      { cmd: '/create', desc: 'Initialize a new application flow from scratch.' },
+    ]
+  };
+
+  // Stack-specific commands mapping
+  const stackCommands = {
+    typescript: {
+      vi: [
+        { cmd: '/ui-ux-pro-max', desc: 'Thiết kế giao diện cao cấp với React/Next.js.' },
+        { cmd: '/e2e', desc: 'Kiểm thử End-to-End với Playwright.' },
+        { cmd: '/preview', desc: 'Khởi động server phát triển cục bộ.' },
+      ],
+      en: [
+        { cmd: '/ui-ux-pro-max', desc: 'Premium UI/UX design with React/Next.js.' },
+        { cmd: '/e2e', desc: 'End-to-End testing with Playwright.' },
+        { cmd: '/preview', desc: 'Start local development server.' },
+      ]
+    },
+    python: {
+      vi: [
+        { cmd: '/python-review', desc: 'Review code Python theo PEP 8 và best practices.' },
+        { cmd: '/test', desc: 'Chạy test suite với pytest.' },
+      ],
+      en: [
+        { cmd: '/python-review', desc: 'Review Python code for PEP 8 and best practices.' },
+        { cmd: '/test', desc: 'Run test suite with pytest.' },
+      ]
+    },
+    rust: {
+      vi: [
+        { cmd: '/rust-review', desc: 'Review Rust: ownership, lifetimes, unsafe.' },
+        { cmd: '/rust-build', desc: 'Sửa lỗi build Rust và borrow checker.' },
+        { cmd: '/rust-test', desc: 'TDD workflow cho Rust với cargo test.' },
+      ],
+      en: [
+        { cmd: '/rust-review', desc: 'Review Rust: ownership, lifetimes, unsafe.' },
+        { cmd: '/rust-build', desc: 'Fix Rust build errors and borrow checker issues.' },
+        { cmd: '/rust-test', desc: 'TDD workflow for Rust with cargo test.' },
+      ]
+    },
+    mobile: {
+      vi: [
+        { cmd: '/flutter-review', desc: 'Review Flutter/Dart code cho widget và state management.' },
+        { cmd: '/flutter-build', desc: 'Sửa lỗi Dart analyzer và Flutter build.' },
+      ],
+      en: [
+        { cmd: '/flutter-review', desc: 'Review Flutter/Dart code for widgets and state management.' },
+        { cmd: '/flutter-build', desc: 'Fix Dart analyzer and Flutter build failures.' },
+      ]
+    },
+    laravel: {
+      vi: [
+        { cmd: '/verify', desc: 'Vòng lặp kiểm tra toàn diện cho Laravel.' },
+      ],
+      en: [
+        { cmd: '/verify', desc: 'Comprehensive verification loop for Laravel.' },
+      ]
+    },
+    java: {
+      vi: [
+        { cmd: '/kotlin-review', desc: 'Review Kotlin/Java code theo chuẩn idiomatic.' },
+        { cmd: '/gradle-build', desc: 'Sửa lỗi Gradle build cho Android/KMP.' },
+      ],
+      en: [
+        { cmd: '/kotlin-review', desc: 'Review Kotlin/Java code for idiomatic patterns.' },
+        { cmd: '/gradle-build', desc: 'Fix Gradle build errors for Android/KMP.' },
+      ]
+    },
+    go: {
+      vi: [
+        { cmd: '/go-review', desc: 'Review Go code: concurrency, error handling.' },
+        { cmd: '/go-build', desc: 'Sửa lỗi Go build và go vet.' },
+        { cmd: '/go-test', desc: 'Chạy table-driven tests với go test.' },
+      ],
+      en: [
+        { cmd: '/go-review', desc: 'Review Go code: concurrency, error handling.' },
+        { cmd: '/go-build', desc: 'Fix Go build errors and go vet warnings.' },
+        { cmd: '/go-test', desc: 'Run table-driven tests with go test.' },
+      ]
+    },
+    ai_agentic: {
+      vi: [
+        { cmd: '/orchestrate', desc: 'Điều phối multi-agent workflows.' },
+        { cmd: '/brainstorm', desc: 'Phiên Socratic cho ý tưởng và chiến lược mới.' },
+      ],
+      en: [
+        { cmd: '/orchestrate', desc: 'Multi-agent workflow orchestration.' },
+        { cmd: '/brainstorm', desc: 'Socratic session for new ideas and strategies.' },
+      ]
+    },
+    marketing_research: {
+      vi: [
+        { cmd: '/brainstorm', desc: 'Brainstorming có cấu trúc cho chiến lược nội dung.' },
+      ],
+      en: [
+        { cmd: '/brainstorm', desc: 'Structured brainstorming for content strategy.' },
+      ]
+    },
+  };
+
+  // Deploy-specific commands
+  const deployCommands = {
+    vercel: {
+      vi: [{ cmd: '/deploy', desc: 'Triển khai lên Vercel (preview + production).' }],
+      en: [{ cmd: '/deploy', desc: 'Deploy to Vercel (preview + production).' }]
+    },
+    gh_pages: {
+      vi: [{ cmd: '/deploy', desc: 'Build và đẩy lên GitHub Pages.' }],
+      en: [{ cmd: '/deploy', desc: 'Build and push to GitHub Pages.' }]
+    },
+    docker: {
+      vi: [{ cmd: '/deploy', desc: 'Build Docker image và triển khai container.' }],
+      en: [{ cmd: '/deploy', desc: 'Build Docker image and deploy container.' }]
+    },
+    custom: {
+      vi: [{ cmd: '/deploy', desc: 'Hỗ trợ chuẩn bị trước quá trình phát hành.' }],
+      en: [{ cmd: '/deploy', desc: 'Assist with pre-release deployment preparation.' }]
+    }
+  };
+
+  // Build the wiki content
+  const title = isVi
+    ? `# 📖 ${name} Wiki - Hệ thống Slash Commands`
+    : `# 📖 ${name} Wiki - Slash Commands Reference`;
+
+  const introText = isVi
+    ? `> Tài liệu này được tạo tự động bởi **Pilo Masterkit** dựa trên cấu hình dự án của bạn.\n> Gọi Agent bằng lệnh: \`Chào ${name}\` hoặc \`Wakeup ${name}\` để bắt đầu phiên làm việc.\n`
+    : `> This document was auto-generated by **Pilo Masterkit** based on your project configuration.\n> Call your Agent with: \`Hey ${name}\` or \`Wakeup ${name}\` to start a session.\n`;
 
-  const triggerVi = `- Chào ${agentName}\n- Thức dậy đi ${agentName}`;
-  const triggerEn = `- Hey ${agentName}\n- Wake up ${agentName}`;
-  const triggerDisplay = language === 'vi' ? triggerVi : triggerEn;
-
-  const moduleList = [
-    "1. **AI Master**: Mô hình LLM & RAG.",
-    "2. **API Standards**: Chuẩn OpenAPI & REST.",
-    "3. **Compliance**: Giao thức GDPR/HIPAA.",
-    "4. **Database Master**: Quy tắc Schema & Migration.",
-    "5. **Design System**: Pattern UI/UX & Tokens.",
-    "6. **Domain Blueprints**: Kiến trúc theo lĩnh vực.",
-    "7. **I18n Master**: Tiêu chuẩn Đa ngôn ngữ.",
-    "8. **Infra Blueprints**: Cấu hình Terraform/Docker.",
-    "9. **Metrics**: Giám sát & Telemetry.",
-    "10. **Security Armor**: Bảo mật & Audit.",
-    "11. **Testing Master**: Chiến lược TDD & E2E.",
-    "12. **UI/UX Pro Max**: Tương tác nâng cao.",
-    "13. **Vitals Templates**: Tiêu chuẩn Hiệu năng.",
-    "14. **Malware Protection**: Chống mã độc & Phishing.",
-    "15. **Auto-Update**: Giao thức tự bảo trì.",
-    "16. **Error Logging**: Hệ thống tự học từ lỗi.",
-    "17. **Docs Sync**: Đồng bộ tài liệu."
+  const coreSectionTitle = isVi ? '## ⚙️ Lệnh Cốt lõi (Core Commands)' : '## ⚙️ Core Commands';
+  const coreList = coreCommands[locale].map(c => `| \`${c.cmd}\` | ${c.desc} |`).join('\n');
+
+  let stackSection = '';
+  const collectedStackCmds = [];
+  for (const s of stacks) {
+    const cmds = stackCommands[s];
+    if (cmds && cmds[locale]) {
+      collectedStackCmds.push(...cmds[locale]);
+    }
+  }
+  if (collectedStackCmds.length > 0) {
+    const stackTitle = isVi
+      ? `## 🎯 Lệnh theo Stack của bạn`
+      : `## 🎯 Stack-Specific Commands`;
+    const stackList = collectedStackCmds.map(c => `| \`${c.cmd}\` | ${c.desc} |`).join('\n');
+    const stackColHeader = isVi ? 'Lệnh' : 'Command';
+    stackSection = `\n${stackTitle}\n\n| ${stackColHeader} | ${isVi ? 'Mô tả' : 'Description'} |\n| :--- | :--- |\n${stackList}\n`;
+  }
+
+  let deploySection = '';
+  const deployCmds = deployCommands[deploy];
+  if (deployCmds && deployCmds[locale]) {
+    const deployTitle = isVi
+      ? `## 🚀 Lệnh Triển khai (Deploy)`
+      : `## 🚀 Deployment Commands`;
+    const deployList = deployCmds[locale].map(c => `| \`${c.cmd}\` | ${c.desc} |`).join('\n');
+    const deployColHeader = isVi ? 'Lệnh' : 'Command';
+    deploySection = `\n${deployTitle}\n\n| ${deployColHeader} | ${isVi ? 'Mô tả' : 'Description'} |\n| :--- | :--- |\n${deployList}\n`;
+  }
+
+  const footer = isVi
+    ? `\n---\n\n*© 2026 Pilo Masterkit - Điều phối tương lai với kỷ luật và tâm hồn.*\n`
+    : `\n---\n\n*© 2026 Pilo Masterkit - Orchestrating the future with discipline and soul.*\n`;
+
+  const wikiContent = [
+    title,
+    '',
+    introText,
+    coreSectionTitle,
+    '',
+    `| ${isVi ? 'Lệnh' : 'Command'} | ${isVi ? 'Mô tả' : 'Description'} |`,
+    '| :--- | :--- |',
+    coreList,
+    stackSection,
+    deploySection,
+    footer
   ].join('\n');
 
-  const geminiContent = `---
-trigger: always_on
----
-
-# GEMINI.md - Cấu hình Agent
-# NOTE FOR AGENT: The content below is for human reference.
-# PLEASE PARSE INSTRUCTIONS IN ENGLISH ONLY (See .agent rules).
-
-Tệp này kiểm soát hành vi của AI Agent.
-
-## 🤖 Danh tính Agent: ${agentName}
-> **Xác minh danh tính**: Bạn là ${agentName}. Luôn thể hiện danh tính này trong phong thái và cách ra quyết định. 
-
-**Giao thức Kích hoạt (Trigger Protocol)**:
-${triggerDisplay}
-
-**Giao thức Đặc biệt**: Khi được gọi bằng trigger trên, bạn PHẢI thực hiện "Kiểm tra tính toàn vẹn ngữ cảnh" để xác nhận đang tuân thủ quy tắc \`.agent\`, báo cáo trạng thái và sẵn sàng đợi chỉ thị.
-## 🎯 Trọng tâm Chính: ${productType.toUpperCase()}
-> **Ưu tiên**: Tối ưu hóa mọi giải pháp cho lĩnh vực này.
-
-## Quy tắc hành vi: ${scaleDisplay}
-**Tự động chạy lệnh**: true
-**Mức độ xác nhận**: Tối thiểu, tự chủ cao
-
-## 🌐 Giao thức Ngôn ngữ (Language Protocol)
-1. **Giao tiếp & Suy luận**: Sử dụng **${langDisplay}** (Bắt buộc).
-2. **Tài liệu (Artifacts)**: Viết nội dung file .md (Plan, Task, Walkthrough) bằng **${langDisplay}**.
-3. **Mã nguồn (Code)**:
-   - Tên biến, hàm, file: **TIẾNG ANH** (camelCase, snake_case...).
-   - Comment trong code: **TIẾNG ANH** (để chuẩn hóa).
-
-## Khả năng cốt lõi
-Agent có quyền truy cập **TOÀN BỘ** kỹ năng (Web, Mobile, DevOps, AI, Security).
-Vui lòng sử dụng các kỹ năng phù hợp nhất cho **${productType.toUpperCase()}**.
-- Thao tác tệp (đọc, ghi, tìm kiếm)
-- Lệnh terminal
-- Duyệt web
-- Phân tích và refactor code
-- Kiểm thử và gỡ lỗi
-
-## 📚 Tiêu chuẩn Dùng chung (Tự động Kích hoạt)
-**17 Module Chia sẻ** sau trong \`.agent/.shared\` phải được tuân thủ:
-${moduleList}
-
-## ⌨️ Hệ thống lệnh Slash Command (Tự động Kích hoạt)
-> **Chỉ dẫn Hệ thống**: Các quy trình (workflows) nằm trong thư mục \`.agent/workflows/\`. Khi người dùng gọi lệnh, BẠN PHẢI đọc file \`.md\` tương ứng (ví dụ: \`/api\` -> \`.agent/workflows/api.md\`) để thực thi.
-
-Sử dụng các lệnh sau để kích hoạt quy trình tác chiến chuyên sâu:
-- **/api**: Thiết kế API & Tài liệu hóa.
-- **/audit**: Kiểm tra toàn diện.
-- **/brainstorm**: Tìm ý tưởng.
-- **/create**: Khởi tạo tính năng/dự án mới.
-- **/debug**: Sửa lỗi sâu.
-- **/deploy**: Triển khai.
-- **/document**: Viết tài liệu tự động.
-- **/plan**: Lập kế hoạch.
-- **/ui-ux-pro-max**: Thiết kế Visuals & Motion cao cấp.
-
-## Hướng dẫn tùy chỉnh
-Thêm các hướng dẫn cụ thể cho dự án của bạn tại đây.
-
----
-*Powered by Pilo Masterkit v2.0*
-`;
-
-  await fs.writeFile(path.join(targetDir, 'GEMINI.md'), geminiContent, 'utf8');
+  await fs.writeFile(path.join(targetDir, 'PILO_WIKI.md'), wikiContent);
+}
+
+/**
+ * Full install (Profile All)
+ */
+async function installProfileAll(targetDir, config = {}) {
+  const sourceAgentDir = path.join(__dirname, '..', '..', '.agent');
+  const targetAgentDir = path.join(targetDir, '.agent');
+  
+  if (await fs.pathExists(sourceAgentDir)) {
+    await fs.copy(sourceAgentDir, targetAgentDir, { overwrite: true });
+  }
+
+  await setupDocs(targetDir, config.locale);
+
+  const hosts = ['claude', 'gemini', 'cursor', 'github', 'codex'];
+  for (const host of hosts) {
+    await injectAIHost(targetDir, host, { 
+      locale: config.locale || 'vi', 
+      scope: 'Enterprise', 
+      type: 'Full-Stack Agentic System', 
+      agentName: config.agentName || 'Pilo'
+    });
+  }
+}
+
+/**
+ * Selective install
+ */
+async function installSelective(config) {
+  const { targetDir, stack, aiHost } = config;
+  const sourceAgentDir = path.join(__dirname, '..', '..', '.agent');
+  const targetAgentDir = path.join(targetDir, '.agent');
+
+  const stacks = Array.isArray(stack) ? stack : [stack];
+  const combinedStackPaths = new Set();
+  
+  for (const s of stacks) {
+    const paths = STACKS[s] || [];
+    paths.forEach(p => combinedStackPaths.add(p));
+  }
+  
+  await copyFilteredAgent(sourceAgentDir, targetAgentDir, Array.from(combinedStackPaths));
+  await setupDocs(targetDir, config.locale);
+
+  if (aiHost && aiHost !== 'none') {
+    await injectAIHost(targetDir, aiHost, config);
+  }
 }
 
 module.exports = {
-  install
+  installProfileAll,
+  installSelective,
+  generateWiki
 };

package/src/lib/manifests/stacks.js

@@ -0,0 +1,122 @@
+/**
+ * Project Stack Manifest for Pilo Masterkit
+ * Defines which .agent files to include based on user's project stack.
+ */
+
+const CORE_FILES = [
+  'rules/CORE_RULES.md',
+  'rules/SECURITY_ARMOR.md',
+  'rules/QUALITY_ASSURANCE.md',
+  'rules/CLEAN_CODE.md',
+  'skills/clean-code/**',
+  'skills/ck/**',
+  'skills/plan-writing/**',
+  'skills/brainstorming/**',
+  'skills/context-budget/**',
+  'skills/verification-loop/**',
+  'skills/systematic-debugging/**',
+  'workflows/plan.md',
+  'workflows/debug.md',
+  'workflows/test.md',
+  'workflows/status.md',
+  'workflows/brainstorm.md',
+  'contexts/**', // Core contexts like identity, soul, etc.
+  'agents/personas/**', // All personas are core in .agent
+];
+
+const STACKS = {
+  typescript: [
+    'skills/frontend-patterns/**',
+    'skills/nextjs-react-expert/**',
+    'skills/tailwind-patterns/**',
+    'skills/testing-patterns/**',
+    'skills/e2e-testing/**',
+    'skills/coding-standards/**',
+    'skills/nestjs-patterns/**',
+    'skills/bun-runtime/**',
+  ],
+  python: [
+    'skills/python-patterns/**',
+    'skills/python-testing/**',
+    'skills/django-patterns/**',
+    'skills/django-security/**',
+    'skills/django-tdd/**',
+    'skills/django-verification/**',
+    'skills/pytorch-patterns/**',
+  ],
+  cpp: [
+    'skills/cpp-coding-standards/**',
+    'skills/cpp-testing/**',
+  ],
+  java: [
+    'skills/java-coding-standards/**',
+    'skills/springboot-patterns/**',
+    'skills/springboot-security/**',
+    'skills/springboot-tdd/**',
+    'skills/springboot-verification/**',
+    'skills/jpa-patterns/**',
+  ],
+  kotlin: [
+    'skills/kotlin-patterns/**',
+    'skills/kotlin-testing/**',
+    'skills/kotlin-coroutines-flows/**',
+    'skills/kotlin-exposed-patterns/**',
+    'skills/kotlin-ktor-patterns/**',
+    'skills/android-clean-architecture/**',
+    'skills/compose-multiplatform-patterns/**',
+  ],
+  go: [
+    'skills/golang-patterns/**',
+    'skills/golang-testing/**',
+  ],
+  rust: [
+    'skills/rust-patterns/**',
+    'skills/rust-pro/**',
+    'skills/rust-testing/**',
+  ],
+  laravel: [
+    'skills/laravel-patterns/**',
+    'skills/laravel-security/**',
+    'skills/laravel-tdd/**',
+    'skills/laravel-verification/**',
+    'skills/laravel-plugin-discovery/**',
+  ],
+  mobile: [
+    'skills/dart-flutter-patterns/**',
+    'skills/flutter-dart-code-review/**',
+    'skills/swiftui-patterns/**',
+    'skills/swift-actor-persistence/**',
+    'skills/swift-concurrency-6-2/**',
+    'skills/swift-protocol-di-testing/**',
+    'skills/mobile-design/**',
+  ],
+  ai_agentic: [
+    'skills/claude-api/**',
+    'skills/claude-devfleet/**',
+    'skills/agent-harness-construction/**',
+    'skills/autonomous-agent-harness/**',
+    'skills/autonomous-loops/**',
+    'skills/continuous-agent-loop/**',
+    'skills/agentic-engineering/**',
+    'skills/gan-style-harness/**',
+    'skills/mcp-builder/**',
+    'skills/mcp-server-patterns/**',
+  ],
+  marketing_research: [
+    'skills/market-research/**',
+    'skills/deep-research/**',
+    'skills/exa-search/**',
+    'skills/brand-voice/**',
+    'skills/content-engine/**',
+    'skills/crosspost/**',
+    'skills/lead-intelligence/**',
+    'skills/social-graph-ranker/**',
+    'skills/investor-materials/**',
+    'skills/investor-outreach/**',
+  ]
+};
+
+module.exports = {
+  CORE_FILES,
+  STACKS
+};

package/src/lib/slash-commands.js

@@ -0,0 +1,28 @@
+const fs = require('fs-extra');
+const path = require('node:path');
+
+/**
+ * Scan .agent/workflows for .md files
+ */
+async function getAvailableWorkflows() {
+  const workflowsDir = path.join(__dirname, '..', '..', '.agent', 'workflows');
+  if (!(await fs.pathExists(workflowsDir))) return [];
+  
+  const files = await fs.readdir(workflowsDir);
+  return files
+    .filter(f => f.endsWith('.md'))
+    .map(f => f.replace('.md', ''));
+}
+
+const CATEGORIZED_SLASH = {
+  core: ['plan', 'status', 'debug', 'test', 'brainstorm', 'aside'],
+  development: ['create', 'enhance', 'build-fix', 'code-review', 'tdd', 'e2e', 'ui-ux-pro-max'],
+  knowledge: ['docs', 'init-docs', 'clean-memory', 'learn', 'learn-eval', 'rules-distill'],
+  automation: ['orchestrate', 'deploy', 'preview', 'sessions', 'save-session', 'resume-session'],
+  advanced: ['prp-plan', 'prp-implement', 'santa-loop', 'skill-create', 'agent-eval']
+};
+
+module.exports = {
+  getAvailableWorkflows,
+  CATEGORIZED_SLASH
+};