ds-primeiro

1import { atom, read, update } from 'claude-code'
2import type { EngineInterface, Register } from 'claude-code'
3
4import { pedeDs } from './detecta'
5
6const anexado = atom({ plugin: 'ds-primeiro', key: 'anexado' } as const, false)
7const ligado = atom({ plugin: 'ds-primeiro', key: 'ligado' } as const, null)
8const pular = atom({ plugin: 'ds-primeiro', key: 'pular' } as const, false)
9const rascunho = atom({ plugin: 'ds-primeiro', key: 'rascunho' } as const, false)
10// O estado efetivo (`ligado ?? padrao`), publicado para outros mods lerem: `padrao` vive só neste módulo.
11const publicado = atom({ plugin: 'ds-primeiro', key: 'ativo' } as const, true)
12
13const USO = 'Use /ds, /ds on, /ds off, /ds sempre on ou /ds sempre off.'
14
15// Padrão guardado no store (`/ds sempre`) e o último resultado da detecção no
16// rascunho, para só gravar estado quando ele muda.
17let padrao = true
18let casa = false
19
20async function ativo($: EngineInterface) {
21  return (await read($, ligado)) ?? padrao
22}
23
24async function publica($: EngineInterface) {
25  const agora = await ativo($)
26  await update($, publicado, () => agora)
27}
28
29const texto = (valor: unknown) => (typeof valor === 'string' ? valor.trim() : '')
30
31export const register: Register = (on, options) => {
32  // Sem a skill do design system configurada o mod não faz nada: não anexa,
33  // não registra /ds, não desenha faixa e não publica `ativo` (a barra-uso
34  // esconde a pílula DS).
35  const skill = texto(options.skill)
36
37  if (skill === '') {
38    return
39  }
40
41  const rotulo = texto(options.rotulo) || skill
42  const termos = [skill, rotulo, ...texto(options.ignorar).split(',')]
43  const linha = `ds-primeiro: em peça visual o usuário usa por padrão o design system ${rotulo}. Carregue a skill ${skill} antes de criar, a menos que o pedido defina outra identidade. Se o pedido não for visual, ignore esta linha.`
44
45  on('session.start', async ($, e, next) => {
46    padrao = (await $.store.get('sempre')) !== false
47    await $.command.register({
48      name: 'ds',
49      description: `${rotulo} anexado ao primeiro pedido visual da sessão`,
50      argumentHint: '[on | off | sempre on | sempre off]',
51    })
52    await publica($)
53
54    return next(e)
55  })
56
57  on('command.run', { command: 'ds' }, async ($, e) => {
58    const args = e.args.trim().toLowerCase().split(/\s+/).join(' ')
59
60    if (args === 'on' || args === 'off' || args === 'sempre on' || args === 'sempre off') {
61      const liga = args.endsWith('on')
62
63      if (args.startsWith('sempre')) {
64        padrao = liga
65        await $.store.set('sempre', liga)
66      }
67
68      await update($, ligado, () => liga)
69      await publica($)
70
71      if (liga) {
72        await update($, anexado, () => false)
73      }
74    } else if (args !== '') {
75      return { text: USO }
76    }
77
78    const sessao = (await ativo($)) ? 'ligado nesta sessão' : 'desligado nesta sessão'
79    const linha = (await read($, anexado)) ? 'DS já anexado (/ds on anexa de novo)' : 'DS ainda não anexado'
80
81    return { text: `${sessao} · ${linha} · padrão ${padrao ? 'ligado' : 'desligado'}` }
82  })
83
84  on('prompt.edit', async ($, e, next) => {
85    const campo = await next(e)
86    const casaAgora = pedeDs(campo.text, termos)
87
88    if (casaAgora !== casa) {
89      casa = casaAgora
90      await update($, rascunho, () => casaAgora)
91    }
92
93    return campo
94  })
95
96  // O Enter do usuário: `composer` no terminal, `sdk` no app desktop.
97  on('prompt.submit', async ($, e, next) => {
98    if (e.origin.kind !== 'composer' && e.origin.kind !== 'sdk') {
99      return next(e)
100    }
101
102    const pulou = await read($, pular)
103    const anexa = !pulou && pedeDs(e.text, termos) && (await ativo($)) && !(await read($, anexado))
104    const entrou = await next(anexa ? { ...e, context: [...(e.context ?? []), linha] } : e)
105
106    // Um envio segurado por outro hook volta ao campo: nada muda até ele entrar.
107    if (entrou.drop !== undefined) {
108      return entrou
109    }
110
111    if (anexa) {
112      await update($, anexado, () => true)
113      $.ui.toast(`DS ${rotulo} anexado a este pedido · /ds off desliga`)
114    }
115
116    if (pulou) {
117      await update($, pular, () => false)
118    }
119
120    if (casa) {
121      casa = false
122      await update($, rascunho, () => false)
123    }
124
125    return entrou
126  })
127
128  // O DS carregado sai do contexto na compactação: rearma.
129  on('session.compact', async ($, e, next) => {
130    const feito = await next(e)
131
132    if (e.agentId === undefined && e.trigger !== 'precompute' && feito.skip === undefined) {
133      await update($, anexado, () => false)
134    }
135
136    return feito
137  })
138
139  on('session.end', async ($, e, next) => {
140    if (e.reason === 'clear' || e.reason === 'resume') {
141      casa = false
142      await update($, anexado, () => false)
143      await update($, ligado, () => null)
144      await update($, pular, () => false)
145      await update($, rascunho, () => false)
146      await publica($)
147    }
148
149    return next(e)
150  })
151
152  on('ui.render', { component: 'AbovePrompt' }, async ($, e, next) => {
153    const mostra =
154      !e.props.hasSurvey &&
155      (await read($, rascunho)) &&
156      !(await read($, anexado)) &&
157      !(await read($, pular)) &&
158      (await ativo($))
159
160    const abaixo = await next(e)
161
162    if (!mostra) {
163      return abaixo
164    }
165
166    const { Box, Button, Text } = $.ui.resolve(e)
167
168    // Empilha sobre as faixas dos outros mods; a deste fica junto do campo.
169    return (
170      <Box flexDirection="column">
171        {abaixo}
172        <Box>
173          <Text dimColor>{`DS ${rotulo} será anexado a este pedido `}</Text>
174          <Button key="tirar" label="Tirar deste envio" onPress={() => update($, pular, () => true)} />
175        </Box>
176      </Box>
177    )
178  })
179}
180

1const VERBO =
2  /\b(?:cria|crie|criar|faz|faca|fazer|refaz|refaca|recria|monta|monte|constroi|construa|desenha|redesenha|melhora|melhore)\b/
3
4const ALVO =
5  /\b(?:relatorio visual|(?:pagina|landing|lp|site|html|dashboard|painel|visualizacao|slide|deck|layout|tela|hero|componente|blog|video|motion|ui|interface)s?|paineis|visualizacoes)\b/
6
7// O pedido já cita um design system, dispensa skill ou nomeia a identidade de outra marca.
8const FORA =
9  /design system|identidade visual|\bsem ds\b|nao use skill|\b(?:design|identidade|marca) d[ao] /
10
11// Caminho de arquivo com duas partes ou mais, entre aspas ou solto: uma pasta
12// com o nome do DS no meio de um caminho não é o usuário citando o DS. A skill
13// citada como /nome-da-skill tem uma parte só e fica.
14const CAMINHO = /(['"])~?\/[^'"]*\/[^'"]*\1|(?:^|\s)~?\/[^\s/]+\/\S*/g
15
16/** Minúsculas, sem acento: a forma em que o texto e os termos são comparados. */
17export function normaliza(texto: string): string {
18  return texto.toLowerCase().normalize('NFD').replace(/[̀-ͯ]/g, '')
19}
20
21/**
22 * Diz se o texto pede uma peça visual sem definir a identidade. `termos` são
23 * os nomes que, citados no pedido, dispensam a linha: a skill, o rótulo e os
24 * termos extras da configuração.
25 */
26export function pedeDs(texto: string, termos: readonly string[] = []): boolean {
27  const t = normaliza(texto).replace(CAMINHO, ' ')
28  const citaTermo = termos.some(termo => {
29    const n = normaliza(termo).trim()
30
31    return n !== '' && t.includes(n)
32  })
33
34  return VERBO.test(t) && ALVO.test(t) && !FORA.test(t) && !citaTermo
35}
36

1declare module 'claude-code' {
2  interface PluginState {
3    'ds-primeiro': {
4      /** A linha do DS já entrou nesta sessão. */
5      anexado: boolean
6      /** `/ds on` ou `/ds off` nesta sessão; null segue o padrão guardado. */
7      ligado: boolean | null
8      /** "Tirar deste envio" foi pressionado para o rascunho atual. */
9      pular: boolean
10      /** O rascunho no campo casa a detecção. */
11      rascunho: boolean
12      /** Ligado nesta sessão (`/ds on|off`, ou o padrão de `/ds sempre`); a `barra-uso` lê. */
13      ativo: boolean
14    }
15  }
16}
17