mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-17 21:03:06 +00:00
- scripts/check-push-chain.mjs: default --site, usage, erro → canônico; prosa Neon/vercel → homeserver - tests: fixtures unit (WebAuthn, JsonMutation, aiMarkdownLinks) + int (campaignMultiPhones) → canônico, semântica preservada - campaignMultiPhones: adiciona ensureLeasedConsent para invite consent fixture (fix pre-existente) - personas (.opencode/agent/designer, solla-comunicacao, skill): canônico + operação homeserver - docs: intenção + impl plan + changelog entry; CHANGELOG-AGENTS append-only preservado - Sem migration, sem schema, sem access/Consent, sem UI - Closes #796
11 KiB
11 KiB
Impl: Cutoff de transição (fase 1) — desativar o acesso ao site pela URL pt.jorgesolla.com.br (congelar a fonte)
Status: rascunho Atualizado em: 2026-08-23 Issue: #796 Intenção: docs/plans/ops80-cutoff-desativar-url-antiga.md Appetite restante: herdado (~1 dia eng)
Leitura da intenção
- Outcome:
pt.jorgesolla.com.brpara de servir o app (nenhuma nova sessão/form/escrita via URL antiga); a fonte fica congelada sem novo write no take antigo até a migração de dados do OPS79 e o redirect do OPS81. O vertical canônico de campanha (jorgesolla1313.com.br/campanha) segue 100% sem regressão. - O que NÃO negociar:
- Nenhuma escrita possível via URL antiga a partir do cutoff → a "lacuna de dados entre última migração e desativação" fica estruturalmente impossível.
- Sem redirect antigo→canônico (é OPS81, depois do OPS79).
NEXT_PUBLIC_SITE_URLpermanece canônico (governa invite/calendarFeed/syncs/passwordReset/WebAuthn viagetCampaignInviteBaseURL) — não mexer na lógica.- Sem regressão no
/campanhacanônico (auth WebAuthn/invite/same-origin mutação e o PWA).
- O que reavaliar: o deliverable de CÓDIGO é só eliminar/atualizar cada referência in-repo a
pt.jorgesolla.com.brpara que nada do repo aponte/enconde a URL antiga como verdade. Desativação de DNS/hosting é INFRA (fora do app). Não há URL antiga em runtime não-test (o app é 100% canônico via env) — o trabalho é limpar fixtures/verbosidade/operação de default e personas que ainda citam a fonte antiga.
Abordagem recomendada
Opções consideradas: A | B | C
Recomendação: B — troca textual pontual da URL antiga → canônica no (A) código/testes/operacional e (C) personas de agente; docs históricos (B) intocados; referências de conteúdo jorgesolla.com.br (sem pt/1313) intocadas; fallback next.config.mjs/apoiadores intocado. A intenção é narrow e bem definida; o risco está em sobrescopar. Manter docs como história (37signals: build less) e não tocar em fonte de conteúdo controla o diff ao mínimo correto.
Rejeitadas:
- A (alterar também docs históricos de ops): as impl-plans
ops50*,ops51*,ops52-*-impl,c98-impl,c115-impl,push-notificacoes-impl,revalidate-secret-vercel-production-impl,ci-deploy-cooldown-15min,CUTOVER-MAIN-ONLYdocumentam o estado passado (são "history, not locks" — a própria intenção diz). Editá-los não muda runtime e suja o diff; recomendo deixar como história.docs/CHANGELOG-AGENTS.mdé append-only e NUNCA editado à mão — fora de qualquer hipótese. - C (reaproveitar Vercel/preview host como canônico): o host de preview
teqo-git-b40-solla.vercel.appno teste WebAuthn é o caso de DENIAL intencional (host distinto do configurado) — preservar. - D (tocar
next.config.mjsL4 /apoiadores/[id]/page.tsxL82): esses defaultshttps://jorgesolla.com.br(minúsculo, sem pt/1313) são a base/fallback da origem WordPress para share-metadata de conteúdo — NÃO é a URL antiga do app (pt.jorgesolla.com.br). Alterá-los risca alterar o comportamento de links públicos apoiadores/posts sem benefício para o cutoff. Fora de escopo. (Se um produto futuro unificar o domínio canônico no share-metadata, isso é outra issue.) - E (
jorgesolla.com.brcomo CONTEÚDO): seed/recover-media/CalendarFeedUID:...@teqo.jorgesolla.com.brwpArticles são refs de FONTE DE CONTEÚDO, não a URL antiga — nenhum toque.
Componentes / mudanças
scripts/check-push-chain.mjs:- L13 (usage comment)
[--site https://pt.jorgesolla.com.br]→https://jorgesolla1313.com.br. - L47 default
'https://pt.jorgesolla.com.br'→'https://jorgesolla1313.com.br'(operational default real da ferramenta — é a única mudança que afeta runtime/verdicto por omissão). - L49 erro de exemplo
https://pt.jorgesolla.com.br→ canônico. - L15-16 e L85: prosa operacional stale (Neon unpooled /
vercel env pull) → semântica homeserver (~/stack/teqo-1313.env,DATABASE_URLdoteqo_1313). Nota-chave: a mensagem de erro já texto falls no homeserver (L49-50 do blocodie); alinhar o texto prosa restante à mesma semântica.
- L13 (usage comment)
tests/unit/campaignWebAuthnConfig.unit.spec.ts:configuredURL/forwardedHost/rpID/originnos casos prod (L17,18,21,32) e descrições/nomes de teste ("canonical HTTPS origin in production", "canonical origin here", "a production build is served there") →jorgesolla1313.com.br. Preservar o caso preview (L33teqo-git-b40-solla.vercel.app) — é o DENIAL por host distinto (semântica intacta: canônico configurado vs host servido*.vercel.app→toBeNull()).tests/unit/campaignJsonMutationRoute.unit.spec.ts: L27 (new Request('https://pt.jorgesolla.com.br/...')) e L54 (Origin: 'https://pt.jorgesolla.com.br') → canônico. O teste de aceite de Origin (mesmo host) e o de cross-origin (evil.example) mantêm semântica.tests/unit/aiMarkdownLinks.unit.spec.tsL66:'https://pt.jorgesolla.com.br/campanha'→'https://jorgesolla1313.com.br/campanha'(assertisCampaignInternalLink === falsepreservada — external URL continua false).tests/int/campaignMultiPhones.int.spec.tsL336:inviteUrl: 'https://pt.jorgesolla.com.br/campanha/convite/abc'→ canônico. É string plana concatenada no link WhatsApp (url de teste) — semântica irrelevante, troca segura..opencode/agent/designer-campanha-solla.md: L9 ("hoje empt.jorgesolla.com.br") → canônico; L21 (lista de fontes de notícia) → canônico; L54 ("deploy na Vercel ... fonctions em gru1 ... x-vercel-id") — duplamente stale → operação no homeserver (sem Vercel)..opencode/agent/solla-comunicacao.md: L19 (fonte oficial de notícias) → canônico..opencode/skills/solla-comunicacao/SKILL.md: L15 (e perfil L28 se presente) → canônico.- Novos docs do PR (não são "alteração"):
docs/plans/ops80-cutoff-desativar-url-antiga.md(intenção), este impl, + entrada curta de changelog emdocs/changelog/<data>-ops80.md(rodarpnpm changelog:build— agregado insert-only, mantendo append-only do CHANGELOG-AGENTS intacto).
Dados → forma (se aplicável)
- Sem migração, sem schema, sem acesso/Consent/UI. Nenhuma coleção/global/field alterada.
Fases verificáveis
- Blindagem/estado-base:
git statuslimpo no worktree; confirmar ausência devercel.json/.vercel;rg -n "pt.jorgesolla.com.br" --hiddenpara inventário completo da superfície antes de editar (garantir que nada fora da lista do explorer precisa de olhar). - Operação (A): editar
scripts/check-push-chain.mjs(default--site, usage, erro, prosa homeserver). - Testes unit (A): editar fixtures/assertions de
campaignWebAuthnConfig,campaignJsonMutationRoute,aiMarkdownLinks. - Teste int (A): editar fixture
inviteUrldecampaignMultiPhones. - Personas (C): editar
designer-campanha-solla.md,solla-comunicacao.md,solla-comunicacao/SKILL.md. - Doc delivrables: criar
docs/plans/ops80-cutoff-desativar-url-antiga.md+ impl deste plano + entrada de changelog; rodarpnpm changelog:build. - Gate completo:
pnpm exec tsc --noEmit;pnpm lint;pnpm format:check;pnpm exec knip;pnpm check:cycles; testes afetados pinados por arquivo (vitest run tests/unit/campaignWebAuthnConfig.unit.spec.ts tests/unit/campaignJsonMutationRoute.unit.spec.ts tests/unit/aiMarkdownLinks.unit.spec.ts; int:tests/int/campaignMultiPhones.int.spec.ts);pnpm build. Revarredura finalrg -n "pt.jorgesolla.com.br"deve retornar zero (excepto, se decidido, docs históricos — ver aceite).
Rabbit holes / Não escopo (engenharia)
jorgesolla.com.br(sempt/1313) em seed/recover-media/wpArticles/UID:...@teo.jorgesolla.com.bre no share-metadata: FONTE DE CONTEÚDO/gênero, não a URL antiga — proibido tocar.- Fallback
next.config.mjsL4 /apoiadores/[id]/page.tsxL82: base WordPress-doc, não o app antigo — fora de escopo (recomendado). - Hosts
*.vercel.appem teste WebAuthn: caso intencional de denial por preview — preservar. - Migração de dados (OPS79) e redirect (OPS81): entregas futuras, não neste item.
- Procurar "pt.jorgesolla.com.br" em binários/build/
pnpm-lock: não deve existir; não caçar emnode_modules/.next(gerados, fora). - Docs históricos e
CHANGELOG-AGENTS.mdappend-only: não editar.
Riscos e mitigação
- Risco: troca acidental do caso WebAuthn de denial (mexer no fixture preview
teqo-git-b40-solla.vercel.app/ na comparação de host) quebraria a proteçãotoBeNull(). → Mitigação: editar APENASconfiguredURL/RP canônico; o host preview permanece*.vercel.app; rodar o spec pinado e confirmar que o teste "refuses a Vercel preview" continua 0. - Risco: default
--sitedocheck-push-chainmuda o alvo da única verificação operacional; se debugger rodar com omissão, passa a testar o canônico real. → Desejado (é o objetivo: canônico é a verdade). Nada a mitigar além de rodar o script--siteexplícito pós-mudança contra o canônico para validar o GET. - Risco: sobrescopar (mexer em docs/fallback/fonte-de-conteúdo) inflando o diff. → Mitigação: fases 1 e 7 com
rgfull darão inventário exato e confirmarão zero menções remanescentes fora do que se decidiu preservar. - Risco:
format:check/lintfalharem em arquivos .md de persona (formater/line-length). → Mitigação: editar preservando a formatação existente das linhas; rodarpnpm format:check/pnpm lintnos gates. - Risco: changelog inserir entrada duplicada/incompleta. →
changelog:buildé insert-only agregado; seguir o formato de um histórico recente e validar a saída do build.
Aceite de engenharia
rg -n "pt.jorgesolla.com.br"(fora denode_modules,.next, docs históricos decididos-preservados) = 0; nenhuma nova referência à URL antiga introduzida.scripts/check-push-chain.mjsdefault--site, usage e erro apontam parajorgesolla1313.com.br; prosavercel env pull/Neon substituída por semântica homeserver (~/stack/teqo-1313.env).- WebAuthn spec:
configuredURL/rpID/originprod = canônico; caso previewteqo-git-b40-solla.vercel.app→toBeNull()preservado (teste "refuses a Vercel preview" verde). campaignJsonMutationRoute(Request + Origin controlado),aiMarkdownLinks(external URL → false),campaignMultiPhones(inviteUrl) = canônico, semânticas preservadas.- Personas
.opencode/agent/designer-campanha-solla.md,.opencode/agent/solla-comunicacao.md,.opencode/skills/solla-comunicacao/SKILL.md= canônico + homeserver; prosa "deploy na Vercel/functions gru1/x-vercel-id" removida/atualizada. - Docs novos do PR presentes (
ops80-cutoff-desativar-url-antiga.md, este impl, entrada de changelog) +pnpm changelog:buildok;docs/CHANGELOG-AGENTS.mdintocado. - Gates verdes:
tsc --noEmit,lint,format:check,knip,check:cycles, specs unit/int pinados por arquivo,build. - Nenhuma migração, nenhuma mudança de acesso/Consent/schema/UI; fallback
next.config.mjs/apoiadorese refs de conteúdojorgesolla.com.brintocados.