@nimbuslab/cli 0.3.4 → 0.4.1

package/README.md

@@ -37,12 +37,49 @@ nimbus help
 | `help` | Mostrar ajuda |
 | `version` | Mostrar versao |
 
+## Flags
+
+### Tipo de projeto
+
+| Flag | Descricao |
+|------|-----------|
+| `--fast` | Landing page (template fast) |
+| `--fast-plus` | SaaS single-repo (template fast+) |
+| `--turborepo` | SaaS monorepo (template fast+ turborepo) |
+
+### Opcoes
+
+| Flag | Descricao |
+|------|-----------|
+| `-y, --yes` | Aceitar defaults |
+| `--no-git` | Nao inicializar Git |
+| `--no-install` | Nao instalar dependencias |
+| `--railway` | Configurar Railway automaticamente |
+| `--template <url>` | Usar template customizado |
+
+### Exemplos
+
+```bash
+# Landing page rapida
+nimbus create meu-site --fast
+
+# SaaS com Railway
+nimbus create meu-saas --fast-plus --railway
+
+# Monorepo sem instalar deps
+nimbus create meu-app --turborepo --no-install
+
+# Template customizado
+nimbus create projeto --template usuario/repositorio
+```
+
 ## Tipos de Projeto
 
 | Tipo | Descricao |
 |------|-----------|
 | `fast` | Landing page em 6 dias |
 | `fast+` | SaaS completo com backend |
+| `fast+ (monorepo)` | SaaS com Turborepo |
 
 ## Requisitos
 
@@ -95,10 +132,55 @@ npm version major
 ### Fluxo de release
 
 1. Desenvolva na branch `develop`
-2. Avance a versao: `npm version patch|minor|major`
+2. Avance a versao no `package.json`
 3. Commit e push: `git push origin develop`
-4. Crie PR para `main`
-5. Apos merge, GitHub Actions publica automaticamente no npm
+4. Merge para `main`: `git checkout main && git merge develop && git push origin main`
+5. GitHub Actions publica automaticamente no npm via OIDC
+
+## CI/CD - Publicacao Automatica
+
+O projeto usa **OIDC Trusted Publishing** para publicar no npm sem tokens.
+
+### Como funciona
+
+1. GitHub Actions autentica via OIDC (OpenID Connect)
+2. npm valida a identidade do workflow
+3. Pacote e publicado sem necessidade de token
+
+### Configuracao inicial (ja feita)
+
+**No npmjs.com:**
+1. Acesse: https://www.npmjs.com/package/@nimbuslab/cli/access
+2. Em "Trusted Publisher", adicione:
+   - Organization: `nimbuslab`
+   - Repository: `cli`
+   - Workflow: `publish.yml`
+3. Em "Publishing access", selecione: "Require 2FA or granular token with bypass"
+
+**No GitHub:**
+1. Workflow em `.github/workflows/publish.yml`
+2. Permissoes: `id-token: write` (obrigatorio para OIDC)
+3. Node.js 24+ (versoes anteriores tem bug)
+
+### Limitacoes (repo privado)
+
+- `--provenance` NAO funciona em repos privados
+- OIDC Trusted Publishing funciona normalmente
+- Se tornar o repo publico, adicionar `--provenance` ao publish
+
+### Troubleshooting
+
+| Erro | Causa | Solucao |
+|------|-------|---------|
+| "Access token expired" | Token classico deprecado | Usar OIDC Trusted Publishing |
+| E404 + "not in registry" | OIDC nao configurado | Configurar Trusted Publisher no npm |
+| E422 + "private repository" | --provenance em repo privado | Remover --provenance |
+| "id-token permission" | Falta permissao no workflow | Adicionar `id-token: write` |
+
+### Referencias
+
+- [npm Trusted Publishing](https://docs.npmjs.com/trusted-publishers/)
+- [OIDC Announcement](https://github.blog/changelog/2025-07-31-npm-trusted-publishing-with-oidc-is-generally-available/)
 
 ## Stack
 

package/dist/index.js

@@ -851,6 +851,45 @@ var TEMPLATES = {
   "fast+": "nimbuslab-templates/fastplus-template",
   "fast+-monorepo": "nimbuslab-templates/fastplus-monorepo-template"
 };
+function parseFlags(args) {
+  const flags = {
+    yes: false,
+    fast: false,
+    fastPlus: false,
+    turborepo: false,
+    noGit: false,
+    noInstall: false,
+    railway: false,
+    template: null
+  };
+  let projectName;
+  let i = 0;
+  while (i < args.length) {
+    const arg = args[i];
+    if (arg === "-y" || arg === "--yes") {
+      flags.yes = true;
+    } else if (arg === "--fast") {
+      flags.fast = true;
+    } else if (arg === "--fast-plus") {
+      flags.fastPlus = true;
+    } else if (arg === "--turborepo") {
+      flags.turborepo = true;
+    } else if (arg === "--no-git") {
+      flags.noGit = true;
+    } else if (arg === "--no-install") {
+      flags.noInstall = true;
+    } else if (arg === "--railway") {
+      flags.railway = true;
+    } else if (arg === "--template") {
+      i++;
+      flags.template = args[i] ?? null;
+    } else if (!arg.startsWith("-")) {
+      projectName = arg;
+    }
+    i++;
+  }
+  return { flags, projectName };
+}
 async function ensureRailwayCli() {
   const checkCmd = process.platform === "win32" ? "where" : "which";
   const hasRailway = await $2`${checkCmd} railway`.quiet().then(() => true).catch(() => false);
@@ -939,17 +978,19 @@ async function create(args) {
       console.log();
     }
   }
-  const hasYes = args.includes("-y") || args.includes("--yes");
-  const projectName = args.find((a) => !a.startsWith("-"));
+  const { flags, projectName } = parseFlags(args);
   Ie(import_picocolors3.default.bgCyan(import_picocolors3.default.black(" Novo Projeto nimbuslab ")));
   let config;
-  if (hasYes && projectName) {
+  const hasTypeFlag = flags.fast || flags.fastPlus || flags.turborepo;
+  const typeFromFlag = flags.turborepo ? "fast+" : flags.fastPlus ? "fast+" : flags.fast ? "fast" : null;
+  const monorepoFromFlag = flags.turborepo;
+  if ((flags.yes || hasTypeFlag) && projectName) {
     config = {
       name: projectName,
-      type: "fast",
-      monorepo: false,
-      git: true,
-      install: true,
+      type: typeFromFlag || "fast",
+      monorepo: monorepoFromFlag,
+      git: !flags.noGit,
+      install: !flags.noInstall,
       github: false,
       githubOrg: null,
       githubDescription: "",
@@ -960,17 +1001,47 @@ async function create(args) {
       railwayProject: "",
       railwayToken: "",
       stagingUrl: "",
-      productionUrl: ""
+      productionUrl: "",
+      customTemplate: flags.template
     };
+    const typeLabel = flags.turborepo ? "fast+ (monorepo)" : config.type;
     console.log(import_picocolors3.default.dim(`  Projeto: ${projectName}`));
-    console.log(import_picocolors3.default.dim(`  Tipo: fast`));
-    console.log(import_picocolors3.default.dim(`  Git: sim`));
-    console.log(import_picocolors3.default.dim(`  GitHub: nao`));
-    console.log(import_picocolors3.default.dim(`  Infra: configurar depois`));
-    console.log(import_picocolors3.default.dim(`  Instalar: sim`));
+    console.log(import_picocolors3.default.dim(`  Tipo: ${typeLabel}`));
+    console.log(import_picocolors3.default.dim(`  Git: ${config.git ? "sim" : "nao"}`));
+    console.log(import_picocolors3.default.dim(`  Instalar: ${config.install ? "sim" : "nao"}`));
+    if (flags.railway)
+      console.log(import_picocolors3.default.dim(`  Railway: configurar`));
+    if (flags.template)
+      console.log(import_picocolors3.default.dim(`  Template: ${flags.template}`));
     console.log();
+    if (flags.railway) {
+      const railwayAuthenticated = await isRailwayAuthenticated();
+      if (railwayAuthenticated) {
+        if (config.type === "fast") {
+          const projects = await listRailwayProjects();
+          const fastProject = projects.find((p2) => p2.toLowerCase().includes("fast by nimbuslab"));
+          if (fastProject) {
+            config.railwayProject = fastProject;
+            console.log(import_picocolors3.default.green(`  Railway: ${fastProject}`));
+          }
+        } else {
+          console.log(import_picocolors3.default.dim(`  Criando projeto Railway: ${projectName}...`));
+          try {
+            const result = await $2`echo "" | railway init -n ${projectName} -w nimbuslab --json`.text();
+            const newProject = JSON.parse(result);
+            config.railwayProject = newProject.name || projectName;
+            console.log(import_picocolors3.default.green(`  Railway: ${config.railwayProject} criado`));
+          } catch {
+            console.log(import_picocolors3.default.yellow(`  Railway: erro ao criar projeto`));
+          }
+        }
+      } else {
+        console.log(import_picocolors3.default.yellow(`  Railway: nao autenticado (railway login)`));
+      }
+      console.log();
+    }
   } else {
-    config = await promptConfig(projectName);
+    config = await promptConfig(projectName, flags);
   }
   if (pD(config)) {
     xe("Operacao cancelada");
@@ -980,7 +1051,7 @@ async function create(args) {
   Se(import_picocolors3.default.green("Projeto criado com sucesso!"));
   showNextSteps(config);
 }
-async function promptConfig(initialName) {
+async function promptConfig(initialName, flags) {
   const name = await he({
     message: "Nome do projeto:",
     placeholder: "meu-projeto",
@@ -1217,14 +1288,22 @@ async function promptConfig(initialName) {
     railwayProject,
     railwayToken,
     stagingUrl,
-    productionUrl
+    productionUrl,
+    customTemplate: flags?.template || null
   };
 }
 async function createProject(config) {
   const s = Y2();
-  const templateKey = config.type === "fast+" && config.monorepo ? "fast+-monorepo" : config.type;
-  const templateRepo = TEMPLATES[templateKey];
-  const templateLabel = config.monorepo ? `${config.type} (monorepo)` : config.type;
+  let templateRepo;
+  let templateLabel;
+  if (config.customTemplate) {
+    templateRepo = config.customTemplate;
+    templateLabel = `customizado (${config.customTemplate})`;
+  } else {
+    const templateKey = config.type === "fast+" && config.monorepo ? "fast+-monorepo" : config.type;
+    templateRepo = TEMPLATES[templateKey];
+    templateLabel = config.monorepo ? `${config.type} (monorepo)` : config.type;
+  }
   s.start(`Clonando template ${templateLabel}...`);
   try {
     await $2`gh repo clone ${templateRepo} ${config.name} -- --depth 1`.quiet();
@@ -1427,13 +1506,25 @@ ${import_picocolors4.default.bold("Comandos:")}
   help             Mostrar esta ajuda
   version          Mostrar versao
 
+${import_picocolors4.default.bold("Tipo de projeto:")}
+  --fast           Landing page (template fast)
+  --fast-plus      SaaS single-repo (template fast+)
+  --turborepo      SaaS monorepo (template fast+ turborepo)
+
 ${import_picocolors4.default.bold("Opcoes:")}
-  -y, --yes        Aceitar defaults (fast, git, install)
+  -y, --yes        Aceitar defaults
+  --no-git         Nao inicializar Git
+  --no-install     Nao instalar dependencias
+  --railway        Configurar Railway automaticamente
+  --template <url> Usar template customizado
 
 ${import_picocolors4.default.bold("Exemplos:")}
   ${import_picocolors4.default.dim("$")} nimbus create meu-projeto
   ${import_picocolors4.default.dim("$")} nimbus create meu-projeto -y
-  ${import_picocolors4.default.dim("$")} nimbus create
+  ${import_picocolors4.default.dim("$")} nimbus create meu-projeto --fast
+  ${import_picocolors4.default.dim("$")} nimbus create meu-saas --fast-plus --railway
+  ${import_picocolors4.default.dim("$")} nimbus create meu-app --turborepo --no-install
+  ${import_picocolors4.default.dim("$")} nimbus create custom --template user/repo
 `);
 }
 function showVersion() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimbuslab/cli",
-  "version": "0.3.4",
+  "version": "0.4.1",
   "description": "CLI para criar projetos nimbuslab",
   "type": "module",
   "bin": {

package/src/commands/create.ts

@@ -31,6 +31,64 @@ interface ProjectConfig {
   railwayToken: string
   stagingUrl: string
   productionUrl: string
+  // Template customizado
+  customTemplate: string | null
+}
+
+interface CreateFlags {
+  yes: boolean
+  fast: boolean
+  fastPlus: boolean
+  turborepo: boolean
+  noGit: boolean
+  noInstall: boolean
+  railway: boolean
+  template: string | null
+}
+
+function parseFlags(args: string[]): { flags: CreateFlags; projectName: string | undefined } {
+  const flags: CreateFlags = {
+    yes: false,
+    fast: false,
+    fastPlus: false,
+    turborepo: false,
+    noGit: false,
+    noInstall: false,
+    railway: false,
+    template: null,
+  }
+
+  let projectName: string | undefined
+  let i = 0
+
+  while (i < args.length) {
+    const arg = args[i]!
+
+    if (arg === "-y" || arg === "--yes") {
+      flags.yes = true
+    } else if (arg === "--fast") {
+      flags.fast = true
+    } else if (arg === "--fast-plus") {
+      flags.fastPlus = true
+    } else if (arg === "--turborepo") {
+      flags.turborepo = true
+    } else if (arg === "--no-git") {
+      flags.noGit = true
+    } else if (arg === "--no-install") {
+      flags.noInstall = true
+    } else if (arg === "--railway") {
+      flags.railway = true
+    } else if (arg === "--template") {
+      i++
+      flags.template = args[i] ?? null
+    } else if (!arg.startsWith("-")) {
+      projectName = arg
+    }
+
+    i++
+  }
+
+  return { flags, projectName }
 }
 
 // M30: Verificar e instalar Railway CLI
@@ -139,21 +197,25 @@ export async function create(args: string[]) {
     }
   }
 
-  const hasYes = args.includes("-y") || args.includes("--yes")
-  const projectName = args.find(a => !a.startsWith("-"))
+  const { flags, projectName } = parseFlags(args)
 
   p.intro(pc.bgCyan(pc.black(" Novo Projeto nimbuslab ")))
 
   let config: ProjectConfig | symbol
 
-  if (hasYes && projectName) {
-    // Modo automatico com defaults (sem configs de infra)
+  // Determina tipo baseado nas flags
+  const hasTypeFlag = flags.fast || flags.fastPlus || flags.turborepo
+  const typeFromFlag = flags.turborepo ? "fast+" : flags.fastPlus ? "fast+" : flags.fast ? "fast" : null
+  const monorepoFromFlag = flags.turborepo
+
+  // Modo automatico: -y com nome OU flags de tipo com nome
+  if ((flags.yes || hasTypeFlag) && projectName) {
     config = {
       name: projectName,
-      type: "fast",
-      monorepo: false,
-      git: true,
-      install: true,
+      type: typeFromFlag || "fast",
+      monorepo: monorepoFromFlag,
+      git: !flags.noGit,
+      install: !flags.noInstall,
       github: false,
       githubOrg: null,
       githubDescription: "",
@@ -165,16 +227,48 @@ export async function create(args: string[]) {
       railwayToken: "",
       stagingUrl: "",
       productionUrl: "",
+      customTemplate: flags.template,
     }
+
+    const typeLabel = flags.turborepo ? "fast+ (monorepo)" : config.type
     console.log(pc.dim(`  Projeto: ${projectName}`))
-    console.log(pc.dim(`  Tipo: fast`))
-    console.log(pc.dim(`  Git: sim`))
-    console.log(pc.dim(`  GitHub: nao`))
-    console.log(pc.dim(`  Infra: configurar depois`))
-    console.log(pc.dim(`  Instalar: sim`))
+    console.log(pc.dim(`  Tipo: ${typeLabel}`))
+    console.log(pc.dim(`  Git: ${config.git ? "sim" : "nao"}`))
+    console.log(pc.dim(`  Instalar: ${config.install ? "sim" : "nao"}`))
+    if (flags.railway) console.log(pc.dim(`  Railway: configurar`))
+    if (flags.template) console.log(pc.dim(`  Template: ${flags.template}`))
     console.log()
+
+    // Railway automatico se flag --railway
+    if (flags.railway) {
+      const railwayAuthenticated = await isRailwayAuthenticated()
+      if (railwayAuthenticated) {
+        if (config.type === "fast") {
+          const projects = await listRailwayProjects()
+          const fastProject = projects.find(p => p.toLowerCase().includes("fast by nimbuslab"))
+          if (fastProject) {
+            config.railwayProject = fastProject
+            console.log(pc.green(`  Railway: ${fastProject}`))
+          }
+        } else {
+          // Fast+: cria projeto novo automaticamente
+          console.log(pc.dim(`  Criando projeto Railway: ${projectName}...`))
+          try {
+            const result = await $`echo "" | railway init -n ${projectName} -w nimbuslab --json`.text()
+            const newProject = JSON.parse(result)
+            config.railwayProject = newProject.name || projectName
+            console.log(pc.green(`  Railway: ${config.railwayProject} criado`))
+          } catch {
+            console.log(pc.yellow(`  Railway: erro ao criar projeto`))
+          }
+        }
+      } else {
+        console.log(pc.yellow(`  Railway: nao autenticado (railway login)`))
+      }
+      console.log()
+    }
   } else {
-    config = await promptConfig(projectName)
+    config = await promptConfig(projectName, flags)
   }
 
   if (p.isCancel(config)) {
@@ -189,7 +283,7 @@ export async function create(args: string[]) {
   showNextSteps(config as ProjectConfig)
 }
 
-async function promptConfig(initialName?: string): Promise<ProjectConfig | symbol> {
+async function promptConfig(initialName?: string, flags?: CreateFlags): Promise<ProjectConfig | symbol> {
   const name = await p.text({
     message: "Nome do projeto:",
     placeholder: "meu-projeto",
@@ -468,16 +562,26 @@ async function promptConfig(initialName?: string): Promise<ProjectConfig | symbo
     railwayToken,
     stagingUrl,
     productionUrl,
+    customTemplate: flags?.template || null,
   }
 }
 
 async function createProject(config: ProjectConfig) {
   const s = p.spinner()
 
-  // Clone template baseado no tipo (fast ou fast+) e monorepo
-  const templateKey = config.type === "fast+" && config.monorepo ? "fast+-monorepo" : config.type
-  const templateRepo = TEMPLATES[templateKey]
-  const templateLabel = config.monorepo ? `${config.type} (monorepo)` : config.type
+  // Determina template: customizado ou padrao
+  let templateRepo: string
+  let templateLabel: string
+
+  if (config.customTemplate) {
+    templateRepo = config.customTemplate
+    templateLabel = `customizado (${config.customTemplate})`
+  } else {
+    const templateKey = config.type === "fast+" && config.monorepo ? "fast+-monorepo" : config.type
+    templateRepo = TEMPLATES[templateKey]
+    templateLabel = config.monorepo ? `${config.type} (monorepo)` : config.type
+  }
+
   s.start(`Clonando template ${templateLabel}...`)
   try {
     await $`gh repo clone ${templateRepo} ${config.name} -- --depth 1`.quiet()

package/src/index.ts

@@ -43,13 +43,25 @@ ${pc.bold("Comandos:")}
   help             Mostrar esta ajuda
   version          Mostrar versao
 
+${pc.bold("Tipo de projeto:")}
+  --fast           Landing page (template fast)
+  --fast-plus      SaaS single-repo (template fast+)
+  --turborepo      SaaS monorepo (template fast+ turborepo)
+
 ${pc.bold("Opcoes:")}
-  -y, --yes        Aceitar defaults (fast, git, install)
+  -y, --yes        Aceitar defaults
+  --no-git         Nao inicializar Git
+  --no-install     Nao instalar dependencias
+  --railway        Configurar Railway automaticamente
+  --template <url> Usar template customizado
 
 ${pc.bold("Exemplos:")}
   ${pc.dim("$")} nimbus create meu-projeto
   ${pc.dim("$")} nimbus create meu-projeto -y
-  ${pc.dim("$")} nimbus create
+  ${pc.dim("$")} nimbus create meu-projeto --fast
+  ${pc.dim("$")} nimbus create meu-saas --fast-plus --railway
+  ${pc.dim("$")} nimbus create meu-app --turborepo --no-install
+  ${pc.dim("$")} nimbus create custom --template user/repo
 `)
 }