@acropole/skills 1.5.0 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -442,12 +442,12 @@ página própria) — não crie outra.
442
442
  import { provideSettingsSection } from '@trismegisto/spine/layout';
443
443
 
444
444
  provideSettingsSection({
445
- key: 'notificacoes', // também abre por ?settings=notificacoes
446
- label: 'Notificações',
447
- icon: 'bell',
448
- description: 'Quando avisar você.',
449
- keywords: 'alerta aviso e-mail',
450
- component: NotificacoesSettingsComponent, // de preferência hm-settings-row (a busca acha cada linha)
445
+ key: 'resumos', // também abre por ?settings=resumos
446
+ label: 'Resumos por e-mail',
447
+ icon: 'mail',
448
+ description: 'O que mandar para o seu e-mail.',
449
+ keywords: 'resumo e-mail diário',
450
+ component: ResumosSettingsComponent, // de preferência hm-settings-row (a busca acha cada linha)
451
451
  }),
452
452
  ```
453
453
 
@@ -456,7 +456,7 @@ import { ChangeDetectionStrategy, Component, signal } from '@angular/core';
456
456
  import { SettingsRowComponent, SwitchComponent } from '@trismegisto/angular';
457
457
 
458
458
  @Component({
459
- selector: 'app-notificacoes-settings',
459
+ selector: 'app-resumos-settings',
460
460
  imports: [SettingsRowComponent, SwitchComponent],
461
461
  changeDetection: ChangeDetectionStrategy.OnPush,
462
462
  template: `
@@ -465,14 +465,18 @@ import { SettingsRowComponent, SwitchComponent } from '@trismegisto/angular';
465
465
  </hm-settings-row>
466
466
  `,
467
467
  })
468
- export class NotificacoesSettingsComponent {
468
+ export class ResumosSettingsComponent {
469
469
  protected readonly email = signal(false);
470
470
  }
471
471
  ```
472
472
 
473
- As seções do app aparecem depois das do spine (Aparência, Região, Atalhos, Conta) e antes de "Sobre". Não
474
- repita as chaves de `SPINE_SETTINGS_KEYS` (`aparencia`, `regiao`, `atalhos`, `conta`, `sobre`). Abrir por código:
475
- `inject(SpineSettingsService).open('notificacoes')`.
473
+ As seções do app aparecem depois das do spine e antes de "Sobre". Não repita as chaves de `SPINE_SETTINGS_KEYS`
474
+ (`aparencia`, `acessibilidade`, `regiao`, `atalhos`, `ajuda`, `notificacoes`, `dados`, `conta`, `mfa`, `sessoes`,
475
+ `sobre`; `seguranca` é alias antigo de `mfa`). Abrir por código: `inject(SpineSettingsService).open('resumos')`.
476
+
477
+ Antes de criar seção própria, veja se o spine já oferece (`SpineConfig.features`, `references/spine.md` §3.2):
478
+ liga/desliga de avisos do app é `features.notices` + `SpineNoticesService.notify`, não uma seção nova;
479
+ inatividade, tela inicial, crachá padrão, atividade da conta e agente de IA também.
476
480
 
477
481
  ## 11. Novidades da versão
478
482
 
@@ -111,6 +111,20 @@ O que cada provider faz:
111
111
  | `showAppName` | `true` | com `false`, o nome só aparece quando não há logo visível |
112
112
  | `favicon` | — | atualiza/cria o `<link rel="icon">`; sem ele vale o do `index.html` |
113
113
  | `technicalDocs` | `isDevMode()` | mostra a aba "Especificação técnica" da documentação das telas |
114
+ | `features` | tudo desligado | recursos opcionais do painel de configurações (`SpineFeatures`, abaixo) |
115
+
116
+ `SpineConfig.features` (cada um só aparece quando ligado; os que dependem do Argos também precisam da API
117
+ da conta — `AUTH_CONFIG` com `authority`/`realmId`):
118
+
119
+ | Campo | O que liga |
120
+ |---|---|
121
+ | `aiAgent: { servers: SpineMcpServer[] }` | Sessões › "Conectar um agente de IA": token de aplicação + `.mcp.json` pronto (precisa de `SPINE_ADMIN_API`) |
122
+ | `accountActivity: true` | MFA › "Atividade da conta": entradas e tentativas que falharam (últimos 90 dias) |
123
+ | `idleTimeout: true \| { min?, max? }` | Conta › "Encerrar por inatividade" (com `max`, some o "Nunca") |
124
+ | `startPage: true` | Conta › "Tela inicial" depois do login: início, um favorito ou a última tela |
125
+ | `defaultBadge: true` | Conta › "Crachá padrão" (nível de acesso do login, guardado no Argos) |
126
+ | `notices: { types: SpineNoticeType[] }` | seção Notificações: liga/desliga cada tipo de aviso e o aviso do navegador; o app emite com `SpineNoticesService.notify(tipo, { title, body?, url?, intent? })` (`@trismegisto/spine/layout`) |
127
+ | `accountPreferences: true` | guarda as preferências (aparência, região, acessibilidade, favoritos, tela inicial…) também na conta do Argos |
114
128
 
115
129
  - **`provideRouter(APP_ROUTES)`** — `APP_ROUTES` = `PUBLIC_ROUTES` (`/login`, `/callback`, `/logoff`,
116
130
  `/blocked`, `''` → `login`) + `{ path: '', component: LayoutComponent, canActivate/canActivateChild:
@@ -124,8 +138,8 @@ O que cada provider faz:
124
138
  - **`provideShell({ appComponents, packageInfo })`** — contribui com as telas do app para `COMPONENT_ROUTES`
125
139
  (`multi`), registra o `RouteIdInterceptor` em `HTTP_INTERCEPTORS` e fornece `APP_PACKAGE_INFO`. Lança erro
126
140
  se um `id` do app repetir um id das telas base do shell.
127
- - **`provideAutoService({ adminApi })`** — liga as 5 telas do auto-serviço (Início, Grupos, Aplicações,
128
- Cliente, Auditoria) pelo `source_template_router_id` do template do Argos, todas **lazy**, e fornece
141
+ - **`provideAutoService({ adminApi })`** — liga as 6 telas do auto-serviço (Início, Grupos, Aplicações,
142
+ Cliente, Auditoria, Tentativas de login) pelo `source_template_router_id` do template do Argos, todas **lazy**, e fornece
129
143
  `SPINE_ADMIN_API` (usado também pelo painel de configurações para os tokens de aplicação). O app não declara
130
144
  nada disso em `features.routes.ts`: basta o client estar vinculado ao template de auto-serviço no Argos.
131
145
  Sem auto-serviço, o painel de configurações ainda pode listar tokens se o app fornecer
@@ -261,7 +275,8 @@ async listTeams() {
261
275
  | Abrir configurações | `SpineSettingsService.open(SPINE_SETTINGS_KEYS.appearance)` ou link `?settings=aparencia` |
262
276
  | Abrir documentação | `SpineDocsService.openIndex()` / `openForRoute(routerId)` |
263
277
  | Reabrir tour / novidades | `OnboardingService.restart()` / `SpineNewsService.showAll()` |
264
- | Fuso e idioma da pessoa | `SpinePreferencesService.effectiveTimeZone()` (sinal; IANA) e `language()` |
278
+ | Fuso e idioma da pessoa | `SpinePreferencesService.effectiveTimeZone()` (sinal; IANA) e `language()`; também `hourCycle()`, `weekStart()`, `textScale()`, `motion()` |
279
+ | Avisar a pessoa de um acontecimento | `SpineNoticesService.notify('tipo', { title, body?, url? })` com o tipo declarado em `SpineConfig.features.notices` — respeita o liga/desliga de Configurações › Notificações |
265
280
  | Página atual | `LoggerService.page`, `.routerId`, `.routeId` (`@trismegisto/spine/routing`) |
266
281
  | Tema/densidade por código | `ThemeService.setMode('light'\|'dark'\|'system')`, `setTheme`, `DensityService.setDensity('comfortable'\|'compact')`, `toggleDensity()`, `ThemePresetService.setPreset(family)` — sincronizam entre abas. Em geral **não precisa**: o painel de configurações já oferece tudo |
267
282
 
@@ -282,6 +297,9 @@ sozinho no painel `?`. Não reuse essas combinações.
282
297
  pelo `SPINE_ADMIN_API`. Inclui período rápido, filtros (com filtros salvos), KPIs, linha do tempo,
283
298
  rankings paginados, tabela paginada por cursor e detalhe/cadeia (trace) num `hm-drawer`; estados de
284
299
  carregando, vazio, erro, janela > 31 dias, filtro inválido e 403. No auto-serviço ela já aparece sozinha.
300
+ Tentativas de login (`auth.auth_attempts`): `<spine-login-attempts scope="admin" [realmId]="id" />` ou
301
+ `<spine-login-attempts scope="client" [clientId]="id" />` (`{adminApi}/admin/attempts` ou
302
+ `{adminApi}/auto-service/:clientId/attempts`), mesmo ponto de entrada e mesmas regras de `adminApi`.
285
303
  **Este ponto de entrada exporta o componente: importe-o só de código lazy** (`loadComponent`, `import()`,
286
304
  `@defer`) — receitas §8.
287
305