viepilot 3.9.1 → 3.10.0

package/CHANGELOG.md

@@ -9,6 +9,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [3.10.0] - 2026-05-25
+
+### Added
+- ENH-101: `vp-crystallize` now generates adapter-specific AI context files at Step 1F
+- ENH-101: New `vp-tools context-files` subcommand generates CLAUDE.md (Claude Code),
+  GEMINI.md (Antigravity), AGENTS.md (Codex), .cursorrules + .cursor/rules/ (Cursor),
+  .github/copilot-instructions.md (Copilot) from `.viepilot/` sources
+- ENH-101: `--all` flag generates all 5 adapter files simultaneously
+- ENH-101: Content sourced from AI-GUIDE.md, PROJECT-CONTEXT.md, SYSTEM-RULES.md, STACKS.md
+
+---
+
 ## [3.9.1] - 2026-05-25
 
 ### Fixed

package/bin/vp-tools.cjs

@@ -1210,6 +1210,44 @@ ${colors.cyan}Examples:${colors.reset}
       });
   },
 
+  /**
+   * ENH-101: Generate adapter context files (CLAUDE.md, GEMINI.md, AGENTS.md, .cursorrules, .github/copilot-instructions.md)
+   * Usage: vp-tools context-files [--all]
+   */
+  'context-files': (args) => {
+    const { generateAll, generateClaudeMd, generateGeminiMd, generateAgentsMd,
+            generateCursorRules, generateCursorMdc, generateCopilotInstructions }
+      = require('../lib/context-file-generators.cjs');
+    const allFlag = args.includes('--all');
+    const projectRoot = process.cwd();
+
+    // detect adapter
+    const adapterCtx = require('../lib/adapter-context.cjs');
+    const adapterId = adapterCtx.detectAdapter ? adapterCtx.detectAdapter() : 'claude-code';
+
+    const targets = allFlag ? generateAll(projectRoot) : (() => {
+      const map = {
+        'claude-code':  [{ path: 'CLAUDE.md', content: generateClaudeMd(projectRoot) }],
+        'antigravity':  [{ path: 'GEMINI.md',  content: generateGeminiMd(projectRoot) }],
+        'codex':        [{ path: 'AGENTS.md',  content: generateAgentsMd(projectRoot) }],
+        'cursor-agent': [
+          { path: '.cursorrules', content: generateCursorRules(projectRoot) },
+          { path: '.cursor/rules/viepilot-context.mdc', content: generateCursorMdc(projectRoot) },
+        ],
+        'copilot': [{ path: '.github/copilot-instructions.md', content: generateCopilotInstructions(projectRoot) }],
+      };
+      return map[adapterId] || map['claude-code'];
+    })();
+
+    for (const { path: relPath, content } of targets) {
+      const absPath = require('path').join(projectRoot, relPath);
+      require('fs').mkdirSync(require('path').dirname(absPath), { recursive: true });
+      require('fs').writeFileSync(absPath, content, 'utf8');
+      console.log(formatSuccess(`Written: ${relPath}`));
+    }
+    process.exit(0);
+  },
+
   /**
    * ENH-073: Manage cross-project personas.
    * persona get            → print active persona JSON
@@ -1627,6 +1665,7 @@ ${colors.cyan}Commands:${colors.reset}
   ${colors.bold}get-registry${colors.reset} [--id <id>] Output global skill registry as JSON
   ${colors.bold}scan-skills${colors.reset}               Scan installed skills → ~/.viepilot/skill-registry.json
   ${colors.bold}check-update${colors.reset} [--silent]   Check for latest ViePilot version on npm (24h cached)
+  ${colors.bold}context-files${colors.reset} [--all]     Generate adapter context files (CLAUDE.md, GEMINI.md, etc.)
   ${colors.bold}persona${colors.reset} <op>              Manage user personas (get|infer|list|set|auto-switch|context)
   ${colors.bold}detect-adapter${colors.reset} [--json]   Detect active adapter (claude-code/cursor/antigravity/codex/copilot)
   ${colors.bold}validate${colors.reset} --adapter <id>   Validate adapter capability requirements; exits 1 on critical gaps

package/lib/context-file-generators.cjs

@@ -0,0 +1,147 @@
+'use strict';
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Read a .viepilot/ source file, return '' if missing.
+ */
+function readSource(projectRoot, relPath) {
+  try {
+    return fs.readFileSync(path.join(projectRoot, relPath), 'utf8');
+  } catch { return ''; }
+}
+
+/**
+ * Build the shared core block used by all adapters.
+ * Sources: AI-GUIDE.md, PROJECT-CONTEXT.md, SYSTEM-RULES.md, STACKS.md
+ */
+function buildCoreBlock(projectRoot) {
+  const meta    = readSource(projectRoot, '.viepilot/PROJECT-META.md');
+  const guide   = readSource(projectRoot, '.viepilot/AI-GUIDE.md');
+  const context = readSource(projectRoot, '.viepilot/PROJECT-CONTEXT.md');
+  const rules   = readSource(projectRoot, '.viepilot/SYSTEM-RULES.md');
+  const stacks  = readSource(projectRoot, '.viepilot/STACKS.md');
+
+  // Extract project name from PROJECT-META.md header or package.json
+  let projectName = 'Project';
+  const nameMatch = meta.match(/^#\s+(.+)/m);
+  if (nameMatch) projectName = nameMatch[1].trim();
+  else {
+    try {
+      projectName = require(path.join(projectRoot, 'package.json')).name || 'Project';
+    } catch { /* noop */ }
+  }
+
+  return { projectName, guide, context, rules, stacks };
+}
+
+/**
+ * CLAUDE.md — Claude Code context file (full Markdown, no frontmatter)
+ */
+function generateClaudeMd(projectRoot) {
+  const { projectName, guide, context, rules, stacks } = buildCoreBlock(projectRoot);
+  const sections = [];
+  sections.push(`# ${projectName} — Claude Code Context\n`);
+  if (guide)   sections.push(`## Navigation\n\n${guide}`);
+  if (context) sections.push(`## Domain Context\n\n${context}`);
+  if (rules)   sections.push(`## Coding Standards\n\n${rules}`);
+  if (stacks)  sections.push(`## Stack\n\n${stacks}`);
+  sections.push(`\n## ViePilot Workflow\n\n` +
+    `- Run \`/vp-auto\` to execute planned phases\n` +
+    `- Run \`/vp-request\` to log bugs or features\n` +
+    `- Current state: \`.viepilot/TRACKER.md\`\n`);
+  return sections.join('\n\n---\n\n');
+}
+
+/**
+ * GEMINI.md — Antigravity / Gemini CLI context file
+ */
+function generateGeminiMd(projectRoot) {
+  // Same structure as CLAUDE.md; different header note
+  const content = generateClaudeMd(projectRoot);
+  return content.replace('Claude Code Context', 'Gemini / Antigravity Context');
+}
+
+/**
+ * AGENTS.md — Codex CLI context file
+ * Codex is patch-based + sequential; emphasize apply_patch conventions
+ */
+function generateAgentsMd(projectRoot) {
+  const { projectName, context, rules, stacks } = buildCoreBlock(projectRoot);
+  const sections = [];
+  sections.push(`# ${projectName} — Codex Agent Instructions\n`);
+  sections.push(`## Conventions\n\n` +
+    `- Use \`apply_patch\` for all file edits\n` +
+    `- No interactive prompts — work sequentially\n` +
+    `- Commit after each logical unit\n`);
+  if (context) sections.push(`## Domain Context\n\n${context}`);
+  if (rules)   sections.push(`## Coding Standards\n\n${rules}`);
+  if (stacks)  sections.push(`## Stack\n\n${stacks}`);
+  sections.push(`\n## ViePilot\n\nPhase state: \`.viepilot/TRACKER.md\`\n`);
+  return sections.join('\n\n---\n\n');
+}
+
+/**
+ * .cursorrules — Cursor legacy flat-file format
+ */
+function generateCursorRules(projectRoot) {
+  const { projectName, context, rules, stacks } = buildCoreBlock(projectRoot);
+  const parts = [`# ${projectName} — Cursor Rules\n`];
+  if (rules)   parts.push(rules);
+  if (context) parts.push(`## Domain\n\n${context}`);
+  if (stacks)  parts.push(`## Stack\n\n${stacks}`);
+  return parts.join('\n\n');
+}
+
+/**
+ * .cursor/rules/viepilot-context.mdc — Cursor new MDC format
+ */
+function generateCursorMdc(projectRoot) {
+  const body = generateCursorRules(projectRoot)
+    .replace(/^# .+\n/, ''); // strip header — MDC description field covers it
+  const { projectName } = buildCoreBlock(projectRoot);
+  return `---
+description: ${projectName} coding standards and architecture context
+globs: ["**/*"]
+alwaysApply: true
+---
+
+${body}`;
+}
+
+/**
+ * .github/copilot-instructions.md — GitHub Copilot
+ * Copilot has shorter context; be concise, focus on coding standards
+ */
+function generateCopilotInstructions(projectRoot) {
+  const { projectName, rules, stacks } = buildCoreBlock(projectRoot);
+  const parts = [`# Copilot Instructions — ${projectName}\n`];
+  if (rules)  parts.push(rules);
+  if (stacks) parts.push(`## Stack\n\n${stacks}`);
+  return parts.join('\n\n');
+}
+
+/**
+ * Generate all 5 adapter context files.
+ * Returns { path: string, content: string }[] — caller writes them.
+ */
+function generateAll(projectRoot) {
+  return [
+    { path: 'CLAUDE.md',                             content: generateClaudeMd(projectRoot) },
+    { path: 'GEMINI.md',                             content: generateGeminiMd(projectRoot) },
+    { path: 'AGENTS.md',                             content: generateAgentsMd(projectRoot) },
+    { path: '.cursorrules',                          content: generateCursorRules(projectRoot) },
+    { path: '.cursor/rules/viepilot-context.mdc',   content: generateCursorMdc(projectRoot) },
+    { path: '.github/copilot-instructions.md',       content: generateCopilotInstructions(projectRoot) },
+  ];
+}
+
+module.exports = {
+  generateClaudeMd,
+  generateGeminiMd,
+  generateAgentsMd,
+  generateCursorRules,
+  generateCursorMdc,
+  generateCopilotInstructions,
+  generateAll,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viepilot",
-  "version": "3.9.1",
+  "version": "3.10.0",
   "description": "**Autonomous Vibe Coding Framework / Bộ khung phát triển tự động có kiểm soát**",
   "main": "index.js",
   "bin": {

package/workflows/crystallize.md

@@ -2172,8 +2172,40 @@ Append to `.viepilot/PROJECT-CONTEXT.md`:
 **Lock semantics**: once written, `## Skills` is the authoritative skill decision for the project. `vp-auto` reads it and **never re-prompts**.
 </step>
 
+<step name="adapter_context_files">
+## Step 1F: Generate Adapter Context Files (ENH-101)
+
+Generate the native AI context file for the active adapter so it starts with full project context.
+
+**Detect adapter and generate:**
+```bash
+node bin/vp-tools.cjs context-files
+# or with --all to generate all 5 adapters at once:
+node bin/vp-tools.cjs context-files --all
+```
+
+**What gets generated:**
+| Adapter | File |
+|---------|------|
+| Claude Code | `CLAUDE.md` (project root) |
+| Cursor | `.cursorrules` + `.cursor/rules/viepilot-context.mdc` |
+| Codex | `AGENTS.md` (project root) |
+| Antigravity | `GEMINI.md` (project root) |
+| GitHub Copilot | `.github/copilot-instructions.md` |
+
+**Content sources** (from `.viepilot/` — skip if not yet generated):
+- `AI-GUIDE.md` → navigation + architecture summary
+- `PROJECT-CONTEXT.md` → domain knowledge, business rules
+- `SYSTEM-RULES.md` → coding standards, patterns
+- `STACKS.md` → tech stack, versions
+
+**Note**: Re-running overwrites existing files with latest `.viepilot/` content.
+Step 1F is non-blocking — if `.viepilot/` sources are incomplete, outputs a partial file
+with a `<!-- viepilot: incomplete -->` comment at the top as a re-run reminder.
+</step>
+
 <step name="cross_reference_gate">
-## Step 1F: Cross-Reference Gate (ENH-064)
+## Step 1G: Cross-Reference Gate (ENH-064)
 
 Run when BOTH `architect_read_complete: true` AND `ui_direction_read_complete: true` are set in working notes:
 
@@ -2208,9 +2240,9 @@ Run when BOTH `architect_read_complete: true` AND `ui_direction_read_complete: t
 <step name="stakeholder_review_gate">
 ---
 
-## Step 1G: Stakeholder Review Gate (ENH-098)
+## Step 1H: Stakeholder Review Gate (ENH-098)
 
-**Trigger**: Runs automatically after Step 1F, before Step 2.
+**Trigger**: Runs automatically after Step 1G, before Step 2.
 
 **Skip conditions**:
 - `--no-stakeholders` flag passed to `/vp-crystallize`