@softize/opus 8.8.1 → 8.9.0

package/registry/skills/create-action/SKILL.md

@@ -1,49 +0,0 @@
----
-name: create-action
-description: Cria uma opus action no formato canônico (passa no opus check por construção). Use ao implementar uma nova action/endpoint num projeto Opus-based.
----
-
-# create-action
-
-Procedimento pra criar uma **opus action** padronizada. Gera o esqueleto certo e
-deixa você só com a lógica — sem decorar convenção, sem reprovar no `opus check`.
-
-> Língua: **código em inglês; comentários/UI em pt-BR** (ver `code-style.md`).
-
-## Passo a passo
-
-1. **Decida** `<resource>.<verb>` e o `kind`:
-   - `list` — lista paginada · `view` — leitura de um recurso
-   - `form` — mutação com campos de UI · `simple` — mutação atômica
-   - Namespacing por sub-área é ok: `ticket.sla.check`.
-
-2. **Gere o esqueleto** (formato canônico, ordem dos campos correta):
-   ```bash
-   node scaffold.mjs <resource> <verb> <kind>   # ex.: ticket create form
-   ```
-   Cole o resultado em `src/domains/<resource>/actions/<verb>.ts`.
-
-3. **Preencha**: `input`/`output` (zod + `t.*` pra tipos lógicos), `summary`/`label`
-   (pt-BR), e o `handler` (a lógica). Não reordene os campos.
-
-4. **Exporte no barrel** `src/domains/<resource>/actions/index.ts` e garanta que o
-   domínio está registrado no `src/runtime.ts` (`defineDomain` + `runtime.register`).
-
-5. **Front (quando aplicável)**: invoque via `@softize/opus/client` + `ui/react`
-   (`useLookupAction`/`useTriggerAction`/`useFormAction`/`useViewAction`) — **não**
-   escreva fetch/tipos na mão.
-
-6. **Valide**: `opus check src` → tem que dar **0 violação**. Rode antes do handoff.
-
-## O contrato é o `actions.md`
-
-Kinds, ordem canônica dos campos e garantias vivem na página Actions (`/docs/actions`;
-`node_modules/@softize/opus/src/ui/docs/content/actions.md`) — não reproduza aqui. O
-`scaffold.mjs` já emite a ordem certa e o `opus check` cobra; esta skill é o
-PROCEDIMENTO, não a referência.
-
-Checklist rápido do que o `opus check` reprova (antes do handoff):
-- `name` = `<resource>(.<sub>)*.<verb>`, minúsculo, ponto.
-- `kind` ∈ `simple|form|list|view`.
-- Campos na ordem canônica (do scaffold; ver `actions.md`).
-- `defineAction` é **`export const`**.

package/registry/skills/create-action/scaffold.mjs

@@ -1,122 +0,0 @@
-/**
- * Scaffold de opus action — gera o esqueleto canônico (passa no `opus check` por
- * construção: action-name, kind, field-order, export). O agente preenche a lógica.
- *
- * Uso: node scaffold.mjs <resource> <verb> [kind=simple]
- *   ex.: node scaffold.mjs widget list list     → const widgetList (widget.list)
- *        node scaffold.mjs user set-password simple
- *
- * Comentários em pt-BR (UI/comentários em PT; código em inglês — ver code-style.md).
- */
-
-const cap = (s) => s.charAt(0).toUpperCase() + s.slice(1)
-const camel = (verb) => verb.split('-').map((p, i) => (i === 0 ? p : cap(p))).join('')
-/** const name = resource + PascalVerb. Ex.: user + set-password → userSetPassword. */
-const constName = (resource, verb) => resource + verb.split('-').map(cap).join('')
-
-const HEAD = `import { z } from 'zod'
-import { defineAction } from '@softize/opus/core'
-`
-
-/** Gera o conteúdo .ts canônico da action pro kind. */
-export function actionTemplate({ resource, verb, kind = 'simple' }) {
-  const cn = constName(resource, verb)
-  const name = `${resource}.${verb}`
-
-  if (kind === 'list') {
-    return `${HEAD}
-export const ${cn} = defineAction({
-  name: '${name}',
-  kind: 'list',
-  summary: 'TODO: o que lista (pt-BR)',
-  input: z.object({
-    // TODO: filtros / paginação
-  }),
-  output: z.object({
-    // TODO: shape de um item
-    id: z.string(),
-  }),
-  paginate: 'cursor',
-  handler: async (_ctx, _input) => {
-    // TODO: buscar
-    return { items: [], cursor: { next: null }, total: 0 }
-  },
-})
-`
-  }
-
-  if (kind === 'form') {
-    return `${HEAD}
-export const ${cn} = defineAction({
-  name: '${name}',
-  kind: 'form',
-  label: 'TODO: rótulo (pt-BR)',
-  messages: { success: 'TODO', error: 'TODO' },
-  input: z.object({
-    // TODO: campos do form
-  }),
-  output: z.object({ id: z.string() }),
-  fields: {
-    // TODO: { campo: { label: 'pt-BR' } }
-  },
-  handler: async (_ctx, _input) => {
-    // TODO: criar/editar
-    return { id: '' }
-  },
-  invalidates: ['${resource}.list'],
-})
-`
-  }
-
-  if (kind === 'view') {
-    return `${HEAD}
-export const ${cn} = defineAction({
-  name: '${name}',
-  kind: 'view',
-  summary: 'TODO: o que retorna (pt-BR)',
-  input: z.object({ id: z.string() }),
-  output: z.object({
-    // TODO: shape do recurso
-    id: z.string(),
-  }),
-  handler: async (_ctx, input) => {
-    // TODO: carregar
-    return { id: input.id }
-  },
-})
-`
-  }
-
-  // simple (default)
-  return `${HEAD}
-export const ${cn} = defineAction({
-  name: '${name}',
-  kind: 'simple',
-  label: 'TODO: rótulo (pt-BR)',
-  messages: { success: 'TODO', error: 'TODO' },
-  input: z.object({ id: z.string() }),
-  output: z.object({ ok: z.boolean() }),
-  handler: async (_ctx, _input) => {
-    // TODO: mutação
-    return { ok: true }
-  },
-  invalidates: ['${resource}.list'],
-})
-`
-}
-
-/** Nome do arquivo sugerido (kebab do verb). */
-export function actionFileName(verb) {
-  return `${verb}.ts`
-}
-
-// CLI: imprime o template no stdout (a skill diz onde colar).
-const isMain = import.meta.url === `file://${process.argv[1]}`
-if (isMain) {
-  const [resource, verb, kind] = process.argv.slice(2)
-  if (!resource || !verb) {
-    console.error('uso: node scaffold.mjs <resource> <verb> [kind=simple|form|list|view]')
-    process.exit(1)
-  }
-  process.stdout.write(actionTemplate({ resource, verb, kind }))
-}