Files
0pt/AGENTS.md
T
opt-vehiq-work salvage 1d63f63dfd
CI (SIAX Cloud) / quality (push) Successful in 49s
CI (SIAX Cloud) / security (push) Successful in 7m5s
Security Scan (SIAX Cloud) / security (push) Successful in 7m5s
CI (SIAX Cloud) / integration (push) Successful in 18m53s
CI (SIAX Cloud) / security (pull_request) Successful in 46s
Security Scan (SIAX Cloud) / security (pull_request) Successful in 58s
CI (SIAX Cloud) / integration (pull_request) Successful in 1m38s
CI (SIAX Cloud) / quality (pull_request) Successful in 1m45s
chore(salvage): preserve uncommitted WIP from /opt/vehiq-work/0pt-p060-p068_0pt before machine cleanup (2026-09-27)
This snapshot was found sitting uncommitted in a stale /opt/vehiq-work
lane clone dated ~2026-09-09..18, base branch: feat/p060-p068-ingestion-plane.
Not reviewed, not verified against current main. Pushed only so the
directory could be deleted without losing the diff.
2026-09-27 12:58:50 +02:00

3.3 KiB
Raw Blame History

AGENTS.md — 0pt

Web Data SSOT

Läs sax3l/siax-standard-filerna standard/estate/SIAX_WEB_DATA_CAPABILITY_REGISTRY.json, standard/SIAX-WEB-DATA-PLATFORM-MASTERPLAN-v1.0.md och ADR-018. 0pt får inte skapa en lokal kopia av den globala capabilitykatalogen. AR-4 hindrar egna providerberoenden i 0pt men upphäver inte 1p:s daterade upstream-overlay eller registrerade tekniska capabilities.

Operativ brief för AI-agenter (Claude Code / opencode / liknande) som arbetar i detta repo. Läs CLAUDE.md + docs/compliance/ innan du gör ändringar.

Vad det här är

0pt = SIAX Clouds Data OS: företags-/kontakt-/fordonsdata, enrichment, entity-resolution, provenance per fält, adaptive router, orderflöde med 50/50-escrow. Next.js 16-webapp + FastAPI-engine + Python-skrapmotor i samma träd.

Första steget

  1. git pull (Gitea: git.siax.io/sax3l/0pt — det är canonical remote, ej GitHub).
  2. Läs CLAUDE.md (kontraktet), docs/architecture/ARCHITECTURE.md (vad koden verkligen gör, inkl. kända luckor S1–S12), docs/compliance/ (status).
  3. Kontrollera senaste CI-run (Gitea Actions) om du ska verifiera "grön".

Viktiga förhållanden

  • Egressägarskap ändrat 2026-09-16. Den äldre stacken i services/scrapers/* är historiskt behållen, men nya produktflöden ska inte bygga ut en konkurrerande proxy-/stealthrouter i 0pt. Providerpooler, rotation, stealth_browser och managed_unblock ägs av 1p och används via dess entitlement-, scope- och destinationspolicy-styrda kontrakt. Läs docs/architecture/1P_PROXY_PLATFORM_INTEGRATION.md. Ingen teknisk kapabilitet blanket-förbjuds eller raderas; den görs valbar och isolerad.
  • Auth: /api/0pt/* fail-closed i kod (Zitadel via middleware), men live-instansen svarade 2026-08-10 anonymt 200 (lucka S1 — rotorsaksanalys ej klar). Påstå aldrig att produktionen är skyddad innan en anonym request fått 401.
  • Tenant-id får aldrig tas från request-body — idag gör handlers det (S2); nya handlers ska läsa x-0pt-verified-tenant-headern.
  • Sanning: repot har en stark anti-fabricering-konvention (docs korrigerar README). Om något påstås vara byggt men inte finns: skriv "inte byggt", fabricera inte.
  • Skyddade sökvägar: .gitea/workflows/** + .gitignore — ändringar går via PR.
  • Fonts: självhämtade via @fontsource-variable/* — lägg aldrig tillbaka next/font/google eller @vercel/*.
  • Secrets: aldrig i repo. Infisical (vault.siax.io), env via process.env.*.
  • Docker: multi-stage, icke-root (USER node), ingen tsx i prod, healthcheck mot /api/health.

Grindar (kör före push)

pnpm run typecheck && pnpm run test && pnpm run build   # blocking
pnpm run lint                                           # advisory

Commit & push

  • Conventional Commits. Push direkt till main är OK för icke-skyddade filer, men om du rör skyddade sökvägar: branch → PR.
  • Lämna aldrig en förgrenad origin/github.com-remote som sanningskälla — Gitea är primärt (Simon-direktiv 2026-07-14).

Vid osäkerhet

Fråga Simon (simon@siax.io) innan du: raderar något, aktiverar äldre lokal bypasskod, ändrar auth-beteende, eller gör produktbeslut som är öppna frågor (§8 i ARCHITECTURE.md).