19 Commits

Author SHA1 Message Date
Marcos Paulo f53159f0b4 test: point the review-desk assertions at what the build emits
Two of task 19's re-pointed assertions were checking the built page for
tokens only the legacy page has, and both were hidden behind the
full-guide snapshot failure because verify.mjs stops at the first throw.

- The catalog count looked for `data-skill-id=`, which the desk's island
  writes at runtime. Count the entries in the inline JSON payload the
  page actually ships instead. Still 24.
- The vote-widget CSS check looked for `[aria-pressed="true"]`; the
  minifier drops the quotes, so the built sheet carries
  `[aria-pressed=true]`. Match either form.

Also re-baselines the full-guide rendered-text snapshot. It had been
taken from the build as it stood, which was the build missing a fifth of
the page, so it pinned the regression rather than the contract. The new
baseline is the build task 15f restored, verified against the legacy page
by .agents/scripts/rendered-text-diff.mjs: en 432/432 and pt 431/431,
missing 0, extra 0, order clean.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-06 00:40:01 +00:00
Marcos Paulo 8c7ca2aded test: restore Astro verification contracts
Reinstate all 42 legacy facts as output or authoritative-source contracts, retain output snapshots, and set the 84-assertion floor. Extend the audit count without changing site content or components.
2026-09-05 23:41:23 +00:00
Marcos Paulo d15c301fdb test: repoint verification at Astro output
Verify rendered routes, translations, CSS dependencies, variables, and built CSS values. Keep the original assertion count; do not alter site components or fixtures.
2026-09-05 23:24:09 +00:00
Marcos Paulo 054393f7af feat(15d): complete localization of full-guide page to PT 2026-09-05 22:30:50 +00:00
Marcos Paulo e2bcfff5ab feat: add reader vote widget and vote-service
The skills-review desk is static, so "which draft would you ship?" needs a
stateful counterpart. vote-service is a small Go API on its own pod backed by
a JSON file on a ReadWriteOnce PVC, with one active vote per skill per source
IP as the anti-abuse rule and CORS (ALLOWED_ORIGIN) as the caller boundary.

Deployment notes that differ from the obvious path, all confirmed against the
live cluster: the image is side-loaded with `ctr image import` plus
`imagePullPolicy: Never` because kubelet has no credentials for the Nexus ref;
the pod is pinned to `kubernets` because the hostpath PV takes a nodeAffinity
for whichever node first binds it; and public exposure is Caddy on the VPS,
not the cloudflared tunnel.

The ingress controller runs with `use-forwarded-headers` off, so nginx
overwrites X-Forwarded-For with its own peer — every visitor would collapse
into one voter and each skill would cap at one vote overall. Caddy stamps the
true remote address into X-Client-IP, which nginx forwards untouched, and
clientIP() reads that first. Scoped to this app rather than flipping the
global flag, which would change client-IP handling for every other ingress.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-04 23:49:55 +00:00
Marcos Silva d12d301a1a feat: review semantic diff submission 2026-09-04 14:07:26 -03:00
Marcos Silva 9557957698 feat: expand skills review navigation and catalog 2026-09-04 13:28:06 -03:00
Marcos Silva 355a0b5600 feat: add skill preview search and diff 2026-09-04 09:45:14 -03:00
Marcos Silva 76d83c9cf9 feat: review Gustavo and Marcos submitted skills 2026-09-04 09:11:53 -03:00
Marcos Paulo 6ccc692759 fix: redact operational skill review sources 2026-09-04 04:37:04 +00:00
Marcos Paulo aa85864868 feat: make route map the interactive landing page 2026-09-04 04:18:15 +00:00
Marcos Paulo 94f3491d7a feat: organize guide into focused chapters 2026-09-04 03:52:36 +00:00
Marcos Silva 82fff29571 feat: add submitted skills review desk 2026-09-04 00:34:53 -03:00
Marcos Paulo 47144e9206 feat(deck): source links for both labs, plus unslop pass and verify tune
- Add 'Source on Gitea' link next to every 'Open the X lab' link,
  pointing to https://git.marcospaulo.dev.br/netcracker/ai-for-dummies/...
- Same download links added to both SilverBullet guides (Preview +
  Source on Gitea) under Path A and Path B.
- Tighten standalone verify rule: only block external <script src> and
  <link rel=stylesheet href>. Plain <a href=https://...> hyperlinks are
  not runtime dependencies.
- Unslop pass across all deck text, SilverBullet EN/PT, hands-on/rules
  header/label/README: kill triplets, dramatic single-word sentences,
  'matrix below / looks good / cuts the opposite failure' rhetoric.
  Header subtitle now reads 'Toggle rules. Same task, different
  coverage.' (was 'different leash').

verify: all six checks pass.
2026-09-02 16:31:54 +00:00
Marcos Paulo 9f879ed276 feat: add model routing and hands-on lab 2026-09-02 14:35:27 +00:00
Marcos Paulo 6c591eac07 feat: add skill creation workflow 2026-09-02 02:23:29 +00:00
Marcos Paulo 0a802004af feat: explain common agent skills 2026-09-02 01:49:35 +00:00
Marcos Paulo 273ea5e259 feat: add interactive agent workflow diagrams 2026-09-02 01:30:12 +00:00
Marcos Paulo 9557cae6b6 feat: add AI For Dummies presentation 2026-09-02 00:33:49 +00:00