r2pde-ai 0.1.5 → 0.1.6

package/ONBOARDING-QUICKSTART.md

@@ -1,3 +1,12 @@
+# Scaffold
+
+O comando `scaffold-create` exige o parâmetro `--guide <yaml>`, que deve apontar para um arquivo YAML na raiz do projeto. O comando `init` copia automaticamente um `scaffold.yaml` de exemplo para a raiz do projeto.
+
+Exemplo:
+
+```sh
+r2pde-ai scaffold-create --guide ./scaffold.yaml
+```
 # Corporate Agenda Quickstart Guide
 
 > **Build a Professional Corporate Agenda App with User Management and Calendar Sync (Outlook & Google) using r2pde-ai**

package/README.md

@@ -401,13 +401,22 @@ See [LICENSE](./LICENSE) for full terms.
 Você pode gerar automaticamente um projeto de exemplo baseado no arquivo de guia (por padrão ONBOARDING-QUICKSTART.md) usando:
 
 ```bash
-r2pde-ai scaffold-from-guide
+r2pde-ai scaffold-create --guide ./scaffold.yaml
 ```
 
 Ou especificar um guia e pasta de destino personalizados:
 
 ```bash
-r2pde-ai scaffold-from-guide --guide ./meu-guia.md --dest ./meu-projeto-exemplo
+r2pde-ai scaffold-create --guide ./meu-guia.yaml
+## Scaffold
+
+O comando `scaffold-create` agora exige explicitamente o parâmetro `--guide <yaml>`, que deve apontar para um arquivo YAML na raiz do projeto. O comando `init` copia automaticamente um `scaffold.yaml` de exemplo para a raiz do projeto. Edite esse arquivo conforme necessário para gerar scaffolds customizados.
+
+Exemplo de uso:
+
+```sh
+r2pde-ai scaffold-create --guide ./scaffold.yaml
+```
 ```
 
 Isso executa todos os comandos do guia, preenchendo automaticamente os prompts, e gera uma estrutura pronta para testes, onboarding ou demonstração.

package/dist/src/commands/init.js

@@ -167,8 +167,7 @@ export async function initCommand() {
 - r2pde-ai: 0.1.0
 `;
     fs.writeFileSync(paths.index, indexContent, { encoding: 'utf8' });
-    // Step 6 � Copy templates
-    // Corrigir caminho dos templates para dist/templates
+    // Step 6 – Copy templates and scaffold.yaml to project root
     const templateFiles = [
         { src: path.resolve(__dirname, '../../templates/manifest.template.md'), dest: path.resolve(paths.templates, 'manifest.template.md') },
         { src: path.resolve(__dirname, '../../templates/contract.template.md'), dest: path.resolve(paths.templates, 'contract.template.md') },
@@ -177,6 +176,19 @@ export async function initCommand() {
     for (const { src, dest } of templateFiles) {
         fs.copyFileSync(src, dest);
     }
+    // Copy scaffold.yaml from dist/templates (if built) or templates (dev) to project root
+    let scaffoldSrc = path.resolve(__dirname, '../../dist/templates/scaffold.yaml');
+    if (!fs.existsSync(scaffoldSrc)) {
+        scaffoldSrc = path.resolve(__dirname, '../../templates/scaffold.yaml');
+    }
+    const scaffoldDest = path.resolve(cwd, 'scaffold.yaml');
+    if (!fs.existsSync(scaffoldDest)) {
+        fs.copyFileSync(scaffoldSrc, scaffoldDest);
+        logInfo('Arquivo scaffold.yaml copiado para a raiz do projeto. Edite conforme necessário para usar o scaffold-create.');
+    }
+    else {
+        logWarn('Arquivo scaffold.yaml já existe na raiz do projeto. Não sobrescrito.');
+    }
     const guideContent = [
         '# r2pde-ai GUIDE',
         '',

package/dist/src/commands/scaffold-create.js

@@ -144,29 +144,15 @@ function copyFolderRecursiveSync(source, target) {
     }
 }
 export const scaffoldCreateCommand = new Command('scaffold-create')
-    .description('Gera um projeto de exemplo a partir de um arquivo de guia YAML')
-    .option('--guide <yaml>', 'Caminho para o arquivo de guia YAML (busca automática se não especificado)')
+    .description('Gera um projeto de exemplo a partir de um arquivo de guia YAML. Se --guide não for informado, será usado ./scaffold.yaml da raiz do projeto.')
+    .option('--guide <yaml>', 'Caminho para o arquivo de guia YAML (opcional, padrão: ./scaffold.yaml na raiz do projeto)')
     .action((opts) => {
-    const candidates = [];
-    if (opts.guide) {
-        candidates.push(path.resolve(opts.guide));
-    }
-    else {
-        // Caminho relativo ao CLI instalado globalmente
-        let cliDir = path.dirname(new URL(import.meta.url).pathname);
-        if (process.platform === 'win32' && cliDir.startsWith('/')) {
-            cliDir = cliDir.slice(1);
-        }
-        candidates.push(path.resolve(process.cwd(), 'scaffold-guide.yaml'), path.resolve(cliDir, '../../scaffold-guide.yaml'), path.resolve(cliDir, '../scaffold-guide.yaml'));
-    }
-    const foundPath = candidates.find(f => f && fs.existsSync(f));
-    if (!foundPath) {
-        console.error('Arquivo scaffold-guide.yaml não encontrado em nenhum local padrão. Caminhos testados:');
-        candidates.forEach(f => console.error(' - ' + f));
+    let guidePath = opts.guide ? path.resolve(opts.guide) : path.resolve(process.cwd(), 'scaffold.yaml');
+    if (!fs.existsSync(guidePath)) {
+        console.error('Arquivo YAML não encontrado: ' + guidePath + '\nInforme --guide <yaml> ou rode o comando init para gerar um scaffold.yaml de exemplo.');
         process.exit(1);
     }
-    opts.guide = foundPath;
-    scaffoldCreateHandler(opts).catch((err) => {
+    scaffoldCreateHandler({ guide: guidePath }).catch((err) => {
         console.error(err);
         process.exit(1);
     });

package/dist/templates/scaffold.yaml

@@ -0,0 +1,26 @@
+project:
+  name: Example Project
+  root: scaffold_done
+  description: |
+    Example YAML for r2pde-ai scaffold. Replace with your project details.
+  steps:
+    - type: mkdir
+      path: .r2pde-ai
+      comment: Create config folder.
+    - type: cli
+      command: npm init -y
+      comment: Initialize npm.
+    - type: git-init
+      comment: Initialize git repo.
+    - type: cli
+      command: npx r2pde-ai init
+      answers:
+        - Example Project
+        - Micro SaaS
+        - Monolith
+        - Clean Code
+        - MVP
+        - English
+      comment: Run r2pde-ai init with defaults.
+  files:
+    - README.md

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "r2pde-ai",
-    "version": "0.1.5",
+    "version": "0.1.6",
     "description": "Pilot Driven Engineering — A CLI framework that bridges the gap between architectural intent and AI-generated code.",
     "license": "MIT",
     "main": "dist/index.js",
@@ -44,6 +44,7 @@
     },
     "files": [
         "dist",
+        "templates",
         "README.md",
         "LICENSE",
         "CHANGELOG.md",

package/templates/contract.template.md

@@ -0,0 +1,13 @@
+# Contract: {{name}}
+
+## Description
+{{description}}
+
+## Details
+- Owner: {{owner}}
+- Date: {{date}}
+
+---
+
+## Terms
+{{terms}}

package/templates/manifest.template.md

@@ -0,0 +1,13 @@
+# Manifest: {{name}}
+
+## Purpose
+{{purpose}}
+
+## Scope
+{{scope}}
+
+---
+
+## Metadata
+- Created: {{date}}
+- Author: {{author}}

package/templates/requirement.template.md

@@ -0,0 +1,12 @@
+# Requirement: {{name}}
+
+## Description
+{{description}}
+
+## Acceptance Criteria
+- [ ] {{criteria}}
+
+---
+
+## Notes
+{{notes}}

package/templates/scaffold.yaml

@@ -0,0 +1,26 @@
+project:
+  name: Example Project
+  root: scaffold_done
+  description: |
+    Example YAML for r2pde-ai scaffold. Replace with your project details.
+  steps:
+    - type: mkdir
+      path: .r2pde-ai
+      comment: Create config folder.
+    - type: cli
+      command: npm init -y
+      comment: Initialize npm.
+    - type: git-init
+      comment: Initialize git repo.
+    - type: cli
+      command: npx r2pde-ai init
+      answers:
+        - Example Project
+        - Micro SaaS
+        - Monolith
+        - Clean Code
+        - MVP
+        - English
+      comment: Run r2pde-ai init with defaults.
+  files:
+    - README.md