da-proj 1.0.0

package/src/commands/init.ts

@@ -0,0 +1,236 @@
+import { mkdir, writeFile, readFile } from "fs/promises";
+import { existsSync } from "fs";
+import { input, select } from "@inquirer/prompts";
+import type { ProjectMetadata } from "../types/index.js";
+import { log, colors } from "../utils/logger.js";
+import { generateMDX } from "../generators/mdx.js";
+import { generateWorkflow } from "../generators/workflow.js";
+import { generateReadme } from "../generators/readme.js";
+import { generateSchema } from "../generators/schema.js";
+
+export async function initCommand() {
+  log.title("🚀 Project Metadata Setup");
+
+  // Verificar que estamos en un repositorio git
+  if (!existsSync(".git")) {
+    log.error("Not a git repository. Please run this command in a git repository.");
+    process.exit(1);
+  }
+
+  // Recopilar información del proyecto
+  log.info("Let's set up your project metadata...\n");
+
+  const title = await input({ 
+    message: "Project title",
+    default: "My Awesome Project"
+  });
+  
+  const category = await input({ 
+    message: "Category",
+    default: "Web Development"
+  });
+  
+  const type = await select({ 
+    message: "Project type",
+    choices: [
+      { value: "small", name: "Small project" },
+      { value: "featured", name: "Featured project" }
+    ]
+  }) as "featured" | "small";
+  
+  const status = await select({ 
+    message: "Project status",
+    choices: [
+      { value: "in-progress", name: "In Progress" },
+      { value: "active", name: "Active" },
+      { value: "archived", name: "Archived" }
+    ]
+  }) as "active" | "archived" | "in-progress";
+  
+  const age = await input({ 
+    message: "Project age (optional)",
+    default: "+2 months"
+  });
+  
+  const demo = await input({ 
+    message: "Demo URL (optional)",
+    default: ""
+  });
+  
+  // Tecnologías - input múltiple
+  const techInput = await input({ 
+    message: "Technologies (comma separated)",
+    default: "React, TypeScript, Node.js"
+  });
+  const technologies = techInput.split(",").map(t => t.trim()).filter(Boolean);
+  
+  const coverImage = await input({ 
+    message: "Cover image path",
+    default: "/proj-images/cover.png"
+  });
+  
+  const galleryInput = await input({ 
+    message: "Gallery images (comma separated, optional)",
+    default: ""
+  });
+  const galleryImages = galleryInput ? galleryInput.split(",").map(t => t.trim()).filter(Boolean) : [];
+
+  let industry, timeline, details;
+  if (type === "featured") {
+    industry = await input({ 
+      message: "Industry",
+      default: "Technology"
+    });
+    
+    timeline = await input({ 
+      message: "Timeline",
+      default: "Still Working"
+    });
+    
+    const detailsInput = await input({ 
+      message: "Project details (comma separated)",
+      default: "Built with modern stack, Scalable architecture, Production ready"
+    });
+    details = detailsInput.split(",").map(t => t.trim()).filter(Boolean);
+  }
+
+  const metadata: ProjectMetadata = {
+    title,
+    category,
+    type,
+    status,
+    age: age || undefined,
+    demo: demo || undefined,
+    technologies,
+    images: {
+      cover: coverImage,
+      gallery: galleryImages,
+    },
+    industry,
+    timeline,
+    details,
+  };
+
+  // Contenido inicial del MDX
+  const mdxContent = `# ${title}
+
+## Description
+
+[Add your project description here]
+
+## Key Features
+
+- Feature 1
+- Feature 2
+- Feature 3
+
+## Challenges
+
+[Describe the technical challenges you faced]
+
+## Outcomes
+
+[What did you learn and achieve?]
+
+## Future Improvements
+
+- [ ] Improvement 1
+- [ ] Improvement 2
+`;
+
+  // Crear archivos
+  log.info("\nCreating files...");
+
+  try {
+    // .project-metadata.mdx
+    await writeFile(".project-metadata.mdx", generateMDX(metadata, mdxContent));
+    log.success("Created .project-metadata.mdx");
+
+    // .github/workflows/sync-portfolio.yml
+    await mkdir(".github/workflows", { recursive: true });
+    await writeFile(".github/workflows/sync-portfolio.yml", generateWorkflow());
+    log.success("Created .github/workflows/sync-portfolio.yml");
+
+    // README.md (solo si no existe)
+    if (!existsSync("README.md")) {
+      await writeFile("README.md", generateReadme(metadata));
+      log.success("Created README.md");
+    } else {
+      log.warn("README.md already exists, skipping");
+    }
+
+    // .project-schema.json
+    await writeFile(".project-schema.json", generateSchema());
+    log.success("Created .project-schema.json");
+
+    // Crear carpeta de imágenes con README
+    await mkdir("proj-images", { recursive: true });
+    const imagesReadme = `# Project Images Folder
+
+Place your project images here:
+
+- **cover.png/jpg**: Main cover image for your project
+- **screenshot1.png/jpg**: Gallery image 1
+- **screenshot2.png/jpg**: Gallery image 2
+- **screenshot3.png/jpg**: Gallery image 3
+
+## Recommended sizes:
+
+- Cover image: 1200x630px (or 16:9 ratio)
+- Screenshots: 1920x1080px or similar
+
+## Tips:
+
+- Use descriptive filenames
+- Optimize images before uploading (use tools like TinyPNG)
+- Supported formats: PNG, JPG, WebP
+- Keep file sizes under 500KB for better performance
+
+## Current images needed:
+
+${coverImage ? `- [ ] ${coverImage}` : ''}
+${galleryImages.map(img => `- [ ] ${img}`).join('\n')}
+`;
+    await writeFile("proj-images/README.md", imagesReadme);
+    await writeFile("proj-images/.gitkeep", "");
+    log.success("Created proj-images/ folder");
+
+    // .gitignore update
+    let gitignore = "";
+    if (existsSync(".gitignore")) {
+      gitignore = await readFile(".gitignore", "utf-8");
+    }
+    
+    if (!gitignore.includes("node_modules")) {
+      gitignore += "\n# Dependencies\nnode_modules/\n";
+      await writeFile(".gitignore", gitignore);
+      log.success("Updated .gitignore");
+    }
+
+    log.title("✨ Setup Complete!");
+
+    console.log(`
+${colors.bright}Next steps:${colors.reset}
+
+1. ${colors.cyan}Add images${colors.reset} to the proj-images/ folder:
+   - Cover image: ${coverImage}
+   ${galleryImages.length > 0 ? galleryImages.map(img => `- Gallery: ${img}`).join('\n   ') : ''}
+
+2. ${colors.cyan}Review and edit${colors.reset} .project-metadata.mdx
+
+3. ${colors.cyan}Set up secrets${colors.reset} in GitHub:
+   Run: ${colors.yellow}da-proj --secrets${colors.reset}
+   
+4. ${colors.cyan}Commit and push${colors.reset}:
+   ${colors.yellow}git add .
+   git commit -m "Add portfolio metadata"
+   git push${colors.reset}
+
+${colors.bright}Portfolio will auto-sync on push!${colors.reset} 🎉
+    `);
+
+  } catch (error) {
+    log.error("Failed to create files: " + error);
+    process.exit(1);
+  }
+}

package/src/commands/pull.ts

@@ -0,0 +1,119 @@
+import { select } from "@inquirer/prompts";
+import { existsSync } from "fs";
+import { readFile, writeFile } from "fs/promises";
+import type { Config } from "../types/index.js";
+import { getConfigPath } from "../utils/config.js";
+import { readGitHubSyncConfig } from "../utils/github-config.js";
+import { downloadFile } from "../utils/github.js";
+import { colors, log } from "../utils/logger.js";
+
+export async function pullCommand() {
+  log.title("📥 Pull from GitHub");
+
+  // 1. Verificar que GitHub sync esté configurado
+  const syncConfig = await readGitHubSyncConfig();
+  if (!syncConfig) {
+    log.error("GitHub sync not configured.");
+    console.log(
+      `\nRun: ${colors.cyan}da-proj --setup-github-sync${colors.reset}\n`
+    );
+    process.exit(1);
+  }
+
+  // 2. Descargar desde GitHub
+  log.info("Downloading configuration from GitHub...");
+
+  let remoteConfig: string;
+  try {
+    remoteConfig = await downloadFile(
+      syncConfig.repoUrl,
+      "da-proj-config.json"
+    );
+  } catch (error: any) {
+    if (error.message.includes("not found")) {
+      log.error("No configuration found in GitHub.");
+      console.log(
+        `\nUpload your configuration first with: ${colors.cyan}da-proj --push${colors.reset}\n`
+      );
+    } else {
+      log.error(`Failed to download: ${error.message}`);
+    }
+    process.exit(1);
+  }
+
+  // Validar que sea JSON válido
+  let remoteParsed: Config;
+  try {
+    remoteParsed = JSON.parse(remoteConfig);
+  } catch (error) {
+    log.error("Downloaded configuration is not valid JSON.");
+    process.exit(1);
+  }
+
+  // 3. Verificar si existe config local
+  const localConfigPath = getConfigPath();
+
+  if (existsSync(localConfigPath)) {
+    const localConfig = await readFile(localConfigPath, "utf-8");
+
+    // Comparar
+    if (localConfig === remoteConfig) {
+      log.success("Already up to date!");
+      console.log("\nLocal and GitHub configurations are identical.\n");
+      return;
+    }
+
+    // Preguntar qué hacer
+    const action = await select({
+      message: "Local configuration exists. What do you want to do?",
+      choices: [
+        { value: "replace", name: "Replace local with GitHub version" },
+        { value: "merge", name: "Merge (combine profiles from both)" },
+        { value: "cancel", name: "Cancel" },
+      ],
+    });
+
+    if (action === "cancel") {
+      log.info("Pull cancelled.");
+      return;
+    }
+
+    if (action === "merge") {
+      // Merge profiles
+      const local: Config = JSON.parse(localConfig);
+      const remote: Config = remoteParsed;
+
+      const localProfiles = local.profiles || [];
+      const remoteProfiles = remote.profiles || [];
+
+      // Combinar: primero los de GitHub, luego los locales que no existan en GitHub
+      const merged: Config = {
+        profiles: [
+          ...remoteProfiles,
+          ...localProfiles.filter(
+            (lp) => !remoteProfiles.some((rp) => rp.name === lp.name)
+          ),
+        ],
+      };
+
+      remoteConfig = JSON.stringify(merged, null, 2);
+      log.info(`Merged: ${merged.profiles?.length || 0} total profiles`);
+    }
+  }
+
+  // 4. Guardar localmente
+  await writeFile(localConfigPath, remoteConfig);
+  log.success("Configuration pulled from GitHub!");
+
+  // Mostrar perfiles
+  const config: Config = JSON.parse(remoteConfig);
+  if (config.profiles && config.profiles.length > 0) {
+    console.log(
+      `\n${colors.bright}Profiles (${config.profiles.length}):${colors.reset}`
+    );
+    config.profiles.forEach((p) => {
+      console.log(`  • ${p.name} (${p.portfolioUrl})`);
+    });
+    console.log("");
+  }
+}

package/src/commands/push.ts

@@ -0,0 +1,68 @@
+import { existsSync } from "fs";
+import { readFile } from "fs/promises";
+import { getConfigPath } from "../utils/config.js";
+import { readGitHubSyncConfig } from "../utils/github-config.js";
+import { uploadFile } from "../utils/github.js";
+import { colors, log } from "../utils/logger.js";
+
+export async function pushCommand() {
+  log.title("📤 Push to GitHub");
+
+  // 1. Verificar que GitHub sync esté configurado
+  const syncConfig = await readGitHubSyncConfig();
+  if (!syncConfig) {
+    log.error("GitHub sync not configured.");
+    console.log(
+      `\nRun: ${colors.cyan}da-proj --setup-github-sync${colors.reset}\n`
+    );
+    process.exit(1);
+  }
+
+  // 2. Leer configuración local
+  const localConfigPath = getConfigPath();
+  if (!existsSync(localConfigPath)) {
+    log.error("No local configuration found.");
+    console.log(
+      `\nCreate profiles first with: ${colors.cyan}da-proj --secrets${colors.reset}\n`
+    );
+    process.exit(1);
+  }
+
+  const localConfig = await readFile(localConfigPath, "utf-8");
+
+  // Validar que sea JSON válido
+  try {
+    JSON.parse(localConfig);
+  } catch (error) {
+    log.error("Local configuration is not valid JSON.");
+    process.exit(1);
+  }
+
+  // 3. Subir a GitHub
+  log.info("Uploading configuration to GitHub...");
+
+  try {
+    await uploadFile(syncConfig.repoUrl, "da-proj-config.json", localConfig);
+
+    log.success("Configuration pushed to GitHub!");
+    console.log(
+      `\n${colors.bright}Repository:${colors.reset} ${syncConfig.repoUrl}`
+    );
+    console.log(`${colors.bright}File:${colors.reset} da-proj-config.json\n`);
+
+    // Mostrar resumen
+    const config = JSON.parse(localConfig);
+    if (config.profiles && config.profiles.length > 0) {
+      console.log(
+        `${colors.bright}Uploaded ${config.profiles.length} profile(s):${colors.reset}`
+      );
+      config.profiles.forEach((p: any) => {
+        console.log(`  • ${p.name} (${p.portfolioUrl})`);
+      });
+      console.log("");
+    }
+  } catch (error: any) {
+    log.error(`Failed to push: ${error.message}`);
+    process.exit(1);
+  }
+}

package/src/commands/secrets.ts

@@ -0,0 +1,251 @@
+import { input, select } from "@inquirer/prompts";
+import { log, colors } from "../utils/logger.js";
+import { 
+  checkGitHubCLI, 
+  getExistingSecrets, 
+  setGitHubSecret 
+} from "../utils/github.js";
+import { 
+  readGlobalConfig, 
+  saveGlobalConfig, 
+  getConfigPath 
+} from "../utils/config.js";
+import { exec } from "child_process";
+import { promisify } from "util";
+
+const execAsync = promisify(exec);
+
+export async function secretsCommand() {
+  log.title("🔐 GitHub Secrets Setup");
+
+  // Verificar GitHub CLI
+  const hasGH = await checkGitHubCLI();
+  if (!hasGH) {
+    log.error("GitHub CLI (gh) is not installed.");
+    console.log(`
+${colors.yellow}To install GitHub CLI:${colors.reset}
+
+${colors.bright}Windows:${colors.reset}
+  winget install --id GitHub.cli
+
+${colors.bright}Or download from:${colors.reset}
+  https://cli.github.com/
+
+${colors.bright}After installing, authenticate:${colors.reset}
+  gh auth login
+    `);
+    process.exit(1);
+  }
+
+  // Verificar autenticación
+  try {
+    await execAsync('gh auth status');
+  } catch {
+    log.error("Not authenticated with GitHub CLI.");
+    console.log(`
+${colors.yellow}Please authenticate first:${colors.reset}
+  gh auth login
+    `);
+    process.exit(1);
+  }
+
+  log.info("GitHub CLI is ready!\n");
+
+  // Verificar si ya existen secrets en este repo
+  const existingSecrets = await getExistingSecrets();
+  
+  if (existingSecrets.url || existingSecrets.key) {
+    log.warn("Found existing secrets in this repository:");
+    if (existingSecrets.url) console.log(`  ${colors.yellow}✓${colors.reset} PORTFOLIO_API_URL`);
+    if (existingSecrets.key) console.log(`  ${colors.yellow}✓${colors.reset} PORTFOLIO_API_KEY`);
+    console.log('');
+    
+    const overwrite = await select({
+      message: "Do you want to overwrite them?",
+      choices: [
+        { value: "yes", name: "Yes, overwrite with new configuration" },
+        { value: "no", name: "No, keep existing secrets" }
+      ]
+    });
+    
+    if (overwrite === "no") {
+      log.info("Keeping existing secrets. No changes made.");
+      return;
+    }
+    
+    console.log('');
+  }
+
+  // Leer configuración existente
+  const config = await readGlobalConfig();
+  const profiles = config.profiles || [];
+  
+  let selectedProfile: { name: string; portfolioUrl: string; apiKey: string } | null = null;
+  
+  if (profiles.length > 0) {
+    log.info(`Found ${profiles.length} saved profile(s):\n`);
+    
+    const choices = [
+      ...profiles.map((p, i) => ({
+        value: `profile-${i}`,
+        name: `${p.name} (${p.portfolioUrl})`
+      })),
+      { value: "new", name: "➕ Create new profile" },
+      { value: "list", name: "📋 List all profiles" }
+    ];
+    
+    const selection = await select({
+      message: "Select a profile or create new:",
+      choices
+    });
+    
+    if (selection === "list") {
+      // Mostrar todas las configuraciones
+      log.title("📋 Saved Profiles");
+      profiles.forEach((p, i) => {
+        console.log(`\n${colors.bright}${i + 1}. ${p.name}${colors.reset}`);
+        console.log(`   URL: ${p.portfolioUrl}`);
+        console.log(`   Key: ${p.apiKey.substring(0, 16)}...${p.apiKey.substring(p.apiKey.length - 4)}`);
+      });
+      console.log('');
+      
+      const profileIndex = await input({
+        message: "Enter profile number to use (or 0 to create new):",
+        default: "1"
+      });
+      
+      const idx = parseInt(profileIndex) - 1;
+      if (idx >= 0 && idx < profiles.length) {
+        selectedProfile = profiles[idx] || null;
+      }
+    } else if (selection.startsWith("profile-")) {
+      const idx = parseInt(selection.replace("profile-", ""));
+      selectedProfile = profiles[idx] || null;
+    }
+    
+    if (selectedProfile) {
+      log.info(`Using profile: ${selectedProfile.name}`);
+      
+      // Usar configuración existente
+      try {
+        if (existingSecrets.url) {
+          log.info("Overwriting PORTFOLIO_API_URL...");
+        }
+        await setGitHubSecret('PORTFOLIO_API_URL', selectedProfile.portfolioUrl);
+        log.success(existingSecrets.url ? "Updated PORTFOLIO_API_URL" : "Set PORTFOLIO_API_URL");
+
+        if (existingSecrets.key) {
+          log.info("Overwriting PORTFOLIO_API_KEY...");
+        }
+        await setGitHubSecret('PORTFOLIO_API_KEY', selectedProfile.apiKey);
+        log.success(existingSecrets.key ? "Updated PORTFOLIO_API_KEY" : "Set PORTFOLIO_API_KEY");
+
+        log.title("✨ Secrets configured successfully!");
+        console.log(`\n${colors.bright}Using profile: ${selectedProfile.name}${colors.reset} 🎉\n`);
+        return;
+      } catch (error: any) {
+        log.error("Failed to set secrets: " + error.message);
+        process.exit(1);
+      }
+    }
+  }
+
+  // Crear nuevo perfil
+  const profileName = await input({
+    message: "Profile name (e.g., 'main', 'personal', 'work')",
+    default: profiles.length === 0 ? "main" : "profile-" + (profiles.length + 1)
+  });
+
+  const portfolioUrl = await input({
+    message: "Portfolio API URL",
+    default: "https://your-portfolio.com"
+  });
+
+  const portfolioKey = await input({
+    message: "Portfolio API Key (leave empty to generate one)",
+    default: ""
+  });
+
+  let apiKey = portfolioKey;
+  
+  // Generar API key si está vacía
+  if (!apiKey) {
+    log.info("Generating API key...");
+    const randomBytes = new Uint8Array(32);
+    crypto.getRandomValues(randomBytes);
+    apiKey = Array.from(randomBytes)
+      .map(b => b.toString(16).padStart(2, '0'))
+      .join('');
+    
+    console.log(`\n${colors.bright}Generated API Key:${colors.reset}`);
+    console.log('━'.repeat(70));
+    console.log(apiKey);
+    console.log('━'.repeat(70));
+    console.log(`\n${colors.yellow}⚠️  IMPORTANT: Save this key!${colors.reset}`);
+    console.log(`\n${colors.bright}1. Add it to your portfolio as environment variable:${colors.reset}`);
+    console.log(`   PORTFOLIO_API_KEY=${apiKey}`);
+    console.log(`\n${colors.bright}2. This key will be saved locally and reused for all your projects${colors.reset}\n`);
+    
+    await input({
+      message: "Press Enter to continue and set the secrets in GitHub...",
+      default: ""
+    });
+  }
+
+  // Guardar configuración globalmente
+  await saveGlobalConfig({ name: profileName, portfolioUrl, apiKey });
+
+  // Configurar secrets en GitHub
+  log.info("Setting GitHub secrets...");
+
+  try {
+    if (existingSecrets.url) {
+      log.info("Overwriting PORTFOLIO_API_URL...");
+    }
+    await setGitHubSecret('PORTFOLIO_API_URL', portfolioUrl);
+    log.success(existingSecrets.url ? "Updated PORTFOLIO_API_URL" : "Set PORTFOLIO_API_URL");
+
+    if (existingSecrets.key) {
+      log.info("Overwriting PORTFOLIO_API_KEY...");
+    }
+    await setGitHubSecret('PORTFOLIO_API_KEY', apiKey);
+    log.success(existingSecrets.key ? "Updated PORTFOLIO_API_KEY" : "Set PORTFOLIO_API_KEY");
+
+    log.title("✨ Secrets configured successfully!");
+
+    console.log(`
+${colors.bright}Configuration saved!${colors.reset}
+
+${colors.green}✓${colors.reset} Profile "${profileName}" saved in: ${getConfigPath()}
+${colors.green}✓${colors.reset} You can now use this profile in other repos!
+
+${colors.bright}Next steps:${colors.reset}
+
+1. ${colors.cyan}Make sure your portfolio has the API key${colors.reset}:
+   PORTFOLIO_API_KEY=${apiKey}
+
+2. ${colors.cyan}Test the workflow${colors.reset}:
+   git add .
+   git commit -m "Test workflow"
+   git push
+
+${colors.bright}All your projects using this profile will sync to the same portfolio!${colors.reset} 🎉
+    `);
+
+  } catch (error: any) {
+    log.error("Failed to set secrets: " + error.message);
+    console.log(`
+${colors.yellow}You can set them manually:${colors.reset}
+
+1. Go to your repo on GitHub
+2. Settings > Secrets and variables > Actions
+3. New repository secret:
+   - Name: PORTFOLIO_API_URL
+   - Value: ${portfolioUrl}
+4. New repository secret:
+   - Name: PORTFOLIO_API_KEY
+   - Value: ${apiKey}
+    `);
+    process.exit(1);
+  }
+}