@pcoliveira90/pdd 0.2.5 → 0.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pcoliveira90/pdd",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Patch-Driven Development CLI — safe, resilient and guided code changes",
   "type": "module",
   "bin": {

package/src/cli/index.js

@@ -110,7 +110,7 @@ export async function runCli(argv = process.argv.slice(2)) {
     console.log('');
     console.log('Commands:');
     console.log('  pdd init <project-name>');
-    console.log('  pdd init --here [--force] [--upgrade] [-y] [--no-ide-prompt] [--ide=claude|cursor|copilot|...]');
+    console.log('  pdd init --here [--force] [--upgrade] [-y] [--no-ide-prompt] [--no-project-review] [--ide=claude|cursor|copilot|...]');
     console.log('  pdd doctor [--fix]');
     console.log('  pdd status');
     console.log('  pdd fix "description" [--open-pr] [--dry-run] [--no-validate]');

package/src/cli/init-command.js

@@ -4,6 +4,7 @@ import readline from 'node:readline/promises';
 import { stdin as input, stdout as output } from 'node:process';
 import { CORE_TEMPLATES, IDE_ADAPTERS, PDD_TEMPLATE_VERSION } from '../core/template-registry.js';
 import { buildTemplateUpgradePlan, applyTemplateUpgradePlan } from '../core/template-upgrade.js';
+import { runInitialProjectReviewAgent } from '../core/project-review-agent.js';
 import {
   IDE_ORDER,
   IDE_LABELS,
@@ -90,6 +91,16 @@ function printUpgradeSummary(summary) {
   }
 }
 
+function ensureConstitution(baseDir, force = false) {
+  const constitutionPath = path.join(baseDir, '.pdd/constitution.md');
+  if (!force && fs.existsSync(constitutionPath)) {
+    return false;
+  }
+
+  writeFile(baseDir, '.pdd/constitution.md', CORE_TEMPLATES['.pdd/constitution.md']);
+  return true;
+}
+
 function resolveIdeSelectionFromInput(raw, presence) {
   const t = raw.trim().toLowerCase();
   if (t === '' || t === 'y' || t === 'yes' || t === 'sim' || t === 's') {
@@ -204,6 +215,7 @@ export async function runInit(argv = process.argv.slice(2)) {
   const here = argv.includes('--here');
   const force = argv.includes('--force');
   const upgrade = argv.includes('--upgrade');
+  const noProjectReview = argv.includes('--no-project-review');
 
   const projectName = !here && argv[1] && !argv[1].startsWith('--') ? argv[1] : null;
   const baseDir = here ? cwd : path.join(cwd, projectName || 'pdd-project');
@@ -233,6 +245,11 @@ export async function runInit(argv = process.argv.slice(2)) {
     console.log('🚀 PDD initialized');
   }
 
+  const constitutionCreated = ensureConstitution(baseDir, force);
+  if (constitutionCreated) {
+    console.log('📜 Constitution ensured: .pdd/constitution.md');
+  }
+
   let ideList = normalizeIdeList(argv);
   if (ideList.length > 0) {
     const unknown = ideList.filter(id => !IDE_ADAPTERS[id]);
@@ -246,4 +263,8 @@ export async function runInit(argv = process.argv.slice(2)) {
 
   const ideResults = installIdeAdapters(baseDir, ideList, force);
   ideResults.forEach(r => console.log(`- ${r.status}: ${r.path}`));
+
+  if (!noProjectReview) {
+    await runInitialProjectReviewAgent(baseDir, argv);
+  }
 }

package/src/core/project-review-agent.js

@@ -0,0 +1,301 @@
+import fs from 'fs';
+import path from 'path';
+import readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+
+const REVIEW_DIR = '.pdd/review';
+const REVIEW_FILE = `${REVIEW_DIR}/project-review.md`;
+const REVIEW_STATUS_FILE = `${REVIEW_DIR}/project-review-status.json`;
+const REVIEW_FEEDBACK_FILE = `${REVIEW_DIR}/project-review-feedback.md`;
+
+const IGNORED_DIRS = new Set([
+  '.git',
+  '.pdd',
+  'node_modules',
+  'dist',
+  'build',
+  'coverage',
+  '.next',
+  '.turbo',
+  '.idea',
+  '.vscode'
+]);
+
+function ensureDir(filePath) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+}
+
+function writeFile(baseDir, relativePath, content) {
+  const fullPath = path.join(baseDir, relativePath);
+  ensureDir(fullPath);
+  fs.writeFileSync(fullPath, content, 'utf-8');
+}
+
+function readJson(filePath) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+function safeRead(filePath) {
+  try {
+    return fs.readFileSync(filePath, 'utf-8');
+  } catch {
+    return null;
+  }
+}
+
+function listFiles(rootDir, currentDir, depth = 0, maxDepth = 3) {
+  if (depth > maxDepth) return [];
+  const entries = fs.readdirSync(currentDir, { withFileTypes: true });
+  const files = [];
+
+  for (const entry of entries) {
+    const fullPath = path.join(currentDir, entry.name);
+    const relative = path.relative(rootDir, fullPath);
+
+    if (entry.isDirectory()) {
+      if (IGNORED_DIRS.has(entry.name)) continue;
+      files.push(...listFiles(rootDir, fullPath, depth + 1, maxDepth));
+      continue;
+    }
+
+    files.push(relative);
+  }
+
+  return files;
+}
+
+function detectTechnologies(baseDir, files) {
+  const tech = new Set();
+  const packageJsonPath = path.join(baseDir, 'package.json');
+  const pyprojectPath = path.join(baseDir, 'pyproject.toml');
+  const requirementsPath = path.join(baseDir, 'requirements.txt');
+  const goModPath = path.join(baseDir, 'go.mod');
+  const cargoPath = path.join(baseDir, 'Cargo.toml');
+
+  const packageJson = fs.existsSync(packageJsonPath) ? readJson(packageJsonPath) : null;
+  if (packageJson) {
+    tech.add('Node.js');
+    if (packageJson.type === 'module') {
+      tech.add('JavaScript (ESM)');
+    }
+    const deps = {
+      ...(packageJson.dependencies || {}),
+      ...(packageJson.devDependencies || {})
+    };
+
+    if (deps.typescript) tech.add('TypeScript');
+    if (deps.react) tech.add('React');
+    if (deps.next) tech.add('Next.js');
+    if (deps.express) tech.add('Express');
+    if (deps.vite) tech.add('Vite');
+  }
+
+  if (fs.existsSync(pyprojectPath) || fs.existsSync(requirementsPath)) tech.add('Python');
+  if (fs.existsSync(goModPath)) tech.add('Go');
+  if (fs.existsSync(cargoPath)) tech.add('Rust');
+
+  if (files.some(file => file.endsWith('.sql'))) tech.add('SQL');
+  if (files.some(file => file.endsWith('.md'))) tech.add('Documentation-heavy');
+  if (files.some(file => file.endsWith('.yml') || file.endsWith('.yaml'))) tech.add('CI/Automation');
+
+  return Array.from(tech);
+}
+
+function inferPurpose(baseDir) {
+  const packageJson = readJson(path.join(baseDir, 'package.json'));
+  if (packageJson?.description) {
+    return packageJson.description.trim();
+  }
+
+  const readme = safeRead(path.join(baseDir, 'README.md')) || safeRead(path.join(baseDir, 'README.pt-BR.md'));
+  if (!readme) {
+    return 'Project purpose not explicitly documented.';
+  }
+
+  const nonEmpty = readme
+    .split('\n')
+    .map(line => line.trim())
+    .find(line => line.length > 0 && !line.startsWith('#'));
+
+  return nonEmpty || 'Project purpose not explicitly documented.';
+}
+
+function pickCoreAreas(files) {
+  const rootFolders = new Map();
+  for (const file of files) {
+    const first = file.split(path.sep)[0];
+    if (!first || first.includes('.')) continue;
+    rootFolders.set(first, (rootFolders.get(first) || 0) + 1);
+  }
+
+  return Array.from(rootFolders.entries())
+    .sort((a, b) => b[1] - a[1])
+    .slice(0, 6)
+    .map(([name]) => name);
+}
+
+function pickKeyFiles(files) {
+  const preferred = [
+    'README.md',
+    'README.pt-BR.md',
+    'package.json',
+    'pyproject.toml',
+    'go.mod',
+    'Cargo.toml',
+    'src/cli/index.js',
+    'src/index.js',
+    'src/main.js'
+  ];
+
+  const normalized = new Set(files.map(file => file.replace(/\\/g, '/')));
+  const first = preferred.filter(file => normalized.has(file));
+  const rest = files
+    .map(file => file.replace(/\\/g, '/'))
+    .filter(file => !first.includes(file))
+    .slice(0, 6);
+
+  return [...first, ...rest].slice(0, 10);
+}
+
+function buildReport({ purpose, technologies, coreAreas, keyFiles }) {
+  return [
+    '# Initial Project Review',
+    '',
+    '## What this project appears to be',
+    purpose,
+    '',
+    '## Main technologies',
+    ...(technologies.length > 0 ? technologies.map(item => `- ${item}`) : ['- Not detected']),
+    '',
+    '## Main areas in repository',
+    ...(coreAreas.length > 0 ? coreAreas.map(area => `- ${area}`) : ['- Not detected']),
+    '',
+    '## Key files inspected by review agent',
+    ...(keyFiles.length > 0 ? keyFiles.map(file => `- ${file}`) : ['- Not detected']),
+    '',
+    '## Reviewer checklist',
+    '- [ ] Is the project purpose correct?',
+    '- [ ] Are the technologies correct?',
+    '- [ ] Are there important modules missing in the summary?',
+    ''
+  ].join('\n');
+}
+
+function printReviewSummary({ purpose, technologies, coreAreas, reportPath }) {
+  console.log('');
+  console.log('🤖 Initial project review agent');
+  console.log(`- Purpose: ${purpose}`);
+  console.log(`- Technologies: ${technologies.length > 0 ? technologies.join(', ') : 'Not detected'}`);
+  console.log(`- Main areas: ${coreAreas.length > 0 ? coreAreas.join(', ') : 'Not detected'}`);
+  console.log(`- Full report: ./${reportPath}`);
+}
+
+function parseDecision(answer) {
+  const value = answer.trim().toLowerCase();
+  if (value === '' || value === 'ok' || value === 'y' || value === 'yes' || value === 's' || value === 'sim') {
+    return 'approved';
+  }
+  if (value === 'a' || value === 'ajustes' || value === 'ajuste' || value === 'adjust') {
+    return 'needs-adjustments';
+  }
+  if (value === 'skip' || value === 'n' || value === 'no') {
+    return 'skipped';
+  }
+  return null;
+}
+
+async function askReviewDecision() {
+  if (!process.stdin.isTTY) {
+    return { status: 'skipped', feedback: null };
+  }
+
+  const rl = readline.createInterface({ input, output });
+  try {
+    console.log('');
+    console.log('Project review generated. Please review now:');
+    console.log(`- ./${REVIEW_FILE}`);
+    console.log('');
+    console.log('Type:');
+    console.log('  Enter / ok  -> approve');
+    console.log('  ajustes / a -> request adjustments');
+    console.log('  skip / n    -> skip this step');
+    console.log('');
+
+    let answer = await rl.question('> ');
+    let status = parseDecision(answer);
+    while (status === null) {
+      console.log('Invalid option. Use Enter, ok, ajustes, a, skip, or n.');
+      answer = await rl.question('> ');
+      status = parseDecision(answer);
+    }
+
+    if (status !== 'needs-adjustments') {
+      return { status, feedback: null };
+    }
+
+    console.log('');
+    const feedback = await rl.question('Describe the adjustments you want in this review: ');
+    return { status, feedback: feedback.trim() || null };
+  } finally {
+    rl.close();
+  }
+}
+
+export async function runInitialProjectReviewAgent(baseDir = process.cwd(), argv = process.argv.slice(2)) {
+  const files = listFiles(baseDir, baseDir);
+  const purpose = inferPurpose(baseDir);
+  const technologies = detectTechnologies(baseDir, files);
+  const coreAreas = pickCoreAreas(files);
+  const keyFiles = pickKeyFiles(files);
+  const report = buildReport({ purpose, technologies, coreAreas, keyFiles });
+
+  writeFile(baseDir, REVIEW_FILE, report);
+  printReviewSummary({ purpose, technologies, coreAreas, reportPath: REVIEW_FILE });
+
+  if (argv.includes('-y') || argv.includes('--yes') || argv.includes('--no-review-prompt')) {
+    writeFile(
+      baseDir,
+      REVIEW_STATUS_FILE,
+      JSON.stringify({ status: 'approved', decidedAt: new Date().toISOString(), feedback: null }, null, 2) + '\n'
+    );
+    console.log(`✅ Initial review approved automatically: ${REVIEW_FILE}`);
+    return { status: 'approved', reportPath: REVIEW_FILE };
+  }
+
+  const decision = await askReviewDecision();
+  writeFile(
+    baseDir,
+    REVIEW_STATUS_FILE,
+    JSON.stringify(
+      {
+        status: decision.status,
+        decidedAt: new Date().toISOString(),
+        feedback: decision.feedback
+      },
+      null,
+      2
+    ) + '\n'
+  );
+
+  if (decision.feedback) {
+    writeFile(
+      baseDir,
+      REVIEW_FEEDBACK_FILE,
+      `# Project Review Feedback\n\n${decision.feedback}\n`
+    );
+  }
+
+  if (decision.status === 'approved') {
+    console.log(`✅ Initial review approved: ${REVIEW_FILE}`);
+  } else if (decision.status === 'needs-adjustments') {
+    console.log(`📝 Adjustments requested and saved: ${REVIEW_FEEDBACK_FILE}`);
+  } else {
+    console.log('⏭️ Initial project review was skipped.');
+  }
+
+  return { status: decision.status, reportPath: REVIEW_FILE };
+}