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
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.
70 lines
3.3 KiB
Markdown
70 lines
3.3 KiB
Markdown
# 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)
|
||
|
||
```bash
|
||
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).
|