@pcoliveira90/pdd 0.2.6 → 0.3.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Paula Oliveira
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) 2026 Paula Oliveira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.

package/README.en.md

@@ -1,60 +1,60 @@
-# PDD — Patch-Driven Development
-![npm](https://img.shields.io/npm/v/@pcoliveira90/pdd)
-![license](https://img.shields.io/github/license/pcoliveira90/pdd)
-![stars](https://img.shields.io/github/stars/pcoliveira90/pdd)
-![issues](https://img.shields.io/github/issues/pcoliveira90/pdd)
-> Ship safe changes in living systems.
-
-PDD is an open-source framework focused on **bugfixes and incremental feature development in existing systems**.
-
----
-
-## The Problem
-
-Most development is not greenfield.
-
-It is:
-- fixing bugs in production
-- evolving legacy systems
-- adding features without breaking things
-
----
-
-## The Solution: PDD
-
-PDD focuses on:
-- understanding existing systems
-- identifying root causes
-- applying minimal safe changes
-- validating with evidence
-
----
-
-## Core Flow
-
-Issue → Recon → Delta Spec → Patch Plan → Change → Verify
-
----
-
-## Principles
-
-- Change-first
-- Evidence before edit
-- Minimal safe delta
-- Root-cause over symptom patch
-- Regression-aware
-- Reuse existing patterns
-- Verifiable outcomes
-
----
-
-## Structure
-
-.pdd/
-examples/
-
----
-
-## Vision
-
-Make AI-assisted development safe for real-world systems.
+# PDD — Patch-Driven Development
+![npm](https://img.shields.io/npm/v/@pcoliveira90/pdd)
+![license](https://img.shields.io/github/license/pcoliveira90/pdd)
+![stars](https://img.shields.io/github/stars/pcoliveira90/pdd)
+![issues](https://img.shields.io/github/issues/pcoliveira90/pdd)
+> Ship safe changes in living systems.
+
+PDD is an open-source framework focused on **bugfixes and incremental feature development in existing systems**.
+
+---
+
+## The Problem
+
+Most development is not greenfield.
+
+It is:
+- fixing bugs in production
+- evolving legacy systems
+- adding features without breaking things
+
+---
+
+## The Solution: PDD
+
+PDD focuses on:
+- understanding existing systems
+- identifying root causes
+- applying minimal safe changes
+- validating with evidence
+
+---
+
+## Core Flow
+
+Issue → Recon → Delta Spec → Patch Plan → Change → Verify
+
+---
+
+## Principles
+
+- Change-first
+- Evidence before edit
+- Minimal safe delta
+- Root-cause over symptom patch
+- Regression-aware
+- Reuse existing patterns
+- Verifiable outcomes
+
+---
+
+## Structure
+
+.pdd/
+examples/
+
+---
+
+## Vision
+
+Make AI-assisted development safe for real-world systems.

package/README.md

@@ -1,26 +1,27 @@
-# PDD — Patch-Driven Development
-
-> Safe changes in real systems.
-
-PDD is a framework focused on executing safe changes in existing systems.
-
-## CLI
-
-```bash
-pdd init
-pdd fix "bug"
-pdd fix "bug" --dry-run
-pdd fix "bug" --no-validate
-pdd fix "bug" --open-pr
-```
-
-## Flow
-
-1. describe issue
-2. generate artifacts
-3. validate
-4. prepare PR (IDE handles opening)
-
-## Goal
-
-Reliable execution engine for safe software changes.
+# PDD — Patch-Driven Development
+
+> Safe changes in real systems.
+
+PDD is a framework focused on executing safe changes in existing systems.
+
+## CLI
+
+```bash
+pdd init
+pdd fix "bug"
+pdd fix "bug" --dry-run
+pdd fix "bug" --no-validate
+pdd fix "bug" --open-pr
+pdd-ai --provider=openai --task=analysis "bug"
+```
+
+## Flow
+
+1. describe issue
+2. generate artifacts
+3. validate
+4. prepare PR (IDE handles opening)
+
+## Goal
+
+Reliable execution engine for safe software changes.

package/README.pt-BR.md

@@ -1,12 +1,12 @@
-# PDD — Patch-Driven Development
-
-> Entregue mudanças seguras em sistemas existentes.
-
-PDD é um framework focado em aplicar mudanças seguras em sistemas reais.
-
-## CLI
-
-```bash
-pdd init
-pdd fix "bug"
-```
+# PDD — Patch-Driven Development
+
+> Entregue mudanças seguras em sistemas existentes.
+
+PDD é um framework focado em aplicar mudanças seguras em sistemas reais.
+
+## CLI
+
+```bash
+pdd init
+pdd fix "bug"
+```

package/bin/pdd-ai.js

@@ -1,23 +1,23 @@
-#!/usr/bin/env node
-
-import { runAiFixAnalysis } from '../src/ai/run-fix-analysis.js';
-
-async function main() {
-  try {
-    const result = await runAiFixAnalysis(process.argv.slice(2));
-
-    console.log('\n🤖 PDD AI Analysis');
-    console.log('----------------------');
-    console.log(`Provider: ${result.provider}`);
-    console.log(`Model: ${result.model}`);
-    console.log(`Issue: ${result.issue}`);
-    console.log('\nResult:\n');
-
-    console.log(JSON.stringify(result.result, null, 2));
-  } catch (err) {
-    console.error('❌ Error:', err.message);
-    process.exit(1);
-  }
-}
-
-main();
+#!/usr/bin/env node
+
+import { runAiFixAnalysis } from '../src/ai/run-fix-analysis.js';
+
+async function main() {
+  try {
+    const result = await runAiFixAnalysis(process.argv.slice(2));
+
+    console.log('\n🤖 PDD AI Analysis');
+    console.log('----------------------');
+    console.log(`Provider: ${result.provider}`);
+    console.log(`Model: ${result.model}`);
+    console.log(`Issue: ${result.issue}`);
+    console.log('\nResult:\n');
+
+    console.log(JSON.stringify(result.result, null, 2));
+  } catch (err) {
+    console.error('❌ Error:', err.message);
+    process.exit(1);
+  }
+}
+
+main();

package/bin/pdd-pro.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-
-import { runCli } from '../src/cli/index.js';
-
-runCli().catch(err => {
-  console.error(err);
-  process.exitCode = 1;
-});
+
+import { runCli } from '../src/cli/index.js';
+
+runCli().catch(err => {
+  console.error(err);
+  process.exitCode = 1;
+});

package/bin/pdd.js

@@ -1,27 +1,27 @@
-#!/usr/bin/env node
-
-import fs from 'fs';
-import path from 'path';
-
-const command = process.argv[2];
-
-if (command === 'init') {
-  const targetDir = process.cwd();
-  const pddDir = path.join(targetDir, '.pdd');
-
-  if (fs.existsSync(pddDir)) {
-    console.log('PDD already initialized.');
-    process.exit(0);
-  }
-
-  fs.mkdirSync(pddDir, { recursive: true });
-  fs.mkdirSync(path.join(pddDir, 'templates'));
-  fs.mkdirSync(path.join(pddDir, 'commands'));
-  fs.mkdirSync(path.join(pddDir, 'memory'));
-
-  fs.writeFileSync(path.join(pddDir, 'README.md'), 'PDD initialized');
-
-  console.log('✅ PDD initialized successfully.');
-} else {
-  console.log('Usage: pdd init');
-}
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+
+const command = process.argv[2];
+
+if (command === 'init') {
+  const targetDir = process.cwd();
+  const pddDir = path.join(targetDir, '.pdd');
+
+  if (fs.existsSync(pddDir)) {
+    console.log('PDD already initialized.');
+    process.exit(0);
+  }
+
+  fs.mkdirSync(pddDir, { recursive: true });
+  fs.mkdirSync(path.join(pddDir, 'templates'));
+  fs.mkdirSync(path.join(pddDir, 'commands'));
+  fs.mkdirSync(path.join(pddDir, 'memory'));
+
+  fs.writeFileSync(path.join(pddDir, 'README.md'), 'PDD initialized');
+
+  console.log('✅ PDD initialized successfully.');
+} else {
+  console.log('Usage: pdd init');
+}

package/package.json

@@ -1,42 +1,43 @@
-{
-  "name": "@pcoliveira90/pdd",
-  "version": "0.2.6",
-  "description": "Patch-Driven Development CLI — safe, resilient and guided code changes",
-  "type": "module",
-  "bin": {
-    "pdd": "bin/pdd-pro.js"
-  },
-  "files": [
-    "bin",
-    "src"
-  ],
-  "scripts": {
-    "start": "node bin/pdd-pro.js",
-    "dev": "node bin/pdd-pro.js",
-    "test": "echo \"No tests yet\"",
-    "lint": "echo \"No lint configured\"",
-    "prepublishOnly": "npm pack"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "keywords": [
-    "cli",
-    "developer-tools",
-    "patch",
-    "refactoring",
-    "ai-workflow",
-    "engineering",
-    "pdd"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/pcoliveira90/pdd.git"
-  },
-  "bugs": {
-    "url": "https://github.com/pcoliveira90/pdd/issues"
-  },
-  "homepage": "https://github.com/pcoliveira90/pdd#readme",
-  "author": "Paula Oliveira",
-  "license": "MIT"
-}
+{
+  "name": "@pcoliveira90/pdd",
+  "version": "0.3.0",
+  "description": "Patch-Driven Development CLI — safe, resilient and guided code changes",
+  "type": "module",
+  "bin": {
+    "pdd": "bin/pdd-pro.js",
+    "pdd-ai": "bin/pdd-ai.js"
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "scripts": {
+    "start": "node bin/pdd-pro.js",
+    "dev": "node bin/pdd-pro.js",
+    "test": "echo \"No tests yet\"",
+    "lint": "echo \"No lint configured\"",
+    "prepublishOnly": "npm pack"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "cli",
+    "developer-tools",
+    "patch",
+    "refactoring",
+    "ai-workflow",
+    "engineering",
+    "pdd"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pcoliveira90/pdd.git"
+  },
+  "bugs": {
+    "url": "https://github.com/pcoliveira90/pdd/issues"
+  },
+  "homepage": "https://github.com/pcoliveira90/pdd#readme",
+  "author": "Paula Oliveira",
+  "license": "MIT"
+}

package/src/ai/analyze-change.js

@@ -1,41 +1,41 @@
-import fs from 'fs';
-import path from 'path';
-
-function readIfExists(filePath) {
-  if (!fs.existsSync(filePath)) return null;
-  return fs.readFileSync(filePath, 'utf-8');
-}
-
-export function buildAiAnalysisContext(baseDir = process.cwd()) {
-  const context = {
-    constitution: readIfExists(path.join(baseDir, '.pdd', 'constitution.md')),
-    deltaSpec: readIfExists(path.join(baseDir, '.pdd', 'templates', 'delta-spec.md')),
-    patchPlan: readIfExists(path.join(baseDir, '.pdd', 'templates', 'patch-plan.md')),
-    verification: readIfExists(path.join(baseDir, '.pdd', 'templates', 'verification-report.md'))
-  };
-
-  return context;
-}
-
-export function buildBugfixPrompt({ issue, baseDir = process.cwd() }) {
-  const context = buildAiAnalysisContext(baseDir);
-
-  return [
-    'You are a senior engineer working in an existing system.',
-    'Follow Patch-Driven Development principles.',
-    'Focus on root cause, minimal safe delta, and regression awareness.',
-    '',
-    'Issue:',
-    issue,
-    '',
-    'Available context:',
-    JSON.stringify(context, null, 2),
-    '',
-    'Return:',
-    '- root cause hypothesis',
-    '- impacted areas',
-    '- minimal safe delta',
-    '- regression risks',
-    '- validation plan'
-  ].join('\n');
-}
+import fs from 'fs';
+import path from 'path';
+
+function readIfExists(filePath) {
+  if (!fs.existsSync(filePath)) return null;
+  return fs.readFileSync(filePath, 'utf-8');
+}
+
+export function buildAiAnalysisContext(baseDir = process.cwd()) {
+  const context = {
+    constitution: readIfExists(path.join(baseDir, '.pdd', 'constitution.md')),
+    deltaSpec: readIfExists(path.join(baseDir, '.pdd', 'templates', 'delta-spec.md')),
+    patchPlan: readIfExists(path.join(baseDir, '.pdd', 'templates', 'patch-plan.md')),
+    verification: readIfExists(path.join(baseDir, '.pdd', 'templates', 'verification-report.md'))
+  };
+
+  return context;
+}
+
+export function buildBugfixPrompt({ issue, baseDir = process.cwd() }) {
+  const context = buildAiAnalysisContext(baseDir);
+
+  return [
+    'You are a senior engineer working in an existing system.',
+    'Follow Patch-Driven Development principles.',
+    'Focus on root cause, minimal safe delta, and regression awareness.',
+    '',
+    'Issue:',
+    issue,
+    '',
+    'Available context:',
+    JSON.stringify(context, null, 2),
+    '',
+    'Return:',
+    '- root cause hypothesis',
+    '- impacted areas',
+    '- minimal safe delta',
+    '- regression risks',
+    '- validation plan'
+  ].join('\n');
+}

package/src/ai/engine.js

@@ -1,34 +1,34 @@
-export function getAiProviderConfig(provider = 'openai') {
-  const providers = {
-    openai: {
-      name: 'openai',
-      envKey: 'OPENAI_API_KEY',
-      baseUrlEnv: 'OPENAI_BASE_URL',
-      defaultModel: 'gpt-5'
-    },
-    claude: {
-      name: 'claude',
-      envKey: 'ANTHROPIC_API_KEY',
-      baseUrlEnv: 'ANTHROPIC_BASE_URL',
-      defaultModel: 'claude-sonnet-4-20250514'
-    },
-    openrouter: {
-      name: 'openrouter',
-      envKey: 'OPENROUTER_API_KEY',
-      baseUrlEnv: 'OPENROUTER_BASE_URL',
-      defaultModel: 'openai/gpt-4.1-mini'
-    }
-  };
-
-  const config = providers[provider];
-
-  if (!config) {
-    throw new Error(`Unsupported AI provider: ${provider}`);
-  }
-
-  return config;
-}
-
-export function listSupportedProviders() {
-  return ['openai', 'claude', 'openrouter'];
-}
+export function getAiProviderConfig(provider = 'openai') {
+  const providers = {
+    openai: {
+      name: 'openai',
+      envKey: 'OPENAI_API_KEY',
+      baseUrlEnv: 'OPENAI_BASE_URL',
+      defaultModel: 'gpt-5'
+    },
+    claude: {
+      name: 'claude',
+      envKey: 'ANTHROPIC_API_KEY',
+      baseUrlEnv: 'ANTHROPIC_BASE_URL',
+      defaultModel: 'claude-sonnet-4-20250514'
+    },
+    openrouter: {
+      name: 'openrouter',
+      envKey: 'OPENROUTER_API_KEY',
+      baseUrlEnv: 'OPENROUTER_BASE_URL',
+      defaultModel: 'openai/gpt-4.1-mini'
+    }
+  };
+
+  const config = providers[provider];
+
+  if (!config) {
+    throw new Error(`Unsupported AI provider: ${provider}`);
+  }
+
+  return config;
+}
+
+export function listSupportedProviders() {
+  return ['openai', 'claude', 'openrouter'];
+}