@pcoliveira90/pdd 0.2.6 → 0.3.0

package/src/ai/run-fix-analysis.js

@@ -1,174 +1,174 @@
-import { buildBugfixPrompt } from './analyze-change.js';
-import { getAiProviderConfig } from './engine.js';
-
-function extractArgValue(args, name, fallback = null) {
-  const prefix = `${name}=`;
-  const direct = args.find(arg => arg.startsWith(prefix));
-  if (direct) return direct.slice(prefix.length);
-
-  const index = args.findIndex(arg => arg === name);
-  if (index >= 0 && args[index + 1]) return args[index + 1];
-
-  return fallback;
-}
-
-function getIssueFromArgs(args) {
-  const filtered = args.filter(arg => !arg.startsWith('--provider') && !arg.startsWith('--model') && arg !== 'fix' && arg !== '--ai');
-  return filtered.join(' ').trim();
-}
-
-function buildStructuredInstruction() {
-  return [
-    'Return valid JSON only.',
-    'Use exactly these keys:',
-    '{',
-    '  "root_cause_hypothesis": string,',
-    '  "impacted_areas": string[],',
-    '  "minimal_safe_delta": string,',
-    '  "regression_risks": string[],',
-    '  "validation_plan": string[]',
-    '}'
-  ].join('\n');
-}
-
-async function callOpenAI({ prompt, model, apiKey, baseUrl }) {
-  const response = await fetch(`${baseUrl}/chat/completions`, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: `Bearer ${apiKey}`
-    },
-    body: JSON.stringify({
-      model,
-      temperature: 0.2,
-      messages: [
-        { role: 'system', content: buildStructuredInstruction() },
-        { role: 'user', content: prompt }
-      ]
-    })
-  });
-
-  if (!response.ok) {
-    const text = await response.text();
-    throw new Error(`OpenAI request failed (${response.status}): ${text}`);
-  }
-
-  const data = await response.json();
-  return data.choices?.[0]?.message?.content ?? '';
-}
-
-async function callClaude({ prompt, model, apiKey, baseUrl }) {
-  const response = await fetch(`${baseUrl}/messages`, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      'x-api-key': apiKey,
-      'anthropic-version': '2023-06-01'
-    },
-    body: JSON.stringify({
-      model,
-      max_tokens: 1200,
-      temperature: 0.2,
-      system: buildStructuredInstruction(),
-      messages: [
-        { role: 'user', content: prompt }
-      ]
-    })
-  });
-
-  if (!response.ok) {
-    const text = await response.text();
-    throw new Error(`Claude request failed (${response.status}): ${text}`);
-  }
-
-  const data = await response.json();
-  return data.content?.[0]?.text ?? '';
-}
-
-async function callOpenRouter({ prompt, model, apiKey, baseUrl }) {
-  const response = await fetch(`${baseUrl}/chat/completions`, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: `Bearer ${apiKey}`,
-      'HTTP-Referer': 'https://github.com/pcoliveira90/pdd',
-      'X-Title': 'PDD CLI'
-    },
-    body: JSON.stringify({
-      model,
-      temperature: 0.2,
-      messages: [
-        { role: 'system', content: buildStructuredInstruction() },
-        { role: 'user', content: prompt }
-      ]
-    })
-  });
-
-  if (!response.ok) {
-    const text = await response.text();
-    throw new Error(`OpenRouter request failed (${response.status}): ${text}`);
-  }
-
-  const data = await response.json();
-  return data.choices?.[0]?.message?.content ?? '';
-}
-
-function resolveBaseUrl(providerConfig) {
-  const envValue = process.env[providerConfig.baseUrlEnv];
-  if (envValue) return envValue;
-
-  if (providerConfig.name === 'openai') return 'https://api.openai.com/v1';
-  if (providerConfig.name === 'claude') return 'https://api.anthropic.com/v1';
-  if (providerConfig.name === 'openrouter') return 'https://openrouter.ai/api/v1';
-
-  throw new Error(`Missing base URL for provider: ${providerConfig.name}`);
-}
-
-function parseJsonSafely(text) {
-  try {
-    return JSON.parse(text);
-  } catch {
-    return {
-      raw_output: text
-    };
-  }
-}
-
-export async function runAiFixAnalysis(argv = process.argv.slice(2)) {
-  const provider = extractArgValue(argv, '--provider', 'openai');
-  const providerConfig = getAiProviderConfig(provider);
-  const model = extractArgValue(argv, '--model', providerConfig.defaultModel);
-  const issue = getIssueFromArgs(argv);
-
-  if (!issue) {
-    throw new Error('Missing issue description. Example: pdd fix --ai "login not saving incomeStatus"');
-  }
-
-  const apiKey = process.env[providerConfig.envKey];
-  if (!apiKey) {
-    throw new Error(`Missing API key. Set ${providerConfig.envKey}.`);
-  }
-
-  const baseUrl = resolveBaseUrl(providerConfig);
-  const prompt = buildBugfixPrompt({ issue });
-
-  let raw;
-  if (provider === 'openai') {
-    raw = await callOpenAI({ prompt, model, apiKey, baseUrl });
-  } else if (provider === 'claude') {
-    raw = await callClaude({ prompt, model, apiKey, baseUrl });
-  } else if (provider === 'openrouter') {
-    raw = await callOpenRouter({ prompt, model, apiKey, baseUrl });
-  } else {
-    throw new Error(`Unsupported provider: ${provider}`);
-  }
-
-  const parsed = parseJsonSafely(raw);
-
-  return {
-    provider,
-    model,
-    issue,
-    result: parsed
-  };
-}
+import { buildBugfixPrompt } from './analyze-change.js';
+import { getAiProviderConfig } from './engine.js';
+
+function extractArgValue(args, name, fallback = null) {
+  const prefix = `${name}=`;
+  const direct = args.find(arg => arg.startsWith(prefix));
+  if (direct) return direct.slice(prefix.length);
+
+  const index = args.findIndex(arg => arg === name);
+  if (index >= 0 && args[index + 1]) return args[index + 1];
+
+  return fallback;
+}
+
+function getIssueFromArgs(args) {
+  const filtered = args.filter(arg => !arg.startsWith('--provider') && !arg.startsWith('--model') && arg !== 'fix' && arg !== '--ai');
+  return filtered.join(' ').trim();
+}
+
+function buildStructuredInstruction() {
+  return [
+    'Return valid JSON only.',
+    'Use exactly these keys:',
+    '{',
+    '  "root_cause_hypothesis": string,',
+    '  "impacted_areas": string[],',
+    '  "minimal_safe_delta": string,',
+    '  "regression_risks": string[],',
+    '  "validation_plan": string[]',
+    '}'
+  ].join('\n');
+}
+
+async function callOpenAI({ prompt, model, apiKey, baseUrl }) {
+  const response = await fetch(`${baseUrl}/chat/completions`, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${apiKey}`
+    },
+    body: JSON.stringify({
+      model,
+      temperature: 0.2,
+      messages: [
+        { role: 'system', content: buildStructuredInstruction() },
+        { role: 'user', content: prompt }
+      ]
+    })
+  });
+
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`OpenAI request failed (${response.status}): ${text}`);
+  }
+
+  const data = await response.json();
+  return data.choices?.[0]?.message?.content ?? '';
+}
+
+async function callClaude({ prompt, model, apiKey, baseUrl }) {
+  const response = await fetch(`${baseUrl}/messages`, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'x-api-key': apiKey,
+      'anthropic-version': '2023-06-01'
+    },
+    body: JSON.stringify({
+      model,
+      max_tokens: 1200,
+      temperature: 0.2,
+      system: buildStructuredInstruction(),
+      messages: [
+        { role: 'user', content: prompt }
+      ]
+    })
+  });
+
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`Claude request failed (${response.status}): ${text}`);
+  }
+
+  const data = await response.json();
+  return data.content?.[0]?.text ?? '';
+}
+
+async function callOpenRouter({ prompt, model, apiKey, baseUrl }) {
+  const response = await fetch(`${baseUrl}/chat/completions`, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${apiKey}`,
+      'HTTP-Referer': 'https://github.com/pcoliveira90/pdd',
+      'X-Title': 'PDD CLI'
+    },
+    body: JSON.stringify({
+      model,
+      temperature: 0.2,
+      messages: [
+        { role: 'system', content: buildStructuredInstruction() },
+        { role: 'user', content: prompt }
+      ]
+    })
+  });
+
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`OpenRouter request failed (${response.status}): ${text}`);
+  }
+
+  const data = await response.json();
+  return data.choices?.[0]?.message?.content ?? '';
+}
+
+function resolveBaseUrl(providerConfig) {
+  const envValue = process.env[providerConfig.baseUrlEnv];
+  if (envValue) return envValue;
+
+  if (providerConfig.name === 'openai') return 'https://api.openai.com/v1';
+  if (providerConfig.name === 'claude') return 'https://api.anthropic.com/v1';
+  if (providerConfig.name === 'openrouter') return 'https://openrouter.ai/api/v1';
+
+  throw new Error(`Missing base URL for provider: ${providerConfig.name}`);
+}
+
+function parseJsonSafely(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return {
+      raw_output: text
+    };
+  }
+}
+
+export async function runAiFixAnalysis(argv = process.argv.slice(2)) {
+  const provider = extractArgValue(argv, '--provider', 'openai');
+  const providerConfig = getAiProviderConfig(provider);
+  const model = extractArgValue(argv, '--model', providerConfig.defaultModel);
+  const issue = getIssueFromArgs(argv);
+
+  if (!issue) {
+    throw new Error('Missing issue description. Example: pdd fix --ai "login not saving incomeStatus"');
+  }
+
+  const apiKey = process.env[providerConfig.envKey];
+  if (!apiKey) {
+    throw new Error(`Missing API key. Set ${providerConfig.envKey}.`);
+  }
+
+  const baseUrl = resolveBaseUrl(providerConfig);
+  const prompt = buildBugfixPrompt({ issue });
+
+  let raw;
+  if (provider === 'openai') {
+    raw = await callOpenAI({ prompt, model, apiKey, baseUrl });
+  } else if (provider === 'claude') {
+    raw = await callClaude({ prompt, model, apiKey, baseUrl });
+  } else if (provider === 'openrouter') {
+    raw = await callOpenRouter({ prompt, model, apiKey, baseUrl });
+  } else {
+    throw new Error(`Unsupported provider: ${provider}`);
+  }
+
+  const parsed = parseJsonSafely(raw);
+
+  return {
+    provider,
+    model,
+    issue,
+    result: parsed
+  };
+}

package/src/cli/doctor-command.js

@@ -1,101 +1,123 @@
-import fs from 'fs';
-import path from 'path';
-import { PDD_TEMPLATE_VERSION } from '../core/template-registry.js';
-import { runDoctorFix } from './doctor-fix.js';
-import { buildDoctorRemediationPlan, printDoctorRemediationPlan } from '../core/remediation-advisor.js';
-
-function exists(baseDir, relativePath) {
-  return fs.existsSync(path.join(baseDir, relativePath));
-}
-
-function readVersion(baseDir) {
-  const file = path.join(baseDir, '.pdd/version.json');
-  if (!fs.existsSync(file)) return null;
-
-  try {
-    return JSON.parse(fs.readFileSync(file, 'utf-8')).templateVersion;
-  } catch {
-    return null;
-  }
-}
-
-function print(label, ok, detail = '') {
-  const icon = ok ? '✅' : '⚠️';
-  console.log(`${icon} ${label}${detail ? ` — ${detail}` : ''}`);
-}
-
-export function runDoctor(baseDir = process.cwd(), argv = []) {
-  const shouldFix = argv.includes('--fix');
-
-  console.log('🩺 PDD Doctor\n');
-
-  const coreChecks = {
-    constitution: exists(baseDir, '.pdd/constitution.md'),
-    delta: exists(baseDir, '.pdd/templates/delta-spec.md'),
-    patch: exists(baseDir, '.pdd/templates/patch-plan.md'),
-    verification: exists(baseDir, '.pdd/templates/verification-report.md'),
-    memory: exists(baseDir, '.pdd/memory/system-map.md')
-  };
-
-  const adapters = {
-    claude: exists(baseDir, '.claude/commands/pdd.md'),
-    cursor: exists(baseDir, '.cursor/pdd.prompt.md'),
-    copilot: exists(baseDir, '.github/copilot/pdd.prompt.md')
-  };
-
-  const installedVersion = readVersion(baseDir);
-
-  // Raw checks
-  print('Core constitution', coreChecks.constitution);
-  print('Delta spec', coreChecks.delta);
-  print('Patch plan', coreChecks.patch);
-  print('Verification report', coreChecks.verification);
-  print('System map', coreChecks.memory);
-
-  console.log('');
-
-  print('Claude adapter', adapters.claude, adapters.claude ? 'installed' : 'missing');
-  print('Cursor adapter', adapters.cursor, adapters.cursor ? 'installed' : 'missing');
-  print('Copilot adapter', adapters.copilot, adapters.copilot ? 'installed' : 'missing');
-
-  console.log('');
-
-  if (!installedVersion) {
-    console.log('⚠️ No template version detected. Run `pdd init --here --force`.');
-  } else if (installedVersion !== PDD_TEMPLATE_VERSION) {
-    console.log(`⚠️ Templates outdated (${installedVersion} → ${PDD_TEMPLATE_VERSION})`);
-    console.log('👉 Run: pdd init --here --upgrade');
-  } else {
-    console.log('🎉 Templates up to date');
-  }
-
-  if (!adapters.claude && !adapters.cursor && !adapters.copilot) {
-    console.log('ℹ️ No IDE adapters installed');
-    console.log('👉 Run: pdd init --here --ide=claude (or cursor/copilot)');
-  }
-
-  // Guided remediation
-  const plan = buildDoctorRemediationPlan({
-    coreChecks,
-    adapters,
-    installedVersion,
-    currentVersion: PDD_TEMPLATE_VERSION
-  });
-
-  printDoctorRemediationPlan(plan);
-
-  if (shouldFix) {
-    console.log('');
-    const result = runDoctorFix(baseDir);
-
-    if (result.changed) {
-      console.log('🔧 Auto-repair applied:');
-      result.repaired.forEach(file => console.log(`- fixed: ${file}`));
-      if (result.installedVersion && result.installedVersion !== result.currentVersion) {
-        console.log(`ℹ️ Version updated: ${result.installedVersion} → ${result.currentVersion}`);
-      }
-    } else {
-      console.log('✅ No fixes needed');
-    }
-  }
-}
+import fs from 'fs';
+import path from 'path';
+import { PDD_TEMPLATE_VERSION } from '../core/template-registry.js';
+import { runDoctorFix } from './doctor-fix.js';
+import { buildDoctorRemediationPlan, printDoctorRemediationPlan } from '../core/remediation-advisor.js';
+
+function exists(baseDir, relativePath) {
+  return fs.existsSync(path.join(baseDir, relativePath));
+}
+
+function cursorAdapterInstalled(baseDir) {
+  return (
+    exists(baseDir, '.cursor/rules/pdd.mdc') ||
+    exists(baseDir, '.cursor/commands/pdd.md') ||
+    exists(baseDir, '.cursor/pdd.prompt.md')
+  );
+}
+
+function claudeAdapterInstalled(baseDir) {
+  return (
+    exists(baseDir, '.claude/commands/pdd.md') ||
+    exists(baseDir, '.claude/CLAUDE.md')
+  );
+}
+
+function copilotAdapterInstalled(baseDir) {
+  return (
+    exists(baseDir, '.github/copilot/pdd.prompt.md') ||
+    exists(baseDir, '.github/copilot-instructions.md')
+  );
+}
+
+function readVersion(baseDir) {
+  const file = path.join(baseDir, '.pdd/version.json');
+  if (!fs.existsSync(file)) return null;
+
+  try {
+    return JSON.parse(fs.readFileSync(file, 'utf-8')).templateVersion;
+  } catch {
+    return null;
+  }
+}
+
+function print(label, ok, detail = '') {
+  const icon = ok ? '✅' : '⚠️';
+  console.log(`${icon} ${label}${detail ? ` — ${detail}` : ''}`);
+}
+
+export function runDoctor(baseDir = process.cwd(), argv = []) {
+  const shouldFix = argv.includes('--fix');
+
+  console.log('🩺 PDD Doctor\n');
+
+  const coreChecks = {
+    constitution: exists(baseDir, '.pdd/constitution.md'),
+    delta: exists(baseDir, '.pdd/templates/delta-spec.md'),
+    patch: exists(baseDir, '.pdd/templates/patch-plan.md'),
+    verification: exists(baseDir, '.pdd/templates/verification-report.md'),
+    memory: exists(baseDir, '.pdd/memory/system-map.md')
+  };
+
+  const adapters = {
+    claude: claudeAdapterInstalled(baseDir),
+    cursor: cursorAdapterInstalled(baseDir),
+    copilot: copilotAdapterInstalled(baseDir)
+  };
+
+  const installedVersion = readVersion(baseDir);
+
+  // Raw checks
+  print('Core constitution', coreChecks.constitution);
+  print('Delta spec', coreChecks.delta);
+  print('Patch plan', coreChecks.patch);
+  print('Verification report', coreChecks.verification);
+  print('System map', coreChecks.memory);
+
+  console.log('');
+
+  print('Claude adapter', adapters.claude, adapters.claude ? 'installed' : 'missing');
+  print('Cursor adapter', adapters.cursor, adapters.cursor ? 'installed' : 'missing');
+  print('Copilot adapter', adapters.copilot, adapters.copilot ? 'installed' : 'missing');
+
+  console.log('');
+
+  if (!installedVersion) {
+    console.log('⚠️ No template version detected. Run `pdd init --here --force`.');
+  } else if (installedVersion !== PDD_TEMPLATE_VERSION) {
+    console.log(`⚠️ Templates outdated (${installedVersion} → ${PDD_TEMPLATE_VERSION})`);
+    console.log('👉 Run: pdd init --here --upgrade');
+  } else {
+    console.log('🎉 Templates up to date');
+  }
+
+  if (!adapters.claude && !adapters.cursor && !adapters.copilot) {
+    console.log('ℹ️ No IDE adapters installed');
+    console.log('👉 Run: pdd init --here --ide=claude (or cursor/copilot)');
+  }
+
+  // Guided remediation
+  const plan = buildDoctorRemediationPlan({
+    coreChecks,
+    adapters,
+    installedVersion,
+    currentVersion: PDD_TEMPLATE_VERSION
+  });
+
+  printDoctorRemediationPlan(plan);
+
+  if (shouldFix) {
+    console.log('');
+    const result = runDoctorFix(baseDir);
+
+    if (result.changed) {
+      console.log('🔧 Auto-repair applied:');
+      result.repaired.forEach(file => console.log(`- fixed: ${file}`));
+      if (result.installedVersion && result.installedVersion !== result.currentVersion) {
+        console.log(`ℹ️ Version updated: ${result.installedVersion} → ${result.currentVersion}`);
+      }
+    } else {
+      console.log('✅ No fixes needed');
+    }
+  }
+}