viepilot 2.4.0 → 2.12.0

package/lib/google-slides-exporter.cjs

@@ -0,0 +1,80 @@
+'use strict';
+/**
+ * google-slides-exporter.cjs
+ * Uploads a .pptx file to Google Drive and converts it to a Google Slides presentation.
+ *
+ * Requirements (optional — only needed when --slides flag is used):
+ *   npm install @googleapis/slides
+ *   export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json
+ *
+ * See docs/user/features/proposal.md → "Google Slides Export" for setup guide.
+ */
+
+const fs   = require('fs');
+const path = require('path');
+
+/**
+ * Upload a local .pptx file to Google Drive and convert to Google Slides.
+ *
+ * @param {string} pptxPath  Absolute path to the .pptx file
+ * @param {string} title     Title for the Google Slides presentation
+ * @returns {Promise<string>} Public edit URL of the created presentation
+ */
+async function uploadToSlides(pptxPath, title) {
+  // Lazy-load @googleapis/slides — it is an optionalDependency.
+  // Provide a clear, actionable error when the package is not installed.
+  let googleApis;
+  try {
+    googleApis = require('googleapis');
+  } catch {
+    throw new Error(
+      'Google Slides export requires the @googleapis/slides package.\n\n' +
+      'Install it:\n' +
+      '  npm install @googleapis/slides\n\n' +
+      'Then set your service account credentials:\n' +
+      '  export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json\n\n' +
+      'See: docs/user/features/proposal.md → "Google Slides Export"'
+    );
+  }
+
+  const { google } = googleApis;
+
+  // Verify credentials env var is set before attempting auth
+  if (!process.env.GOOGLE_APPLICATION_CREDENTIALS) {
+    throw new Error(
+      'GOOGLE_APPLICATION_CREDENTIALS environment variable is not set.\n\n' +
+      'Set it to the path of your Google service account JSON key:\n' +
+      '  export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json\n\n' +
+      'See: docs/user/features/proposal.md → "Google Slides Export"'
+    );
+  }
+
+  // Authenticate via service account (no browser interaction required)
+  const auth = new google.auth.GoogleAuth({
+    scopes: [
+      'https://www.googleapis.com/auth/drive',
+      'https://www.googleapis.com/auth/presentations',
+    ],
+  });
+
+  const authClient = await auth.getClient();
+  const drive = google.drive({ version: 'v3', auth: authClient });
+
+  // Upload .pptx and request conversion to Google Slides format
+  const { data: file } = await drive.files.create({
+    requestBody: {
+      name: title,
+      mimeType: 'application/vnd.google-apps.presentation',
+    },
+    media: {
+      mimeType:
+        'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+      body: fs.createReadStream(pptxPath),
+    },
+    fields: 'id',
+  });
+
+  return `https://docs.google.com/presentation/d/${file.id}/edit`;
+}
+
+module.exports = { uploadToSlides };

package/lib/proposal-generator.cjs

@@ -0,0 +1,249 @@
+'use strict';
+
+const fs   = require('fs');
+const path = require('path');
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Proposal type definitions
+// ─────────────────────────────────────────────────────────────────────────────
+const PROPOSAL_TYPES = {
+  'project-proposal':  { slides: 10, label: 'Project Proposal' },
+  'tech-architecture': { slides: 12, label: 'Technical Architecture' },
+  'product-pitch':     { slides: 12, label: 'Product Pitch Deck' },
+  'general':           { slides: 8,  label: 'General Proposal' },
+};
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Template resolution — 2-tier
+//   Tier 1: {projectRoot}/.viepilot/proposal-templates/{type}.{ext}  (project override)
+//   Tier 2: {packageRoot}/templates/proposal/{ext}/{type}.{ext}       (stock)
+// ─────────────────────────────────────────────────────────────────────────────
+function resolveTemplate(type, ext, projectRoot) {
+  const override = path.join(projectRoot, '.viepilot', 'proposal-templates', `${type}.${ext}`);
+  if (fs.existsSync(override)) return override;
+  // Stock fallback — lives next to this file at ../templates/proposal/{ext}/
+  return path.join(__dirname, '..', 'templates', 'proposal', ext, `${type}.${ext}`);
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Context detection — auto-load latest brainstorm session
+// ─────────────────────────────────────────────────────────────────────────────
+function detectBrainstormSession(projectRoot) {
+  const dir = path.join(projectRoot, 'docs', 'brainstorm');
+  if (!fs.existsSync(dir)) return null;
+  const files = fs.readdirSync(dir)
+    .filter(f => f.startsWith('session-') && f.endsWith('.md'))
+    .sort()
+    .reverse();
+  return files.length ? path.join(dir, files[0]) : null;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Proposal type validation
+// ─────────────────────────────────────────────────────────────────────────────
+function validateType(type) {
+  if (!PROPOSAL_TYPES[type]) {
+    throw new Error(
+      `Unknown proposal type "${type}". Valid types: ${Object.keys(PROPOSAL_TYPES).join(', ')}`
+    );
+  }
+  return PROPOSAL_TYPES[type];
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Manifest meta schema (ENH-040)
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Manifest meta object — collected via Step 2C quality brief.
+ *
+ * @typedef {Object} ProposalMeta
+ * @property {string} cta           - Decision/action the proposal should drive
+ * @property {string} [budget]      - Approximate budget range (optional)
+ * @property {string} [timeline]    - Key deadline or constraint (optional)
+ * @property {string} decisionMaker - Who is the primary audience/decision-maker
+ */
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Output path builder
+// ─────────────────────────────────────────────────────────────────────────────
+function buildOutputPaths(slug, projectRoot) {
+  const date = new Date().toISOString().slice(0, 10);
+  const base = path.join(projectRoot, 'docs', 'proposals', `${slug}-${date}`);
+  return {
+    md:     `${base}.md`,
+    pptx:   `${base}.pptx`,
+    docx:   `${base}.docx`,
+    slides: `${base}-slides.txt`,
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Language instruction builder (ENH-039)
+// ─────────────────────────────────────────────────────────────────────────────
+
+const LANG_NAMES = {
+  vi: 'Vietnamese', ja: 'Japanese', fr: 'French', zh: 'Chinese',
+  ko: 'Korean', de: 'German', es: 'Spanish', pt: 'Portuguese',
+  it: 'Italian', th: 'Thai', ar: 'Arabic', hi: 'Hindi',
+};
+
+/**
+ * Build a language instruction string to prepend to the AI content generation prompt.
+ *
+ * @param {string} lang - ISO 639-1 code (e.g. 'vi', 'en', 'ja')
+ * @param {boolean} [contentOnly=false] - if true, translate content only; keep structural labels English
+ * @returns {string} Instruction to inject into AI prompt (empty string for English)
+ */
+function buildLangInstruction(lang, contentOnly = false) {
+  if (!lang || lang === 'en') {
+    return '';  // English is default — no explicit instruction needed
+  }
+  const langName = LANG_NAMES[lang] || lang.toUpperCase();
+
+  if (contentOnly) {
+    return (
+      `LANGUAGE INSTRUCTION: Generate all slide content (bullet points, body text, ` +
+      `speaker notes, and paragraph content) in ${langName}. ` +
+      `Keep structural labels, section names, and template placeholders in English.`
+    );
+  }
+  return (
+    `LANGUAGE INSTRUCTION: Generate ALL content — slide headings, bullet points, ` +
+    `body text, speaker notes, document section titles, and paragraph content — in ${langName}. ` +
+    `Do not mix languages.`
+  );
+}
+
+/** @type {Record<string, string[]>} */
+const DIAGRAM_TYPES_BY_PROPOSAL = {
+  'project-proposal':  ['flowchart', 'gantt'],
+  'tech-architecture': ['flowchart', 'sequenceDiagram', 'classDiagram'],
+  'product-pitch':     ['flowchart', 'sequenceDiagram'],
+  'general':           ['flowchart'],
+};
+
+/**
+ * Returns the list of Mermaid diagram types to generate for a given proposal type.
+ * @param {string} typeId - Proposal type ID (e.g. 'project-proposal')
+ * @returns {string[]} Array of Mermaid diagram type identifiers
+ */
+function getDiagramTypes(typeId) {
+  return DIAGRAM_TYPES_BY_PROPOSAL[typeId] || ['flowchart'];
+}
+
+/** Known architect workspace page filenames (from vp-brainstorm --architect) */
+const ARCHITECT_PAGES = [
+  'architecture.html',
+  'erd.html',
+  'sequence-diagram.html',
+  'feature-map.html',
+  'user-use-cases.html',
+  'deployment.html',
+  'apis.html',
+  'tech-notes.html',
+  'data-flow.html',
+  'decisions.html',
+];
+
+/**
+ * Detect available HTML visual artifacts for screenshot embedding in PPTX slides.
+ * Scans the ui-direction session directory for index.html, pages/*.html, and
+ * architect workspace pages (architecture.html, erd.html, etc.).
+ *
+ * @param {string} [sessionDir] - Absolute path to a .viepilot/ui-direction/{session}/ dir.
+ *   If omitted, auto-detects the latest session by scanning CWD/.viepilot/ui-direction/.
+ * @returns {{ uiPages: string[], architectPages: string[], sessionDir: string|null }}
+ */
+function detectVisualArtifacts(sessionDir) {
+  const fs   = require('fs');
+  const path = require('path');
+
+  // Auto-detect latest session when no dir provided
+  let resolvedDir = sessionDir || null;
+  if (!resolvedDir) {
+    const uiBase = path.join(process.cwd(), '.viepilot', 'ui-direction');
+    if (fs.existsSync(uiBase)) {
+      const entries = fs.readdirSync(uiBase)
+        .filter(e => {
+          try { return fs.statSync(path.join(uiBase, e)).isDirectory(); } catch { return false; }
+        })
+        .sort()
+        .reverse();  // ISO date dirs: latest first
+      if (entries.length > 0) resolvedDir = path.join(uiBase, entries[0]);
+    }
+  }
+
+  const result = { uiPages: [], architectPages: [], sessionDir: resolvedDir };
+  if (!resolvedDir || !fs.existsSync(resolvedDir)) return result;
+
+  // ui-direction index page
+  const indexHtml = path.join(resolvedDir, 'index.html');
+  if (fs.existsSync(indexHtml)) result.uiPages.push(indexHtml);
+
+  // ui-direction sub-pages
+  const pagesDir = path.join(resolvedDir, 'pages');
+  if (fs.existsSync(pagesDir)) {
+    const pageFiles = fs.readdirSync(pagesDir)
+      .filter(f => f.endsWith('.html'))
+      .sort()
+      .map(f => path.join(pagesDir, f));
+    result.uiPages.push(...pageFiles);
+  }
+
+  // Architect workspace pages (in same session dir)
+  for (const page of ARCHITECT_PAGES) {
+    const p = path.join(resolvedDir, page);
+    if (fs.existsSync(p)) result.architectPages.push(p);
+  }
+
+  return result;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Design configs — ENH-045
+// ─────────────────────────────────────────────────────────────────────────────
+const DESIGN_CONFIGS = {
+  'modern-tech': {
+    colorPalette: 'navy-electric',
+    layoutStyle:  'modern-tech',
+    fontPair:     'Calibri / Calibri Light',
+  },
+  'enterprise': {
+    colorPalette: 'navy-gold',
+    layoutStyle:  'enterprise',
+    fontPair:     'Georgia / Calibri',
+  },
+  'creative': {
+    colorPalette: 'dark-vibrant',
+    layoutStyle:  'creative',
+    fontPair:     'Calibri / Calibri',
+  },
+};
+
+/**
+ * Choose design config based on project context signals (ENH-045).
+ * @param {Object} ctx - { sector?, audience?, tone?, proposalType? }
+ * @returns {{ colorPalette: string, layoutStyle: string, fontPair: string }}
+ */
+function getDesignConfig(ctx = {}) {
+  const { sector = '', audience = '', tone = '' } = ctx;
+  const lower = `${sector} ${audience} ${tone}`.toLowerCase();
+  if (/bank|financ|enterprise|corp|legal|compliance|government/.test(lower))
+    return DESIGN_CONFIGS['enterprise'];
+  if (/startup|creative|design|game|media|agency|art/.test(lower))
+    return DESIGN_CONFIGS['creative'];
+  return DESIGN_CONFIGS['modern-tech'];
+}
+
+module.exports = {
+  PROPOSAL_TYPES,
+  resolveTemplate,
+  detectBrainstormSession,
+  validateType,
+  buildOutputPaths,
+  buildLangInstruction,
+  getDiagramTypes,
+  detectVisualArtifacts,
+  DESIGN_CONFIGS,
+  getDesignConfig,
+};

package/lib/screenshot-artifact.cjs

@@ -0,0 +1,142 @@
+'use strict';
+/**
+ * screenshot-artifact.cjs
+ * ENH-042 + ENH-043: Optional screenshot/render utility for vp-proposal visual embedding.
+ *
+ * - puppeteer (optional): screenshots HTML artifact files → PNG
+ * - mmdc CLI (optional): renders Mermaid source → PNG
+ * Both return null gracefully when the tool is absent — no crash, no hard dep.
+ *
+ * Usage:
+ *   const { screenshotArtifact, isPuppeteerAvailable,
+ *           isMmdcAvailable, renderMermaidToPng, cleanupScreenshot }
+ *     = require('./lib/screenshot-artifact.cjs');
+ */
+
+const os   = require('os');
+const path = require('path');
+const fs   = require('fs');
+const cp   = require('child_process');
+
+/**
+ * Check if puppeteer is available without throwing.
+ * @returns {boolean}
+ */
+function isPuppeteerAvailable() {
+  try { require.resolve('puppeteer'); return true; } catch { return false; }
+}
+
+/**
+ * Screenshot an HTML file to a temporary PNG using puppeteer (headless Chrome).
+ * Returns null silently when puppeteer is not installed.
+ *
+ * @param {string} htmlPath - Absolute path to the HTML file to screenshot
+ * @param {object} [opts]
+ * @param {number} [opts.width=1280] - Viewport width in px
+ * @param {number} [opts.height=720] - Viewport height in px (matches 16:9 slide ratio)
+ * @returns {Promise<string|null>} Absolute path to a temp PNG file, or null if unavailable
+ */
+async function screenshotArtifact(htmlPath, opts = {}) {
+  // Graceful: return null if puppeteer not installed
+  let puppeteer;
+  try { puppeteer = require('puppeteer'); } catch { return null; }
+
+  if (!htmlPath || !fs.existsSync(htmlPath)) return null;
+
+  const { width = 1280, height = 720 } = opts;
+  const tmpFile = path.join(os.tmpdir(), `vp-artifact-${Date.now()}.png`);
+
+  const browser = await puppeteer.launch({
+    headless: 'new',        // puppeteer ≥ 20 compat
+    args: ['--no-sandbox', '--disable-setuid-sandbox'],  // CI-safe
+  });
+  try {
+    const page = await browser.newPage();
+    await page.setViewport({ width, height });
+    await page.goto(`file://${htmlPath}`, { waitUntil: 'networkidle0', timeout: 15000 });
+    await page.screenshot({ path: tmpFile, fullPage: false });
+    return tmpFile;
+  } finally {
+    await browser.close();
+  }
+}
+
+/**
+ * Clean up a temp screenshot file after embedding.
+ * @param {string|null} tmpPath
+ */
+function cleanupScreenshot(tmpPath) {
+  if (tmpPath && fs.existsSync(tmpPath)) {
+    try { fs.unlinkSync(tmpPath); } catch { /* ignore cleanup errors */ }
+  }
+}
+
+// ── Mermaid rendering (ENH-043) ───────────────────────────────────────────────
+
+/**
+ * Check if @mermaid-js/mermaid-cli (mmdc) is available on PATH.
+ * @returns {boolean}
+ */
+function isMmdcAvailable() {
+  try {
+    const r = cp.spawnSync('mmdc', ['--version'], { encoding: 'utf8', timeout: 5000 });
+    return r.status === 0;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Render a Mermaid diagram source string to a PNG file using the mmdc CLI.
+ * Returns null silently when mmdc is not available or rendering fails.
+ *
+ * @param {string} mermaidSource - Valid Mermaid 10+ source code
+ * @param {string} outputPath - Absolute path for the output .png file
+ * @returns {string|null} outputPath on success, null if mmdc absent or error
+ */
+function renderMermaidToPng(mermaidSource, outputPath) {
+  if (!isMmdcAvailable()) return null;
+  if (!mermaidSource || !mermaidSource.trim()) return null;
+  if (!outputPath) return null;
+
+  const tmpInput = outputPath.replace(/\.png$/i, '.mmd');
+  try {
+    fs.writeFileSync(tmpInput, mermaidSource, 'utf8');
+    const r = cp.spawnSync(
+      'mmdc',
+      ['-i', tmpInput, '-o', outputPath, '-b', 'white'],
+      { encoding: 'utf8', timeout: 30000 }
+    );
+    return (r.status === 0 && fs.existsSync(outputPath)) ? outputPath : null;
+  } catch {
+    return null;
+  } finally {
+    try { if (fs.existsSync(tmpInput)) fs.unlinkSync(tmpInput); } catch { /* ignore */ }
+  }
+}
+
+// ── Missing-tool warning (ENH-044) ───────────────────────────────────────────
+
+/**
+ * Emit a standardized warning to stderr when a visual rendering tool is absent
+ * but visual artifacts exist and embedding is mandatory.
+ *
+ * @param {string} tool - Tool name (e.g. 'puppeteer', 'mmdc')
+ * @param {string} installCmd - Install hint (e.g. 'npm install puppeteer')
+ */
+function warnMissingTool(tool, installCmd) {
+  process.stderr.write(
+    `\n[vp-proposal] ⚠  Visual artifacts found but '${tool}' is not installed.\n` +
+    `  Install to enable screenshots: ${installCmd}\n` +
+    `  Using placeholder/text fallback instead.\n\n`
+  );
+}
+
+module.exports = {
+  screenshotArtifact,
+  isPuppeteerAvailable,
+  cleanupScreenshot,
+  isMmdcAvailable,
+  renderMermaidToPng,
+  warnMissingTool,
+};

package/lib/viepilot-config.cjs

@@ -13,12 +13,16 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
-/** @type {{ language: { communication: string, document: string } }} */
+/** @type {{ language: { communication: string, document: string }, proposal: { recentLangs: string[], defaultLang: string } }} */
 const DEFAULTS = {
   language: {
     communication: 'en',
     document: 'en',
   },
+  proposal: {
+    recentLangs: [],   // MRU list, most recent first, max 5
+    defaultLang: 'en', // kept in sync with recentLangs[0]
+  },
 };
 
 /**
@@ -94,10 +98,37 @@ function resetConfig(overrideHomedir) {
   fs.writeFileSync(configPath, JSON.stringify(DEFAULTS, null, 2) + '\n', 'utf8');
 }
 
+/**
+ * Get the suggested default language for proposals.
+ * Returns recentLangs[0] if present, else 'en'.
+ * @param {string | undefined} overrideHomedir
+ * @returns {string}
+ */
+function getProposalLang(overrideHomedir) {
+  const cfg = readConfig(overrideHomedir);
+  const recent = cfg.proposal && cfg.proposal.recentLangs;
+  return (Array.isArray(recent) && recent.length > 0) ? recent[0] : 'en';
+}
+
+/**
+ * Record a used language: prepend to recentLangs, dedup, cap at 5, sync defaultLang.
+ * @param {string} lang - ISO 639-1 code
+ * @param {string | undefined} overrideHomedir
+ */
+function recordProposalLang(lang, overrideHomedir) {
+  const cfg = readConfig(overrideHomedir);
+  const existing = (cfg.proposal && Array.isArray(cfg.proposal.recentLangs))
+    ? cfg.proposal.recentLangs : [];
+  const updated = [lang, ...existing.filter(l => l !== lang)].slice(0, 5);
+  writeConfig({ proposal: { recentLangs: updated, defaultLang: updated[0] } }, overrideHomedir);
+}
+
 module.exports = {
   DEFAULTS,
   getConfigPath,
   readConfig,
   writeConfig,
   resetConfig,
+  getProposalLang,
+  recordProposalLang,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viepilot",
-  "version": "2.4.0",
+  "version": "2.12.0",
   "description": "**Autonomous Vibe Coding Framework / Bộ khung phát triển tự động có kiểm soát**",
   "main": "index.js",
   "bin": {
@@ -72,6 +72,13 @@
       }
     }
   },
+  "dependencies": {
+    "docx": "^9.0.0",
+    "pptxgenjs": "^3.12.0"
+  },
+  "optionalDependencies": {
+    "@googleapis/slides": "^1.0.0"
+  },
   "devDependencies": {
     "jest": "^30.3.0"
   }

package/skills/vp-audit/SKILL.md

@@ -34,6 +34,17 @@ Audit ViePilot project state and documentation to detect drift.
 Works on **any project** using ViePilot (Java, Node, Python, etc.).
 Auto-detects if running inside the viepilot framework repo to enable framework-specific checks.
 
+**Brownfield Import Compatibility (FEAT-018):**
+
+When auditing a project bootstrapped via `vp-crystallize --brownfield`:
+
+- If `docs/brainstorm/` exists and contains **only** `session-brownfield-import.md` (no `session-*.md` greenfield files):
+  - **Valid brownfield import** — do NOT flag as missing brainstorm session.
+  - Verify `session-brownfield-import.md` contains a `## Scan Report` section with a YAML block.
+    - If YAML block absent → flag LOW severity: "Brownfield stub missing Scan Report content."
+  - If `.viepilot/TRACKER.md` contains `## Brownfield Import` section → brownfield metadata confirmed; no further brainstorm check needed.
+- If `docs/brainstorm/` is completely absent → flag MEDIUM severity: "No brainstorm session or brownfield stub found — run `/vp-crystallize` or `/vp-crystallize --brownfield`."
+
 **Tier 1 — ViePilot State Consistency (all projects):**
 - `.viepilot/TRACKER.md` current state vs `.viepilot/phases/*/PHASE-STATE.md`
 - `.viepilot/ROADMAP.md` phase status vs PHASE-STATE.md

package/skills/vp-crystallize/SKILL.md

@@ -77,6 +77,33 @@ Convert brainstorm sessions into structured artifacts for autonomous AI executio
 - `DOCUMENT_LANG` controls content language for all generated files (ROADMAP, TRACKER, ARCHITECTURE, etc.).
 - `COMMUNICATION_LANG` controls prompt/confirmation language for this session.
 - Configure via: `vp-tools config set language.document vi`
+
+**Brownfield Mode (`--brownfield`) — FEAT-018:**
+
+Use when adopting ViePilot on an **existing project** (no brainstorm session required).
+
+Flags:
+- `--brownfield` : Explicit brownfield mode
+- *(auto-detected)* : Triggers when `docs/brainstorm/` is absent/empty AND `.viepilot/` does not exist
+
+Scanner runs 12 signal categories across the existing codebase:
+1. **Build manifests** — `package.json`, `pom.xml`, `pyproject.toml`, `Cargo.toml`, `go.mod`, etc. (11 platforms) → infers project_name, version, language, deps
+2. **Framework detection** — 40+ dependency patterns → backend/frontend/ORM/auth/broker/test frameworks
+3. **Architecture layers** — 18 directory patterns → controller/service/repository/frontend/infra/etc.
+4. **Database schema signals** — Flyway/Liquibase/Prisma/Rails migrations + docker-compose services
+5. **API contracts** — OpenAPI, gRPC `.proto`, GraphQL schemas
+6. **Infrastructure** — Dockerfile, docker-compose, k8s, Terraform, Vercel, Fly.io, etc. (16 patterns)
+7. **Environment config** — `.env.example` key names (never reads `.env`)
+8. **Test coverage** — Jest/pytest/JUnit/Cypress config + coverage report dirs
+9. **Code quality tools** — ESLint/Prettier/SonarQube/pre-commit/golangci-lint/etc. (14 patterns)
+10. **Documentation** — README, CHANGELOG, ADRs, docs/ (priority-ordered)
+11. **Git history** — commit convention, version pattern, contributors, repo URL
+12. **Language survey** — file extension glob → language distribution
+
+Produces **Scan Report** (YAML) with DETECTED / ASSUMED / MISSING classification.
+MUST-DETECT gaps (project_name, primary_language, ≥1 framework, current_version) block artifact generation until user fills interactively.
+Generates `docs/brainstorm/session-brownfield-import.md` stub for `vp-audit` compatibility.
+Safety: never reads `.env`; skips `node_modules/`, `.git/`, `target/`, `build/`, `dist/`.
 </objective>
 
 <execution_context>