@fluencypassdevs/cycle 1.17.0 → 1.18.0

package/bin/cli.mjs

@@ -12,6 +12,8 @@ const command = process.argv[2]
 
 if (command === "mcp") {
   await import("./mcp.mjs")
+} else if (command === "propose") {
+  await import("./propose.mjs")
 } else if (command === "init" || !command) {
   await import("./init.mjs")
 } else {

package/bin/propose.mjs

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+
+/**
+ * `npx cycle propose <arquivo>` — propõe um componente ao Design System a partir
+ * do PRÓPRIO projeto do dev, sem abrir o GitHub na mão.
+ *
+ * Lê o componente (idealmente de `src/components/ds-proposals/`), pergunta o
+ * contexto, e abre a issue "Proposta de Componente" no repo do DS via `gh`
+ * (login do próprio dev — todos são da org). Se o `gh` não existir, cai num
+ * fallback: salva o corpo num arquivo + imprime um link pré-preenchido.
+ *
+ * Flags: --name, --what, --where, --preview (não-interativo) · --dry-run (só imprime).
+ */
+
+import fs from "fs"
+import path from "path"
+import { execFileSync, spawnSync } from "child_process"
+import { createInterface } from "readline"
+
+// ── Config específica do DS (o pulse tem a sua) ──
+const DS = {
+  label: "Cycle",
+  repo: "Fluencypass/Cycle",
+  surfaceHint: "Tela de produto (app logado, painel, aula)",
+}
+
+const argv = process.argv.slice(2)
+const flags = {}
+const positionals = []
+for (let i = 0; i < argv.length; i++) {
+  const a = argv[i]
+  if (a === "--dry-run") flags.dryRun = true
+  else if (a.startsWith("--")) flags[a.slice(2)] = argv[++i]
+  else positionals.push(a)
+}
+
+function fail(msg) {
+  console.error(`\n  ✗ ${msg}\n`)
+  process.exit(1)
+}
+
+// 1. Arquivo do componente
+let file = positionals[0]
+if (!file) {
+  // tenta achar candidatos em ds-proposals/
+  const dir = path.join(process.cwd(), "src/components/ds-proposals")
+  const found = fs.existsSync(dir) ? fs.readdirSync(dir).filter((f) => /\.(tsx|jsx|ts)$/.test(f)) : []
+  if (found.length === 1) file = path.join(dir, found[0])
+  else if (found.length > 1) fail(`Vários candidatos em ds-proposals/. Especifique: npx cycle propose <arquivo>\n    ${found.join("\n    ")}`)
+  else fail("Uso: npx cycle propose <caminho-do-componente>  (ex.: src/components/ds-proposals/meu-card.tsx)")
+}
+if (!fs.existsSync(file)) fail(`Arquivo não encontrado: ${file}`)
+const code = fs.readFileSync(file, "utf-8")
+
+// 2. Metadados (flags ou prompt)
+const rl = createInterface({ input: process.stdin, output: process.stdout })
+const ask = (q, def) =>
+  new Promise((res) => rl.question(`  ${q}${def ? ` (${def})` : ""}: `, (a) => res(a.trim() || def || "")))
+
+const name = flags.name || path.basename(file).replace(/\.(tsx|jsx|ts)$/, "")
+
+console.log(`\n  Propor componente ao ${DS.label} Design System\n  ─────────────────────────────────────────────\n`)
+
+const what = flags.what || (await ask("O que ele faz? (1 frase)"))
+const where = flags.where || (await ask("Onde ele aparece?", DS.surfaceHint))
+const preview = flags.preview || (await ask("Link de preview ou screenshot (opcional)"))
+rl.close()
+
+// 3. Corpo da issue
+const title = `[Proposta] ${name}`
+const body = `## Componente
+**${name}**
+
+## O que faz
+${what || "(não informado)"}
+
+## Onde aparece
+${where}
+
+## Preview
+${preview || "(anexar print/link)"}
+
+## Código
+\`\`\`tsx
+${code}
+\`\`\`
+
+---
+_Proposto via \`npx cycle propose\` a partir de um projeto consumidor._`
+
+// 4. dry-run
+if (flags.dryRun) {
+  console.log(`\n  [dry-run] Issue que seria criada em ${DS.repo}:\n`)
+  console.log(`  Título: ${title}`)
+  console.log(`  Label:  ds-proposal\n`)
+  console.log(body.split("\n").map((l) => "  │ " + l).join("\n"))
+  console.log("")
+  process.exit(0)
+}
+
+// 5. Cria a issue via gh (ou fallback)
+const hasGh = spawnSync("gh", ["--version"], { stdio: "ignore" }).status === 0
+if (hasGh) {
+  const tmp = path.join(process.cwd(), `.ds-proposal-${name}.md`)
+  fs.writeFileSync(tmp, body)
+  try {
+    const url = execFileSync(
+      "gh",
+      ["issue", "create", "--repo", DS.repo, "--title", title, "--label", "ds-proposal", "--body-file", tmp],
+      { encoding: "utf-8" }
+    ).trim()
+    fs.unlinkSync(tmp)
+    console.log(`\n  ✓ Proposta enviada! ${url}\n  Você será notificado quando for revisada.\n`)
+  } catch (err) {
+    fs.unlinkSync(tmp)
+    fail(`Falha ao criar a issue via gh (${err.message}). Rode \`gh auth login\` e tente de novo, ou use o fallback abaixo.`)
+  }
+} else {
+  const out = path.join(process.cwd(), `ds-proposal-${name}.md`)
+  fs.writeFileSync(out, body)
+  const url = `https://github.com/${DS.repo}/issues/new?labels=ds-proposal&title=${encodeURIComponent(title)}`
+  console.log(`\n  'gh' não encontrado. Fallback:\n`)
+  console.log(`  1. Corpo salvo em: ${out}`)
+  console.log(`  2. Abra: ${url}`)
+  console.log(`  3. Cole o conteúdo do arquivo no corpo da issue.\n`)
+  console.log(`  (Instale o GitHub CLI — https://cli.github.com — pra automatizar isso.)\n`)
+}

package/cli/CLAUDE-section.md

@@ -157,6 +157,24 @@ Todos importados de `@fluencypassdevs/cycle`:
 | ProductLogo, ClassLogo, PrivateTalkLogo, GroupTalkLogo | Logos dos produtos |
 | CycleIcon | Wrapper para icones Lucide |
 
+## Precisa de um componente que o DS nao tem?
+
+O DS **nao trava** o projeto. Se um componente REALMENTE nao existe (confirme antes com
+`cycle_search_component` ou o catalogo), voce pode cria-lo — seguindo estas regras:
+
+1. Crie em **`src/components/ds-proposals/`** (marcador de "candidato ao DS"), NAO em
+   `components/ui/`. O componente ja funciona e pode ser usado no projeto.
+2. Componha com os atomos que ja existem (Button, Input...) e use SO tokens semanticos
+   (`bg-brand`, `text-muted-foreground`) — nunca cor/spacing hardcoded.
+3. Se for reutilizavel por outros projetos, **proponha a entrada no DS** rodando no projeto:
+   \`npx cycle propose src/components/ds-proposals/<arquivo>\` (abre a issue automaticamente via
+   gh). Fallback manual: https://github.com/Fluencypass/Cycle/issues/new/choose. Guia:
+   https://design.fluencypass.com/cycle/contribuir
+
+**Regra de superficie**: o DS certo depende de ONDE o componente renderiza — tela de produto
+(app logado) = **Cycle**; landing/campanha de marketing = **Pulse**. Nunca misture os dois no
+mesmo render; um componente que falta flui pra camada certa por triagem, sem cross-import.
+
 ## MCP Server (Claude Code)
 
 Se o projeto tem `.mcp.json` configurado, o Claude Code tera acesso a tools do Cycle:
@@ -174,5 +192,7 @@ Para configurar: `npx cycle init`
 
 ## Documentacao
 
-- **Componentes**: https://cycle-design.fluencypass.com/docs/components
-- **Tokens**: https://cycle-design.fluencypass.com/docs/tokens
+- **Portal**: https://design.fluencypass.com (escolha Cycle ou Pulse)
+- **Componentes (Cycle)**: https://design.fluencypass.com/cycle/components
+- **Tokens (Cycle)**: https://design.fluencypass.com/cycle/tokens
+- **Contribuir (propor componente)**: https://design.fluencypass.com/cycle/contribuir

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluencypassdevs/cycle",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "description": "Cycle Design System — UI component library by Fluencypass (produto)",
   "license": "MIT",
   "repository": {