@pcoliveira90/pdd 0.2.5 → 0.3.0

package/src/cli/doctor-fix.js

@@ -1,51 +1,51 @@
-import fs from 'fs';
-import path from 'path';
-import { CORE_TEMPLATES, PDD_TEMPLATE_VERSION } from '../core/template-registry.js';
-
-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 readInstalledVersion(baseDir) {
-  const versionFile = path.join(baseDir, '.pdd/version.json');
-  if (!fs.existsSync(versionFile)) return null;
-
-  try {
-    return JSON.parse(fs.readFileSync(versionFile, 'utf-8')).templateVersion || null;
-  } catch {
-    return null;
-  }
-}
-
-function isCoreFile(relativePath) {
-  return relativePath.startsWith('.pdd/');
-}
-
-export function runDoctorFix(baseDir = process.cwd()) {
-  const installedVersion = readInstalledVersion(baseDir);
-  const repaired = [];
-
-  for (const [relativePath, content] of Object.entries(CORE_TEMPLATES)) {
-    const fullPath = path.join(baseDir, relativePath);
-    const missing = !fs.existsSync(fullPath);
-    const outdatedVersionFile = relativePath === '.pdd/version.json' && installedVersion !== PDD_TEMPLATE_VERSION;
-
-    if (isCoreFile(relativePath) && (missing || outdatedVersionFile)) {
-      writeFile(baseDir, relativePath, content);
-      repaired.push(relativePath);
-    }
-  }
-
-  return {
-    repaired,
-    installedVersion,
-    currentVersion: PDD_TEMPLATE_VERSION,
-    changed: repaired.length > 0
-  };
-}
+import fs from 'fs';
+import path from 'path';
+import { CORE_TEMPLATES, PDD_TEMPLATE_VERSION } from '../core/template-registry.js';
+
+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 readInstalledVersion(baseDir) {
+  const versionFile = path.join(baseDir, '.pdd/version.json');
+  if (!fs.existsSync(versionFile)) return null;
+
+  try {
+    return JSON.parse(fs.readFileSync(versionFile, 'utf-8')).templateVersion || null;
+  } catch {
+    return null;
+  }
+}
+
+function isCoreFile(relativePath) {
+  return relativePath.startsWith('.pdd/');
+}
+
+export function runDoctorFix(baseDir = process.cwd()) {
+  const installedVersion = readInstalledVersion(baseDir);
+  const repaired = [];
+
+  for (const [relativePath, content] of Object.entries(CORE_TEMPLATES)) {
+    const fullPath = path.join(baseDir, relativePath);
+    const missing = !fs.existsSync(fullPath);
+    const outdatedVersionFile = relativePath === '.pdd/version.json' && installedVersion !== PDD_TEMPLATE_VERSION;
+
+    if (isCoreFile(relativePath) && (missing || outdatedVersionFile)) {
+      writeFile(baseDir, relativePath, content);
+      repaired.push(relativePath);
+    }
+  }
+
+  return {
+    repaired,
+    installedVersion,
+    currentVersion: PDD_TEMPLATE_VERSION,
+    changed: repaired.length > 0
+  };
+}

package/src/cli/index.js

@@ -1,130 +1,164 @@
-import { readFileSync } from 'fs';
-import { dirname, join } from 'path';
-import { fileURLToPath } from 'url';
-import { runValidation } from '../core/validator.js';
-import { openPullRequest } from '../core/pr-manager.js';
-import { generatePatchArtifacts } from '../core/patch-generator.js';
-import { runInit } from './init-command.js';
-import { runDoctor } from './doctor-command.js';
-import { runStatus } from './status-command.js';
-import { runResilientFixWorkflow } from '../core/fix-runner.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-function readCliVersion() {
-  const pkgPath = join(__dirname, '../../package.json');
-  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
-  return pkg.version;
-}
-
-function parseFixArgs(argv) {
-  const issue = argv
-    .filter(arg => !arg.startsWith('--') && arg !== 'fix')
-    .join(' ')
-    .trim();
-
-  return {
-    issue,
-    openPr: argv.includes('--open-pr'),
-    dryRun: argv.includes('--dry-run'),
-    noValidate: argv.includes('--no-validate')
-  };
-}
-
-export async function runCli(argv = process.argv.slice(2)) {
-  const command = argv[0];
-  const cwd = process.cwd();
-
-  if (command === '--version' || command === '-v' || command === '-V' || command === 'version') {
-    console.log(readCliVersion());
-    return;
-  }
-
-  if (command === 'init') {
-    await runInit(argv);
-    return;
-  }
-
-  if (command === 'doctor') {
-    runDoctor(cwd, argv);
-    return;
-  }
-
-  if (command === 'status') {
-    runStatus(cwd);
-    return;
-  }
-
-  if (command === 'fix') {
-    const { issue, openPr, dryRun, noValidate } = parseFixArgs(argv);
-
-    if (!issue) {
-      console.error('❌ Missing issue description.');
-      console.log('Use: pdd fix "description" [--open-pr] [--dry-run] [--no-validate]');
-      process.exit(1);
-    }
-
-    console.log('🔧 PDD Fix Workflow');
-    console.log(`Issue: ${issue}`);
-    console.log(`Open PR prep: ${openPr ? 'yes' : 'no'}`);
-    console.log(`Dry run: ${dryRun ? 'yes' : 'no'}`);
-    console.log(`Validation: ${noValidate ? 'skipped' : 'enabled'}`);
-
-    try {
-      const result = await runResilientFixWorkflow({
-        baseDir: cwd,
-        issue,
-        dryRun,
-        noValidate,
-        openPr,
-        generatePatchArtifacts,
-        runValidation,
-        openPullRequest
-      });
-
-      if (result.status === 'dry-run') {
-        console.log('📝 Dry run only. No files created.');
-        return;
-      }
-
-      if (result.changeId) {
-        console.log(`Tracking change: ${result.changeId}`);
-      }
-
-      if (Array.isArray(result.files) && result.files.length > 0) {
-        console.log('🧩 Patch artifacts created:');
-        result.files.forEach(file => console.log(`- ${file}`));
-      }
-
-      console.log('✅ Fix workflow finished.');
-    } catch (error) {
-      console.error(`❌ ${error.message}`);
-      process.exitCode = 1;
-    }
-
-    return;
-  }
-
-  if (command === 'help' || !command) {
-    console.log(`PDD CLI ${readCliVersion()}`);
-    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 doctor [--fix]');
-    console.log('  pdd status');
-    console.log('  pdd fix "description" [--open-pr] [--dry-run] [--no-validate]');
-    console.log('  pdd version   (or: pdd --version, pdd -v)');
-    console.log('');
-    console.log('Examples:');
-    console.log('  pdd doctor --fix');
-    console.log('  pdd status');
-    console.log('  pdd init --here --upgrade');
-    console.log('  pdd fix "login not saving incomeStatus" --open-pr');
-    console.log('');
-    return;
-  }
-
-  console.log(`❌ Unknown command: ${command}`);
-  console.log('Use: pdd help');
-}
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { runValidation } from '../core/validator.js';
+import { openPullRequest } from '../core/pr-manager.js';
+import { generatePatchArtifacts } from '../core/patch-generator.js';
+import { runInit } from './init-command.js';
+import { runDoctor } from './doctor-command.js';
+import { runStatus } from './status-command.js';
+import { runResilientFixWorkflow } from '../core/fix-runner.js';
+import { enforceLinkedWorktree } from '../core/worktree-guard.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+function readCliVersion() {
+  const pkgPath = join(__dirname, '../../package.json');
+  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+  return pkg.version;
+}
+
+function parseFixArgs(argv) {
+  const issue = argv
+    .filter(arg => !arg.startsWith('--') && arg !== 'fix')
+    .join(' ')
+    .trim();
+
+  return {
+    issue,
+    openPr: argv.includes('--open-pr'),
+    dryRun: argv.includes('--dry-run'),
+    noValidate: argv.includes('--no-validate'),
+    allowMainWorktree: argv.includes('--allow-main-worktree')
+  };
+}
+
+export async function runCli(argv = process.argv.slice(2)) {
+  const command = argv[0];
+  const cwd = process.cwd();
+
+  if (command === '--version' || command === '-v' || command === '-V' || command === 'version') {
+    console.log(readCliVersion());
+    return;
+  }
+
+  if (command === 'init') {
+    const allowMainWorktree = argv.includes('--allow-main-worktree');
+    const mutatesCurrentRepo = argv.includes('--here') || argv.includes('--upgrade');
+    if (mutatesCurrentRepo) {
+      enforceLinkedWorktree({
+        baseDir: cwd,
+        commandName: 'init',
+        allowMainWorktree
+      });
+    }
+    await runInit(argv);
+    return;
+  }
+
+  if (command === 'doctor') {
+    const allowMainWorktree = argv.includes('--allow-main-worktree');
+    if (argv.includes('--fix')) {
+      enforceLinkedWorktree({
+        baseDir: cwd,
+        commandName: 'doctor --fix',
+        allowMainWorktree
+      });
+    }
+    runDoctor(cwd, argv);
+    return;
+  }
+
+  if (command === 'status') {
+    runStatus(cwd);
+    return;
+  }
+
+  if (command === 'fix') {
+    const { issue, openPr, dryRun, noValidate, allowMainWorktree } = parseFixArgs(argv);
+
+    if (!issue) {
+      console.error('❌ Missing issue description.');
+      console.log('Use: pdd fix "description" [--open-pr] [--dry-run] [--no-validate] [--allow-main-worktree]');
+      process.exit(1);
+    }
+
+    enforceLinkedWorktree({
+      baseDir: cwd,
+      commandName: 'fix',
+      allowMainWorktree
+    });
+
+    console.log('🔧 PDD Fix Workflow');
+    console.log(`Issue: ${issue}`);
+    console.log(`Open PR prep: ${openPr ? 'yes' : 'no'}`);
+    console.log(`Dry run: ${dryRun ? 'yes' : 'no'}`);
+    console.log(`Validation: ${noValidate ? 'skipped' : 'enabled'}`);
+
+    try {
+      const result = await runResilientFixWorkflow({
+        baseDir: cwd,
+        issue,
+        dryRun,
+        noValidate,
+        openPr,
+        generatePatchArtifacts,
+        runValidation,
+        openPullRequest
+      });
+
+      if (result.status === 'dry-run') {
+        console.log('📝 Dry run only. No files created.');
+        return;
+      }
+
+      if (result.changeId) {
+        console.log(`Tracking change: ${result.changeId}`);
+      }
+
+      if (Array.isArray(result.files) && result.files.length > 0) {
+        console.log('🧩 Patch artifacts created:');
+        result.files.forEach(file => console.log(`- ${file}`));
+      }
+
+      console.log('✅ Fix workflow finished.');
+    } catch (error) {
+      console.error(`❌ ${error.message}`);
+      process.exitCode = 1;
+    }
+
+    return;
+  }
+
+  if (command === 'help' || !command) {
+    console.log(`PDD CLI ${readCliVersion()}`);
+    console.log('');
+    console.log('Core commands:');
+    console.log('  pdd init <project-name>                                          Initialize PDD templates in a new folder');
+    console.log('  pdd init --here [--force] [--upgrade] [-y] [--no-ide-prompt]     Initialize or upgrade templates in current project');
+    console.log('      [--no-project-review] [--ide=claude|cursor|copilot|...]');
+    console.log('  pdd doctor [--fix]                                                Check installation health and optionally auto-repair');
+    console.log('  pdd status                                                        Show current change workflow state');
+    console.log('  pdd fix "description" [--open-pr] [--dry-run] [--no-validate]    Run fix workflow and generate artifacts');
+    console.log('  pdd version   (or: pdd --version, pdd -v)                        Show CLI version');
+    console.log('');
+    console.log('Worktree policy:');
+    console.log('  Mutating commands require linked git worktree by default.');
+    console.log('  Override intentionally with --allow-main-worktree.');
+    console.log('');
+    console.log('AI command (official binary):');
+    console.log('  pdd-ai [--provider=openai|claude|openrouter] [--task=analysis|build|test|review] [--model=<id>] "issue"');
+    console.log('');
+    console.log('Examples:');
+    console.log('  pdd doctor --fix');
+    console.log('  pdd status');
+    console.log('  pdd init --here --upgrade');
+    console.log('  pdd fix "login not saving incomeStatus" --open-pr');
+    console.log('  pdd-ai --provider=openai --task=analysis "login not saving incomeStatus"');
+    console.log('');
+    return;
+  }
+
+  console.log(`❌ Unknown command: ${command}`);
+  console.log('Use: pdd help');
+}