# nysky — endringslogg for agenter

Nye manifest-felter og atferdsendringer i kontrakten. Sjekk denne når du
OPPDATERER en app, så du ikke bygger på utdaterte antakelser.

Gjeldende kontraktversjon står i `X-Nysky-Contract`-headeren på alle API-svar
og i CLI-ens `--json`-konvolutt. Nyeste øverst.

**Beskriver du hvordan plattformen virker NÅ, er stedet
[https://nysky.no/agent.md](https://nysky.no/agent.md)** — denne loggen forteller bare hva som
har ENDRET seg.

---

## «Logg ut» for gatede apper, og bare bekreftede e-postadresser slipper inn (13. november 2026, kontrakt 0.2.88 uendret)

**Logg ut.** Gatede apper har fått en utloggingssti. Lenk til den fra appen:

```html
<a href="/oauth2/logout">Logg ut</a>
```

- Brukeren logges ut av **denne appen**. nysky ID-økten og andre apper er
  uberørt.
- Uten parametre vises plattformens «Du er logget ut»-side. Med
  `/oauth2/logout?rd=/` sendes brukeren til en sti i appen i stedet — bruk det
  når appen har en åpen forside (`gate_stier`). `rd` må være en sti på appens
  egen vert.
- Neste innlogging i appen krever at brukeren autentiserer seg på nytt
  (passkey eller Vipps). Appen logger ikke stille inn igjen.
- GET og POST virker likt. Appen trenger ingen kode utover lenken; `/oauth2/*`
  er som før reservert av plattformen.
- Brukeren kan også logge ut av enkeltapper, eller av alle, under
  **Innlogginger** i kundeportalen. Det gjelder alle enhetene deres.

**Bare bekreftede adresser.** Gaten slipper nå bare inn på e-postadresser som
er bekreftet: Vipps-adressen når Vipps attesterer den eller brukeren har
bekreftet den med kode, og bekreftede jobbadresser.

- **For appen din:** `X-Nysky-Auth-User` er alltid en bekreftet adresse. En
  ubekreftet adresse matcher verken `allow`-listen eller «kontoens utviklere»,
  og sendes aldri til appen.
- **For brukerne:** den som har en ubekreftet Vipps-adresse møter én gang en
  side med «Bekreft e-postadressen», får en kode på e-post og slipper inn.
- Nøkle fortsatt brukerdata på `X-Nysky-Auth-Sub`. Inviterer appen selv folk
  på e-post, bind invitasjonen til `sub` første gang den brukes.

**Rettelse.** I delt kjøring kunne en klient sende egne `X-Nysky-Auth-Name` og
`X-Nysky-Auth-Emails`. De strippes nå som de andre identitetshodene. Appene
skal ikke lese disse to hodene; de er plattformens egne.

---

## Kontrakt 0.2.88 — Claude i Amazon Bedrock uten AWS-nøkler (12. november 2026)

`[identitet]` har fått en ny mottaker:

```toml
[identitet]
mottakere = ["bedrock"]   # eller ["anthropic", "bedrock"]
```

Samme identitetstoken som for Claude API, men med `aud = sts.amazonaws.com`.
AWS STS bytter det mot midlertidige nøkler for en IAM-rolle i din egen
AWS-konto.

- **Oppsett hos AWS:** registrer `https://api.nysky.no/v1/identitet` som
  OIDC-leverandør i IAM med audience `sts.amazonaws.com`, og lag en rolle som
  stoler på appens subject. `nysky identitet <app>` gir ferdig tillitspolicy.
- **Regioner:** bare AWS-regionene i Europa (eu-north-1, eu-central-1,
  eu-central-2, eu-west-1, eu-west-2, eu-west-3, eu-south-1, eu-south-2).
  Plattformen åpner STS og `bedrock-mantle` der, ingenting annet.
- **container:** `AWS_WEB_IDENTITY_TOKEN_FILE` settes automatisk. Sett
  `AWS_ROLE_ARN` og `AWS_REGION` i `[vars]`, så virker
  `new AnthropicBedrockMantle()` fra `@anthropic-ai/bedrock-sdk` uten nøkler.
- **workerd:** hent tokenet med `env.NYSKY_IDENTITET.fetch("http://identitet/bedrock")`.
- Grensen for antall verter i `App`-ressursen er hevet fra 16 til 32.

---

## Kontrakt 0.2.87 — svarfrist for planlagte kall: `timeout_s` (11. november 2026)

Plattformens cron-kall har alltid gitt opp etter 55 sekunder, men det sto
ingen steder. En jobb som brukte lengre tid, feilet stille hver dag, og i
workerd ble arbeidet avbrutt midtveis.

- **Nytt felt:** `[[crons]] timeout_s` (1–600). Utelatt gir 55 som før, så
  eksisterende apper merker ingenting.
- **Lange jobber:** det enkleste er fortsatt å svare `202` med en gang og gjøre
  jobben i `ctx.waitUntil()`. Da trenger du ikke feltet. Se cron-avsnittet i
  agent.md.
- **Kallet går internt** i clusteret, ikke via den offentlige ruten. Det var
  feil beskrevet i agent.md før.

---

## Kontrakt 0.2.86 — arbeidslast-identitet: kall Claude API uten API-nøkkel (11. november 2026)

Nytt manifestfelt:

```toml
[identitet]
mottakere = ["anthropic"]
```

Plattformen utsteder da et kortlivet, signert identitetstoken for appen
(OIDC, ES256, 1 time, fornyes hvert 15. minutt). Claude API bytter det mot sin
egen tilgangsnøkkel gjennom Workload Identity Federation. Det finnes ingen
`sk-ant-…`-nøkkel i appen og ingen å rotere.

- **Issuer:** `https://api.nysky.no/v1/identitet`. Discovery og JWKS er
  offentlige.
- **subject:** `nysky:<konto-id>:<app>`. Slipp inn én app eksakt, eller hele
  kontoen med `subject_prefix = "nysky:<konto-id>:*"`.
- **Oppsett:** `nysky identitet <app>` (eller `GET /v1/apps/<app>/identitet`)
  gir ferdig utfylt issuer- og regelforslag for Claude Console, en
  `[vars]`-mal (`ANTHROPIC_FEDERATION_RULE_ID`, `ANTHROPIC_ORGANIZATION_ID`,
  `ANTHROPIC_SERVICE_ACCOUNT_ID`) og en kodesnutt. Du registrerer issueren i
  DIN EGEN Anthropic-organisasjon, så du fakturerer direkte og nysky ser ingen
  trafikk.
- **workerd:** tokenet hentes med
  `env.NYSKY_IDENTITET.fetch("http://identitet/anthropic")`. Gi det til
  `oidcFederationProvider({ identityTokenProvider })` fra `@anthropic-ai/sdk`.
- **container:** `ANTHROPIC_IDENTITY_TOKEN_FILE` settes automatisk, så
  `new Anthropic()` uten argumenter virker når de tre ID-ene står i `[vars]`.
- **Nett:** `api.anthropic.com` åpnes for appen på alle nivåer, også i delt
  kjøring. Apper uten feltet når fortsatt ikke internett.
- **Previews** får eget token:
  `nysky:<konto-id>:<app>:preview:<preview>`. Prod-regelen din slipper dem
  ikke inn. Vil du at previews skal nå Claude, lag en regel til med
  `subject_prefix = "nysky:<konto-id>:<app>:preview:*"`, gjerne mot en egen
  workspace med lavere budsjett. `nysky identitet <app>` foreslår den.
- **Grenser:** `sone = "FORTROLIG"` eller
  strengere sammen med `[identitet]` avvises, fordi data du sender til
  mottakeren forlater Norge. Feltet er din eksplisitte erklæring om det, og du
  er behandlingsansvarlig for den dataflyten.

---

## Kredittkjøp på faktura: krediteres når betalingen er sett, synlig mens det venter (8. november 2026)

Kredittkjøp mot EHF-faktura ble ikke kreditert automatisk: avstemmingen leste
feil felt, så alle fakturaer så ubetalte ut. Rettet, og fakturaveien har fått
det Vipps-veien alltid hadde:

- Avstemmingen leser salgets innbetalte beløp og oppgjort-status (tapsføring
  teller ikke som betaling) og kjører hvert kvarter. Kreditten vises i
  `GET /v1/konto/oversikt` og i portalen samme kvarter som innbetalingen er
  avstemt mot bank.
- `GET /v1/konto/oversikt` bærer `ventendeFakturaer` per konto når et
  kredittkjøp venter på betaling (ref, beløp, fakturanummer, forfall,
  forfalt). Portalens Penger-side og `nysky konto` viser «venter på
  betaling». Feltet finnes kun når det er noe å vise.
- Når betalingen er registrert og kreditten postert, utstedes en kvittering
  (`betaltVia: "faktura"`) i samme serie som Vipps-kvitteringene, og den
  sendes på e-post etter kontoens varselvalg.
- Forfalt, ubetalt faktura varsler nysky én gang og lukkes automatisk når
  betalingen kommer. Den ventende fakturaen markeres «forfalt» i portalen.

---

## Kontrakt 0.2.85 — workerd-apper får 256 Mi minne som standard (8. november 2026)

**Hva:** utelater du `[limits] memory_mb`, får en app på egen kapasitet
(workerd) nå **256 Mi**, før 128. Container-apper har fortsatt 512. En
eksplisitt verdi vinner som før.

**Hvorfor:** ved 128 Mi ble 13 apper OOM-drept flere ganger daglig, hver gang
et kort avbrudd, og planlagte kall som traff en app i det den døde, feilet.
256 Mi er fortsatt innenfor samme pris (satsen regner inntil 512 Mi).

**For deg som agent:** ingenting å gjøre. Har du satt `memory_mb = 128`
eksplisitt for å «være nøktern», fjern linjen — plattformens default er
bedre enn gjetningen. Ser du fortsatt `OOMKilled` i `nysky status`, sett
`memory_mb = 512`.

---

## Rettelse — MCP-broen svarer igjen på mcp.nysky.no (8. november 2026)

Adressen `mcp.nysky.no` har vært uten rute siden 12. september: appens
manifest hadde ingen eksplisitte `routes`, så en redeploy ga den bare
auto-adressen `mcp.nyapp.no`, og TLS på mcp.nysky.no feilet med ingress-
kontrollerens plassholdersertifikat. Rutene står nå eksplisitt i manifestet,
begge adresser svarer 200 med gyldig sertifikat. Connectorer som peker på
`https://mcp.nysky.no` virker uten endring; `mcp.nyapp.no` består som
overgangsadresse.

---

## Rutekonflikt avvises i plan og deploy; avviste ressurser blir synlige (8. november 2026, kontrakt 0.2.84 uendret)

**Hva:** to apper kan ikke ha samme vert og sti i `routes`. Før ble en slik
app godtatt av API-et, men ruten ble avvist av plattformen, og appen sto
`Pending — Desired state accepted` på ubestemt tid uten forklaring. Årsaken
var at en eldre app i en annen konto fortsatt holdt vertsnavnet.

**Nå:** `POST /v1/apps/<navn>:plan` og deploy svarer `409 route-conflict`
med hvilken rute som er opptatt. Er holderen en app i din egen konto, står
navnet dens i svaret (og om den er slettemerket — parkerte apper holder
ruten til de slettes permanent med `nysky app slett <navn> --permanent`). Er
det en app i en annen konto, sier svaret bare det; deploy fra den kontoen og
fjern ruten der først. Samme vert med ulik sti er fortsatt lov.

**Operatoren:** avviser clusteret likevel en ressurs ved konvergering, får
appen `phase: Degraded` med condition `ResourcesApplied=False` og
clusterets melding i `status.message` — synlig i `nysky status` og
`GET /v1/apps/<navn>`. Ingen app blir stående stille i Pending igjen.

**Flytter du et domene fra en gammel app til en ny:** fjern ruten fra den
gamle appen (eller slett den permanent) FØR du deployer den nye. Plan
forteller deg nå om du har glemt det.

---

## NS-bytte for innflyttede domener med DNSSEC (5. november 2026, kontrakt 0.2.84 uendret)

**Hva:** `POST /v1/domene/<navn>/ns` mot plattformens navnetjenere virker nå
også for domener som kommer inn med DNSSEC (DS-post i .no) fra forrige
leverandør. Tidligere avviste Norid byttet med `2308 Data management policy
violation`, fordi registeret tester at de nye navnetjenerne serverer en
DNSKEY som DS-posten peker på — og sonen hos oss var usignert.

**Nå:** kuréren gjør byttet nedetidsfritt i fire steg: signerer sonen her,
publiserer vår DS ved siden av den gamle, venter DS-TTL (ca. 2 t 15 min), og
bytter så navnetjenere og fjerner forrige leverandørs DS. Domenet beholder
DNSSEC hele veien. Svaret på NS-kallet bærer en `merknad` som sier dette når
det kan gjelde. I ventetiden har domenet ingen `feil`; byttet er «planlagt»,
ikke feilet. Ikke kø et nytt NS-bytte i mellomtiden.

**Også:** Norids avslag inneholder nå registerets begrunnelse (ikke bare
koden), og `PUT /v1/domene/<navn>/dnssec {paa:false}` fjerner også DS vi
ikke selv publiserte.

**Nytt felt:** hvert domene i `innehav[]` fra `GET /v1/domene/mine` bærer
`paagaar` når en operasjon er åpen: `{type, status, startet, tidligst?,
grunn?, sisteForsok?}`. `status: "planlagt"` med `tidligst` er en villet
ventetid. `feil` gjelder alltid siste avsluttede operasjon. Full oppskrift
for innflytting: agent.md → «Flytte et domene inn».

---

## E-postinvitasjoner godtas i portalen (29. oktober 2026, kontrakt 0.2.84 uendret)

- **Inviterte uten CLI kommer inn:** ble du lagt inn på en konto med e-post
  (Folk / `nysky team add`), måtte du før kjøre `nysky login` for at
  invitasjonen skulle bindes til nysky ID-en din — i nettleseren sto du som
  «venter» og så ingen konto. Nå viser portalen invitasjoner som venter på
  dine verifiserte adresser (Vipps-adressen og bekreftede jobbadresser), og
  du godtar per konto. En nysky ID uten kontoer ser invitasjonene før
  «opprett konto».
- **Jobbadresser gjelder også for eierskap:** en gatet app uten allow-liste
  («kun kontoens utviklere») slipper nå inn en utvikler som er lagt inn på
  jobbadressen mens Vipps har den private. Før traff bare Vipps-adressen.
  `X-Nysky-Auth-User` blir adressen som traff, som for allow-listen.
- **For deg som agent:** ingen manifestendring. `nysky team add <jobbadresse>`
  virker nå for folk som bare bruker nettleseren; be dem åpne
  portal.nysky.no og godta.

## Portalen slapp bare plattformadmin inn (29. oktober 2026, kontrakt 0.2.84 uendret)

- **Feilretting i nysky ID-gaten:** portal.nysky.no har ingen allow-liste,
  og siden 0.2.70 betyr tom liste «kun kontoens utviklere». Portalens konto
  er plattformens egen, så alle andre nysky ID-er — også inviterte
  medlemmer på bedrifts- og prosjektkontoer — fikk avvisningssiden «ikke på
  allow-listen» etter at kontosidene flyttet dit 16. oktober. Gaten har nå
  en eksplisitt, operatørstyrt liste over åpne plattformflater; portalen
  slipper enhver autentisert nysky ID inn, og autorisasjonen skjer som før
  per sub i kontrollplanet. Kundeapper er uendret: tom liste er fortsatt
  «kun kontoens utviklere», og en allow-liste vinner alltid.
- **For deg som agent:** ingen manifestendring. Ber kunden deg om hjelp med
  «ingen tilgang til portalen», er dette rettet — be dem laste siden på nytt.

## `gate_stier` håndheves igjen på egen kapasitet (28. oktober 2026, kontrakt 0.2.84 uendret)

- **Feilretting i operatoren:** apper med `[auth] mode = "gate"` og
  `gate_stier` som kjører på egen kapasitet (`nivaa = "offentlig-stor"` og
  andre dedikerte nivåer) har siden 0.2.72 fått de gatede stiene servert
  ÅPENT — gaten svarte alltid ja. Nå gir de gatede stiene 302 til
  nysky ID-innlogging som dokumentert, og appen får `X-Nysky-Auth-User`
  bare når gaten har sluppet gjennom. Apper i den delte poolen var ikke
  rammet. Ingen manifestendring; bygde du en app som uventet var åpen på
  `/admin` e.l., er den nå lukket slik manifestet sier.

## Kundeportalen portal.nysky.no (16.–21. oktober 2026, kontrakt 0.2.84 uendret)

- **Alle kontosidene har flyttet fra auth.nysky.no til `portal.nysky.no`:**
  oversikt, apper, penger, folk, konto (hovedkonto + prosjekter, eierskifte),
  domener, første kjøp (`/kjop`) og opprettelse av bedriftskonto
  (`/bedrift/ny`). De gamle adressene (`auth.nysky.no/konto*`, `/bedrift*`,
  `/kjop`, `/folk`) svarer 301 til portalen; POST dit svarer 410.
  `konto.nysky.app` er avviklet.
- **Igjen på auth.nysky.no (nysky ID):** innlogging, passkeys og økter
  (`/settings`), CLI-godkjenning (`/cli`), jobbadresser, ID-innstillinger
  (`/konto/mer`, `/konto/slett`, `/konto/apper`), handlingsluka
  (`/handling/*`), invitasjon og overdragelse.
- **Penger er én side:** saldo, estimert månedspris og én knapp «Fyll på»
  (`/penger/fyll`: beløp → Vipps eller EHF-faktura (kun bedrift) → én gang
  eller fast, med autofyll som avkrysning). Faner Forbruk og Kvitteringer.
  `nysky pafyll` lenker dit med beløpet forhåndsutfylt.
- **Underkonto heter «prosjekt»** i alle menneskeflater. API-feltene
  (`kontotype: "underkonto"`, `POST /v1/konto/underkonto`) er uendret.
- **Overføring til annen eier** (`/bedrift/overfor`): mottaker på navn
  (kjente kontoer), org.nr, e-post eller telefon; e-post uten konto gir
  invitasjon; er du selv admin hos mottakeren, skjer eierskiftet direkte.
- **Vipps-returen for kjøp** (`NYSKY_KONTO_UI_BASE`) peker nå på portalen.
  Varsel-e-poster om lav saldo og parkerte apper lenker til
  `portal.nysky.no/penger/fyll`.

## Avbrutt Vipps-kjøp er ikke en oppsigelse (13. oktober 2026, kontrakt 0.2.84 uendret)

- **Problemet:** avbrøt du et kredittkjøp i Vipps-appen (avtalen gikk fra
  venter til stoppet uten å ha vært aktiv), satte plattformen likevel
  `oppsagtFra` på kontoen og startet oppsigelsesløypa — parkering ved
  periodeslutt og sletting etter 30 dager — for en konto som aldri hadde hatt
  betalt plan.
- **Nå:** et avbrutt kjøp er bare et avbrutt kjøp. Kontoen står på nivået
  den hadde (gratis), bestillingen ryddes, og ingenting parkeres eller
  slettes. Hendelsen føres som `betaling-avbrutt`.
- **Kredittabonnement:** å stoppe et kredittabonnement (`Kreditt 100` osv.)
  er slutt på påfyll, ikke oppsigelse av kontoen. Kreditten du har består, og
  appene kjører så lenge saldoen dekker dem. Gjelder både Vipps-stopp og
  `DELETE /v1/tenants/{tenant}/abonnement`. Kun en aktiv plan-avtale fra den
  gamle modellen (personlig/start) gir fortsatt oppsigelse ved stopp.

## Gratis konto uten kjøp for mennesker (12. oktober 2026, kontrakt 0.2.84 uendret)

- **Problemet:** et menneske som opprettet nysky ID og trykket «Kom i gang»
  landet på `auth.nysky.no/kjop`, der eneste valg var å kjøpe kreditt med
  Vipps. Gratis-veien (én app bak nysky ID, ingen betaling) fantes bare på
  aktiveringssiden agenter får via `POST /v1/onboard`.
- **Nå:** `/kjop` har «Gratis — 0 kr» som første og forhåndsvalgte kort.
  Kontoen opprettes på gratis-nivået uten betaling, og brukeren sendes rett
  til kontosiden. `POST /v1/hooks/id-kjop` godtar `plan: "gratis"` og
  svarer `status: "gratis"` (ingen Vipps-avtale opprettes).
- **For agenter:** ingenting endret. `POST /v1/onboard` + aktiveringslenken
  er fortsatt veien når du onboarder et menneske; be dem gjerne velge gratis.
- **Ikke endret:** gratis-nivåets grenser (1 app, kun eier, sover ved
  inaktivitet) og kredittplanene.

## Jobbadresser på nysky ID — allow-listen treffer jobbadressen (7. oktober 2026, kontrakt 0.2.84 uendret)

- **Problemet:** `[auth].allow` ble matchet mot nysky ID-ens e-post, som er
  Vipps-adressen — ofte privat. Eieren slapp inn `kari@firma.no`, Kari var
  logget inn som `kari@gmail.com`, og kom aldri inn.
- **Nå:** brukeren kan legge til inntil fem **jobbadresser** på nysky ID
  (`auth.nysky.no/jobbadresser`), hver bekreftet med engangskode på e-post.
  Gaten matcher allow-listen mot Vipps-adressen først, deretter de bekreftede
  jobbadressene. Avvisningssiden («Ingen tilgang») tilbyr «Legg til
  jobbadresse» og sender brukeren rett tilbake inn i appen når koden er
  bekreftet.
- **For appen din:** `X-Nysky-Auth-User` er nå **adressen som traff
  allow-listen** — jobbadressen når det var den eieren slapp inn, ellers
  Vipps-adressen som før. `X-Nysky-Auth-Sub` er uendret og fortsatt
  nøkkelen du skal lagre brukerdata på. Ingen manifestendring; en app med
  `@firma.no` i `allow` virker nå for ansatte som har bekreftet
  jobbadressen.
- **Den inviterte får beskjed:** `nysky allow add <app> kari@firma.no` sender
  nå Kari en e-post med appens adresse og hva som trengs for å komme inn
  (inkludert jobbadresse-veien). Et `@domene` har ingen mottaker og sender
  ingenting; `--stille` hopper over e-posten. Svaret fra
  `POST /v1/apps/{app}/auth/allow` har fått feltet `varslet`.
- **Ikke endret:** innlogging er fortsatt passkey/Vipps. Jobbadresser kan
  ikke brukes til innlogging eller gjenoppretting.

## Kontrakt 0.2.84 — egress med port, kall-målvakt (20. september 2026)

- **`egress` tar nå `vert:port`.** Uten port er det HTTPS (:443) som før.
  `egress = ["ocsp.buypass.no:80"]` åpner OCSP over HTTP. Én nettverksregel
  per port, ingen L7-inspeksjon — TLS er appens ansvar. Langlivede
  forbindelser holdes. `:443` normaliseres bort. Krever fortsatt egen
  kapasitet (Fri stor eller container), som før.
- **Ny feil `403 kall-target-shared`:** `[[kall]]` mot en app som kjører i
  delt kjøring avvises nå ved plan/deploy. Før gikk deployen gjennom og
  kallet feilet først i kjøretid (målappen har ingen intern tjeneste i
  poolen). Sett `nivaa = "offentlig-stor"` eller `runtime = "container"`
  på målappen og deploy den først — i en monorepo-gruppe: koble målappen
  før kalleren, eller løft den i en egen push. Flytter du målappen tilbake
  til delt kjøring senere, mister kalleren tjenesten (vakten kjører ved
  kallerens deploy).

## Skyøkter: innloggingsoppskrift for agenter i sky-containere (14. september 2026, ingen kontraktbump)

- **Ny seksjon i agent.md: «Skyøkter (Claude Code på web o.l.)».** Kjører du
  i en sky-container der mennesket ikke ser terminalen din: sjekk først om
  `NYSKY_API_TOKEN` er satt i miljøet (forhåndsoppsatt token = null
  innloggingsskritt); ellers kjør device-flyten og **lim ALLTID `verifyUrl`
  og `userCode` som ren tekst i chatsvaret** — mennesket kan sitte på mobil
  og godkjenner derfra med passkey.
- **Nettverkssperre i skymiljøer:** 403 fra egress-proxyen mot
  `api.nysky.no` betyr at mennesket må åpne `api.nysky.no`, `nysky.no` og
  `git.nysky.no` i miljøets nettverkspolicy. `auth.nysky.no` trengs ikke
  fra økten.
- **Deploy fra skyøkt = push-to-deploy:** miljøer med Node < 24 mangler
  zstd og kan ikke bundle lokalt — `nysky git deploy enable` lar
  plattformen bygge. MCP-broen består som eksperimentelt alternativ som
  ikke rammes av nettverkssperren.
- **Rettelse i agent.md:** tre API-eksempler (device-flyten og
  skjema-endepunktet) viste den bokstavelige teksten `${apiUrl}` i stedet
  for API-adressen.

## Kontrakt 0.2.83 — nysky ID har flyttet til auth.nysky.no (12. september 2026)

- **Atferdsendring, ingen nye felter:** innloggingen (nysky ID) bor nå på
  `https://auth.nysky.no`. OIDC-issueren for `[auth] mode = "app"` er
  `https://auth.nysky.no/` — appen din får den i `NYSKY_AUTH_ISSUER` som før
  og rulles ut på nytt av plattformen. **Har du hardkodet
  `https://auth.nysky.app/` som issuer, må du bytte** (les alltid env-en).
  Discovery: `https://auth.nysky.no/.well-known/openid-configuration`.
- **URL-felter i API-svar** (`verifyUrl` fra `POST /auth/device/start`,
  `lenke` fra overdragelse/invitasjon, handlingslukas `url`) peker nå på
  `auth.nysky.no`. `auth.nysky.app` svarer 308 til samme sti i minst seks
  måneder, men OIDC-flyter og bearer-kall reddes ikke av redirect.
- **Egress-allowlister:** apper med `[nett] egress = ["auth.nysky.app"]`
  (JWKS-henting) må legge til `"auth.nysky.no"`.
- **Mennesker:** passkeys laget før flyttingen er bundet til nysky.app og
  brukes via «Passkey fra nysky.app» på innloggingen; deretter lages en ny
  (ett trykk). Vipps virker som før.

## Kontrakt 0.2.82 — sone FORTROLIG krever egen kapasitet (11. september 2026)

- **Atferdsendring, ingen nye felter:** et manifest med `sone = "FORTROLIG"`
  avvises nå i delt kjøring med problem-typen `sone-requires-dedicated`
  (403) — i `:plan`, `PUT`, git push og PR-previews. Naboskillet i delt
  kjøring er V8-isolatgrensen; FORTROLIG data skal ha egen kapasitet i
  sandkasse.
- **Løsning:** sett `nivaa = "offentlig-stor"` (Fri stor) eller
  `runtime = "container"` — eller senk sonen til `ÅPEN`/`INTERN` hvis appen
  ikke behandler skjermingsverdige data. `sone` utelatt betyr `INTERN` og
  påvirkes ikke.
- Plattformen flytter aldri en FORTROLIG-app tilbake til delt kjøring, selv
  ved lav trafikk. En eksisterende FORTROLIG-app på Fri-nivået i delt
  kjøring flyttes til egen kapasitet uten prisendring; en på Personlig/
  Gruppe består i drift, men neste deploy avvises til kapasitet eller sone
  er valgt.
- `STRENGT_FORTROLIG` avvises fortsatt helt.

## Kontrakt 0.2.81 — testbruker: automatisert testing bak nysky ID (11. september 2026)

- **Bots kan nå teste PR-previews bak nysky ID** uten passkey, Vipps eller
  menneske. Previews (`<app>-pr-<n>`) stoler på en EGEN test-issuer
  (`https://auth-test.nysky.app/`, egne nøkler); prod-apper gjør det aldri.
  Koblingen er avledet av at appen ER et preview — ingen manifestfelt.
- **`POST /v1/previews/{navn}/testbruker`** (deploy-scope) gir en HMAC-billett
  (1 time, bundet til previewets klient) for en deterministisk syntetisk bruker
  (`sub=u_test_…`, e-post under `.test.nysky.invalid`), valgfrie roller.
  Bruk: `POST <issuer>/billett` (cookie) eller `Authorization: Bearer` på
  `<issuer>/login`, så appens vanlige innlogging (gate: `/oauth2/start?app=…`;
  app-modus: OIDC mot previewets `NYSKY_AUTH_ISSUER`). CLI: `nysky preview
  testbruker <navn> [--rolle r]`. MCP: `preview_testbruker`.
- **Merking:** claim `nysky_test=true`/`amr=["ci"]`, gate-header
  `X-Nysky-Auth-Test: 1` (uforfalskbar — alltid satt av gaten). Appen kan nekte
  testidentiteter. Allow-listen gjelder mennesker; testidentiteter slipper inn
  på previewet, aldri på prod.
- **Mennesker logger inn på previews som før** (test-innloggingen federerer til
  ekte nysky ID). **Datavakt:** testbruker og klone av ekte data utelukker
  hverandre per preview (409 begge veier).
- **Previews-listen** (`GET /v1/apps/{app}/previews`) viser nå previewets
  faktiske URL (arvet domene) og aktive `klone`/`testbruker`.
- **Rettelse — PR-previews på eldre repoer:** Forgejo-repoer koblet før
  0.2.54 hadde webhooks med kun `push`, så en PR bygde aldri noe preview
  (stille). Plattformen reparerer nå slike hooks selv (ved oppstart og daglig),
  så `nysky git deploy enable` trenger ikke kjøres på nytt.
- **Git-tokenet følger innloggingen.** `nysky git login` gir nå et token
  per økt som utløper samtidig med login-sesjonen (`--varighet`). Flere
  økter på samme nysky ID (terminal + agent) lever side om side — før drepte
  den siste innloggingen de andres token. Utløpte tokens ryddes ved neste
  `git login` og ved `logout --overalt`.
- **Sandkasse-CI-tokens utløper etter 90 dager.** Agenten ber om nytt via
  samme underkonto-luke. Manuelt mintede CI-tokens er som før.
- **Testbruker-billett kan vare inntil 8 timer:** `timer` (1–8) i
  `preview_testbruker` / `nysky preview testbruker --timer`.
- **Bindinger til slettede repoer sovner, og vekkes av seg selv.** Er repoet
  borte i nysky Git, legges deploy-bindingen i søvn (vises som `sovende` i
  `GET /v1/gitops/bindings` / `nysky git deploy list`). Kommer repoet
  tilbake innen 30 dager, vekkes bindingen og webhooken gjenskapes automatisk
  — ingen `enable` nødvendig. Etter 30 dager slettes den. Koblet du repoet på
  nytt i mellomtiden, vinner den nye koblingen.

## Kontrakt 0.2.80 — valgfri token-varighet + GitHub-import/-synk (6. september 2026)

- **Rettelse 11. september — planlagt deploy i monorepo:** en enkeltplan
  (`deploy_planlegg` / `nysky preview planlegg` uten PR-gruppe, eller
  eksplisitt digest+repo+commit) for en app med manifest-sti i bindingen
  feilet ved utførelse med «fant ikke nysky.toml i <repo>@<commit>» — planen
  lette i repo-roten. Nå arver planen stien fra bindingen. Feilede planer må
  lages på nytt (`deploy_planlegg` igjen); ingen manifest- eller API-endring.
- **`nysky login --varighet 90d|36t|2d12t`**: token-levetiden kan settes fritt
  opptil 365 døgn (standard fortsatt 7 døgn). Varigheten VISES og godkjennes av
  mennesket på innloggingssiden; over 7 døgn vises en langlevd-advarsel der.
  API: `POST /v1/auth/device/start` tar `varighetTimer` (heltall 1–8760).
  «Logg ut overalt» (`nysky logout --overalt`) dreper også langlevde tokens —
  tilgangsepoken er uavhengig av TTL (testfestet).
- **`nysky git import <github-url> [--navn] [--pat-stdin]`**: engangs-import av
  et GitHub-repo til nysky Git (brukerens eget Forgejo-token; PAT for private
  repo leses kun fra stdin). Ingen videre kobling til GitHub etterpå.
- **`nysky git synk <github-url> [--navn] [--intervall 10m|1t|8t|24t]`**:
  LØPENDE synk fra GitHub (Forgejo pull-mirror, standard hver time). Primes av
  CLI/agent via `POST /v1/git/synk`, men godkjennes ALLTID av mennesket i
  handlingsluka (ny handlingstype `github-synk`) — med passkey og tydelig
  advarsel: nysky kan ikke garantere for hvor GitHub lagrer koden eller
  hvordan den håndteres der. GitHub-PAT for private repo limes inn I LUKA av
  mennesket (aldri via agent, aldri lagret). Kombiner med
  `nysky git deploy enable` for push-to-deploy fra GitHub-endringer.
  **`nysky git synk hent <eier>/<repo> [--branch <gren>]`** henter fra GitHub
  umiddelbart, utenom intervallet (f.eks. en deploy du vil sjekke raskt) —
  trigger mirror-sync og venter kort på at HEAD flytter seg; webhooken/
  deployen følger som ved ordinær sync. Hele kjeden GitHub-push → mirror-sync
  → webhook → deploy er E2E-verifisert i produksjon.
  **`nysky git deploy now <app>`** (og `POST /v1/apps/:name/gitops/kjor`)
  ruller ut grenens nåværende HEAD uten nytt push — første deploy etter en
  (om)kobling trenger ikke lenger en tom commit, og `--deploy-now` på
  enable virker nå også for GitHub-speil. Container-apper i monorepo bygges
  nå med appens undermappe som byggkontekst (som `docker build` lokalt) —
  standalone-Dockerfiler kan flyttes inn uendret.

## Kontrakt 0.2.79 — arv-adresser viderekobles til nyapp.no (6. september 2026)

- Eksisterende apper flyttes fra `<app>.nysky.app` til `<app>.nyapp.no`,
  og den gamle adressen **308-viderekobles** til den nye (308 bevarer
  metode og kropp — POST-er, webhooks og API-kall overlever flyttingen).
- Bedrifts-sti-adresser (`<bedrift>.nysky.app/<prosjekt>/<app>/`) og egne
  domener (`[[routes]]`) berøres **ikke** — kun de plattformgitte
  `<app>.nysky.app`-adressene flyttes.
- Appen er nåbar på begge domener gjennom hele flyttingen; ingen lenke
  brekker. `nysky.app` beholdes som viderekobling på ubestemt tid.
- Som før: **les appens faktiske adresse fra `status.url`**, ikke fra et
  antatt domene.
- **MCP-broen bor på `mcp.nysky.no`** (plattformflate — flyttet fra
  app-domenene 6. september; mcp.nyapp.no består som overgangsadresse, og
  navnet «mcp» er reservert på apps-domenene). Eksisterende tilkoblinger
  pekes om til https://mcp.nysky.no.

## Kontrakt 0.2.78 — nytt app-apex: nye apper får <app>.nyapp.no (6. september 2026)

- **Nye rutefrie apper** annonseres nå på `https://<app>.nyapp.no` (eget
  registrerbart domene for kundeinnhold — github.io-modellen).
  **Eksisterende apper beholder `<app>.nysky.app`**: adressen er
  materialisert i appens spec og STICKY — redeploys flytter aldri en app
  mellom domenene. Previews arver moderappens domene.
- **Ikke anta domenet i kode eller lenker** — les appens faktiske adresse
  fra `status.url` (API) eller `nysky status`.
- Eksplisitte `[[routes]]` under begge apps-domenene følger samme regel
  som før: kun `<app>.<domene>`; reserverte subdomener avvises.
- `nyapp.no` (apex) og `www.nyapp.no` viderekobles 301 til nysky.no.
- Alt annet er uendret: egendomener, gate/SSO, priser, kvoter.

## Kontrakt 0.2.77 — kjøpsluka: domenekjøp primes ferdig utfylt (5. september 2026)

- `nysky domene bestill <navn.no>` lager nå en FERDIG UTFYLT kjøpsluke i
  stedet for å avvise deg: nysky prefyller org.nr fra kontoens bedriftsfelt
  og e-post fra kontakten, og flaggene `--orgnr`/`--epost`/`--telefon`/
  `--ns` overstyrer. Registrant (Brreg) og ledighet (Norid) valideres ved
  priming — luka viser aldri en dødfødt bestilling.
- I luka gjenstår kun Norids egenerklæring (avhuking) og ett passkey-trykk.
  Riktig konto er alltid forhåndsvalgt (handlingen bærer den). Tom kreditt
  ved bekreftelse gir 402 og luka BLIR stående — fyll på og trykk igjen
  (TTL 1 time).
- API: `POST /v1/domene/{navn}/handlinger` med `type: "kjop"` (deploy-
  scope); poll `GET /v1/handlinger/{id}` til `utfort` —
  `resultat.bestillingId` følger bestillingen videre.

## Kontrakt 0.2.76 — hvert felt virker eller avvises (5. september 2026)

Full lovnadsrevisjon: alt dokumentert er nå enten implementert eller avvises
ærlig ved deploy. Endringene du må kjenne til når du bygger:

- **Egen kapasitet-krav (nytt):** `[[kall]]`, `[egress]`, `[http]`-verdier
  utover default (max_body_mb/response_timeout_s/sse) og
  `auth.client="confidential"` krever Fri stor eller Container. I delt
  kjøring avvises de i `nysky plan`/deploy med `*-requires-dedicated` —
  før validerte de og gjorde ingenting. `nivaa = "offentlig-stor"` (Fri
  stor) kan nå settes eksplisitt i manifestet.
- **Virker nå i delt kjøring:** `[[kv]]`-bindingen (`KV_<NAVN>_URL` var
  undefined før), `auth.mode="app"` med public-klient (issuer/client-id-
  bindingene injiseres), og `NYSKY_SLETT_SECRET` (slettekaskaden kan endelig
  verifiseres — den leveres også til apper uten egendomene nå).
- **Container-apper får `[vars]`** — de nådde aldri frem før.
- **`[limits]`-fella fikset:** `memory_mb` utelatt = 128 (workerd) / 512
  (container). Før kuttet en ren `cpu_m`-justering container-minnet til 128.
- **`[static]` + `main` avvises** — før ble `main` stille forkastet og
  alle API-ruter svarte 404. Frontend + API = worker-en server begge, eller
  to apper.
- **Strengere validering som fanger feil FØR drift:** ekte cron-schedule-
  validering (`"60 6 * * *"` avvises nå i stedet for å feile stille i
  driften), identifikatorlengde (app+datastore/bucket-navn over 63 tegn),
  reserverte `auth.methods`-verdier.
- **CLI:** `logs --limit`, `ovingsdata --antall` og `secret put --app`
  er ekte flagg (før: krasj); `nysky ci revoke <token-id>` finnes; feilende
  kommandoer viser diagnosen (CI-logg/rollout) i stedet for å kaste den;
  `secret request --json` returnerer luka umiddelbart med `dropUrl`
  (status `venter`); `nysky logs keygen` registrerer faktisk nøkkelen på
  kontoen (403-bug); `nysky tail` sier ærlig at den er avviklet.
- **API:** ukjente ruter svarer `404 not-found` (før 501 — nå betyr 501
  alltid «finnes, men ikke aktivert»); `GET /v1/konto/eksport` virker for
  `nysky login`-sesjoner (DPA §9-eksporten var 403 for alle);
  feilkatalogen i kontrakten er nå komplett.

## PostGIS er nå reelt tilgjengelig (4. september 2026)

- `extensions = ["postgis"]` i `[[datastores]]` har stått i allowlisten,
  men databaseimaget manglet PostGIS-binærene — `CREATE EXTENSION` feilet,
  og deployen med. Imaget er byttet (PostGIS 3.5), og hele allowlisten
  (pgcrypto, uuid-ossp, postgis, pg_trgm) er verifisert i produksjon,
  inkludert `geometry`/`geography`-kolonner og GiST-indekser.
- Ingen kontraktendring — feltet og allowlisten er uendret; det som var
  annonsert, virker nå.

## Kontrakt 0.2.75 — byggfeil forteller hvorfor, og hvem sin feil det er (3. september 2026)

- Feiler et container-bygg, bærer `GET /v1/apps/:name/build` nå `detail`
  (halen av byggeloggen) og `kilde` (`app` eller `plattform`).
  `kilde: "plattform"` betyr at feilen ligger hos nysky — ikke bruk tid på
  å feilsøke koden eller bytte basisimage; nysky er allerede varslet.
- `nysky deploy` viser årsaken direkte i feilmeldingen; push-to-deploy
  viser den i pipeline-status.

## Kontrakt 0.2.74 — selvbetjent container-aktivering (2. september 2026)

- Container-kjøretiden (390/790 kr/mnd) aktiveres nå selvbetjent: kjør
  `nysky container aktiver` (eller `POST /v1/konto/runtime/forslag`).
  Du får en lenke til bekreftelsesluken; kontoens menneske bekrefter med
  nysky ID (passkey), og tillegget er på — deploy appen på nytt etterpå.
- Feilmeldingen ved deploy av `runtime = "container"` uten tillegget
  peker nå på kommandoen i stedet for «kontakt eier/admin».
- Gjelder betalte kontoer; 409 hvis tillegget allerede er aktivert.

## Kontrakt 0.2.73 — kryptert logg også for container-apper (2. september 2026)

Container-apper (egen Dockerfile) har nå samme loggvei som workerd-appene:
stdout/stderr forsegles til kontoens loggnøkkel (eller `[logs].recipient`)
og leses med `nysky logs` — nysky lagrer kun chiffertekst. Apper uten
registrert nøkkel får ingen logg ut. Linjene ligger kort i en roterende
buffer på kryptert disk før de forsegles. Kontoens loggnøkkel arves nå av
ALLE runtimes ved deploy.

## Kontrakt 0.2.72 — faste jobber i delt kjøring, trinnbytte i luka, kjøreform er plattformens valg (2. september 2026)

1. **`[[crons]]` tvinger ikke lenger egen kapasitet.** Nye apper med faste
   jobber kjører på nivået sitt som alle andre (kallet går internt via
   plattformen; `X-Nysky-Cron-Key`-kontrakten er uendret). Eksisterende
   apper flyttes ikke — de kjører som før.
2. **Trinnbytte via bekreftelsesluken:** nærmer en app seg trafikkvoten,
   varsler plattformen og legger et FERDIG bytte til neste trinn i luka —
   mennesket bekrefter med nysky ID, ny sats fra neste døgntrekk. Aldri en
   stille prisendring; gjør du ingenting, gjelder 1 kr/GB over kvoten som
   før. Et bekreftet bytte huskes av plattformen og vinner over manifestets
   `nivaa` ved senere deploys (nytt bytte gjøres i luka).
3. **Boot-bevis for delte apper:** push-to-deploy avviser nå en bundel som
   krasjer ved modul-lasting (typisk nettverkskall, timere eller
   tilfeldighet i global scope — workerd forbyr det) FØR den slippes inn.
   Samme sjekk lokalt: `nysky dev --prove`.
4. **CLI-en:** nysky.no/cli publiseres nå automatisk ved hver
   kontraktutrulling (lå etter — beklager). Nytt i den: `dev --prove`,
   nettleseråpning virker på Windows, `secret put` spør etter verdien i
   interaktiv terminal (skjult), og en utløpt git-innlogging sier nå «kjør
   nysky git login på nytt» i stedet for rå 401.
5. **Kjøreformen for Fri-apper er plattformens valg innenfor trinnet:** en
   Fri-app med vedvarende høy trafikk kan flyttes til egen kapasitet — og
   tilbake — uten prisendring og uten at du gjør noe. `nysky plan` ruller
   aldri en plattform-flyttet app tilbake.

## Kontrakt 0.2.71 — posture-feltet er avviklet (2. september 2026)

`[posture]` i manifestet IGNORERES nå (godtas fortsatt, så eksisterende
manifester deployer uendret — fjern det gjerne). Loggsporet styres av
`[logs]` og kontoens loggnøkkel: appens logg krypteres til en nøkkel bare
kunden har (`nysky logs keygen` + `nysky logs`). `audit`-posture og
`nysky tail` for apper er avviklet; plattformens egne hendelser føres
fortsatt i det hash-kjedede revisjonssporet. Vilkår og databehandleravtale
er revidert (v1.3, /v1/avtaler) og beskriver den nye loggmodellen.

## Kontrakt 0.2.70 — Fri, ingen søvn på betalte nivåer, dvale kun som livssyklus (2. september 2026)

FIRE endringer fra bunnrevisjonen, alle live:

1. **49-trinnet heter «Fri»** (149-trinnet «Fri stor»). I manifestet skriver du
   fortsatt `nivaa = "offentlig"` (eller arv-navnene) — kun visningsnavnet er
   nytt. **Gruppe-nivået er nå åpent: 29 kr/mnd** (`nivaa = "gruppe"`).
2. **Betalte apper sover aldri.** Kun gratis-appen sover ved inaktivitet
   (vekkes automatisk på sekunder). Betalt nivå = alltid klar, uten vekking —
   det er oppgraderingsgrunnen. Cron-timesregelen på personlig/gruppe består
   som produktgrense.
3. **Gate med tom allow-liste = kun kontoens utviklere — på ALLE nivåer**
   (utvider 0.2.69, som gjaldt gratis/personlig/gruppe). Regelen er én setning:
   en gatet app uten liste er din; `nysky allow add` åpner den. En gatet
   Fri-app arver dermed samme vern som personlig — ingen nedgraderingsfelle.
4. **Valgfri dvale er avviklet.** `nysky app dvale` og
   `POST /v1/apps/:name/dvale` svarer 410. Betalte apper kjører til de sies
   opp. Dvale finnes nå kun som livssyklus: gratis-løpet (2 uker varsel → 3
   uker parkert → 180 d sletting) og betalings-dvale — går kreditten tom får
   du varsel, appene kjører i 7 dager til (udekket forbruk føres som
   utestående), så parkeres de og trekkes 0. Vekking skjer når ny kreditt
   dekker det utestående. 25 %-dvale-satsen er borte.

## Kontrakt 0.2.69 — personlig betyr kun deg (2. september 2026)

VIKTIG ATFERDSENDRING for gatede apper på gratis/personlig/gruppe (og
telt-arv): en TOM allow-liste slipper ikke lenger inn enhver autentisert
nysky ID — gaten slipper nå kun inn kontoens egne utviklere. Det er selve
personlig-løftet: appen din er din. Vil du dele, er allow-listen veien
(`nysky allow add venn@eksempel.no` — live, uten redeploy) — det er
gruppe-modellen. Apper med allow-liste (i manifestet eller lagt til
selvbetjent) endrer ikke oppførsel. Offentlig-nivåets valgfrie gate beholder
«enhver autentisert»-semantikken ved tom liste.

## Kontrakt 0.2.68 — kryptert logg virker nå også i delt kjøring (2. september 2026)

Loggmangelen fra 0.2.67 er lukket: apper i delt kjøring (gratis/personlig/
gruppe/offentlig i pool) med en logg-recipient — egen `[logs]` eller
kontoens nøkkel — får nå kryptert logg. Konsollen fanges i appens EGET
isolat, forsegles av en plattform-worker i shard-podden til DIN age-nøkkel,
og lagres som chiffertekst; `nysky logs` leser som før. Apper UTEN
recipient får konsollen forkastet i isolatet (før kunne den nå shard-podens
stdout). Gjelder fra neste deploy av hver app. Container-runtime har fortsatt
ingen loggvei i v0.

## Kontrakt 0.2.67 — kontoens loggnøkkel: kryptert logg som standard (2. september 2026)

Steget mot ett loggspor: kjør `nysky logs keygen` én gang, og kontoens
workerd-apper uten eksplisitt `[logs]` får kryptert logg som standard fra
neste deploy — forseglet i podden til DIN age-nøkkel; plattformen lagrer kun
chiffertekst og kan aldri lese. Privatnøkkelen lagres i `~/.nysky/logs-key`
(ta sikkerhetskopi — mistes den, kan ingen lese loggene). `nysky logs`
dekrypterer lokalt og finner nøkkelen selv. API: `PUT/GET/DELETE
/v1/logs/nokkel` (PUT/DELETE krever secret-tilgang). `nysky plan` viser
alltid loggspor-endringer. Eksplisitt `[logs]` i manifestet vinner;
registrerer du ingen nøkkel, endres ingenting (dagens zero-knowledge-default).
Avgrensning: apper i delt kjøring har ennå ingen per-app-loggvei (kommer),
og container-runtime har ingen loggvei i v0.

## Atferdsendring — sovende nivåer sover nå, og vekkes ved bruk (2. september 2026)

Ingen ny kontraktversjon. Apper på gratis/personlig/gruppe (delte, gatede
nivåer) legges nå i søvn når de har stått ubrukt i ~15 minutter, og VEKKES
AUTOMATISK ved bruk — målt i produksjon til ~4 sekunder. Nettlesere ser en
«nysky jobber»-side som oppdaterer seg selv; API-kall holdes i inntil ~8
sekunder og fullfører vanligvis i samme forespørsel (ellers 503 med
Retry-After — prøv igjen). Prisen er uendret (søvn er plattformens
kostnadsoptimalisering, ikke en nedgradering), `[[crons]]` kjører som
planlagt uansett, og offentlig/container står alltid oppe som før. Trenger
appen din å stå oppe kontinuerlig, er `nivaa = "offentlig"` nivået for det.

## Sammendrag 12. august – 1. september 2026 (0.2.40–0.2.66)

Kontrakten ble nullstilt 12. august 2026 (0.2.39); fra da sporer loggen
endringer som kan påvirke apper som kjører. Dette er det en agent fortsatt
trenger fra perioden. Hvordan plattformen virker nå står i agent.md.

- **Nivåer:** `[nivaa]` heter `personlig` (delt kjøring, alltid bak nysky ID),
  `gruppe` (som personlig, allow-listen er grensen) og `offentlig` (åpen).
  Gamle navn godtas som aliaser (telt=personlig, hytte/hus=offentlig).
  Nye apper uten `[nivaa]` er personlig.
- **Crons:** `[[crons]]` er tillatt på alle betalte nivåer. På personlig og
  gruppe må minuttfeltet være ett fast tall (0–59); brudd gir
  `cron-frequency-not-in-level`. Regelen gjelder også via git push.
- **`[auth] gate_stier`:** bare de oppgitte stiprefiksene (case-insensitive,
  ikke `"/"`) krever innlogging; resten er åpent og må tåle anonyme kall.
  Gjelder både appadressen og egne domener.
- **Previews:** en PR gir `<app>-pr-<n>` med egen datastore (skjema og
  syntetiske rader) og preview-secrets (`nysky secret put --preview`), aldri
  prod-secrets. 1 gratis preview per app i 7 dager, deretter halv nivåsats per
  døgn. `POST /v1/previews/{navn}/behold` forlenger. `[[routes]]`/`[[crons]]`
  strippes i previews. Én PR i en monorepo gir ett preview per app.
- **Planlagt deploy:** `POST /v1/apps/{navn}/planlagt-deploy` promoterer et
  grønt preview på et tidspunkt (2 min–30 dager), verifiserer og ruller
  tilbake ved feil. Én aktiv plan per app. Hent menneskets ja først.
- **Generalprøve:** `POST /v1/previews/{navn}/klone` gir en passkey-luke der
  mennesket godkjenner kloning av ekte data til et gatet preview (24 timer).
- **Monorepo:** `nysky git deploy enable` fra hver apps katalog legger appen
  til grenens utrullingsgruppe. Ett push ruller ut alle som én enhet: feiler
  noe, konvergeres ingenting, og er ikke alle friske etter 10 minutter, rulles
  alle tilbake. `409 gitops-binding-opptatt` hvis grenen er bundet til en
  annen app (`--force` flytter). `disable` uten `--branch` finner grenen selv.
- **Container-images** fra push-to-deploy tagges per commit i tillegg til
  `:latest`. Byggfeil viser stdout, og `sh` må finnes på PATH.
- **Delt kjøring:** `nysky status` kan svare `Degraded` (shard nede eller
  pool-karantene; karantenen slippes ved neste deploy). Manglende secret gir
  en app uten variabelen, aldri nedetid for naboene. Egne domener virker på
  delte apper. Apper på gratis/personlig/gruppe sover etter ~15 minutter og
  vekkes ved bruk (~4 s).
- **Innlogging:** `nysky login` og MCP-tilkoblinger gir kun kontoene mennesket
  krysser av; plattform-admin gis normalt ikke til agenter. Du kan få færre
  kontoer enn mennesket har. `POST /v1/auth/device/approve` krever
  `tenants[]`. «Logg ut overalt» (`nysky logout --overalt`,
  `POST /v1/auth/revoker`) ugyldiggjør alle sesjonstokens og git-tokens;
  CI-tokens (`nskci_`) revokeres separat. Får du plutselig 401, be om ny
  innlogging.
- **Flere kontoer på maskinen:** `plan`, `deploy`, `secret`, `app`, `allow`,
  `wake`, `ci`, `team`, `datastore` og `git` feiler med `konto-ambiguous` til
  du velger med `--konto` eller `NYSKY_KONTO`. Ukjent konto gir
  `konto-ukjent`. Ikke gjett konto.
- **Onboarding:** `POST /v1/onboard` returnerer `agentSecret`, som må sendes
  som `X-Nysky-Onboard-Secret` til `/v1/onboard/{orderId}/token` og aldri
  deles med mennesket. Veiene er gratis (1 app) eller Vipps; status
  `venter-betaling` betyr at mennesket er i Vipps. `tilbud` er kosmetikk
  (1–20 tegn).
- **Betalte nivåer dvaler aldri av seg selv.** Kun gratis-appen dvaler ved
  inaktivitet. Frivillig dvale (`nysky app dvale`) koster 25 % av
  månedssatsen og skal bare brukes når mennesket ber om det.
- **Hemmelighetsluke:** bundet til appens eier, 30 minutters levetid; feil er
  `secret-drop-unknown` (404), `secret-drop-used` og `secret-drop-expired`
  (410).
- **Priser og kvoter:** trafikk måles per app med månedskvote etter nivå
  (5/20/100/500 GB), 1 kr/GB over. `GET /v1/konto/oversikt` viser `egress`,
  `rabattProsent` og `reellSatsOre`; `GET /v1/konto/posteringer` og
  `/v1/konto/kvitteringer` gir historikk. `[[kall]]` er åpent for alle betalte
  kontoer. `nysky plan` viser `haandhevet` (gate, kapasitet, pris).
- **Domener:** .no-domener kjøpes selvbetjent (149 kr/år, auto-fornyelse).
  `GET /v1/domene/sjekk` gir navneregler og `ledig`. Soner og poster
  forvaltes med `GET/PUT /v1/domene/{navn}/poster` (apex krever
  menneske-grad). `POST /v1/domene/sone` oppretter sone for domener hos annen
  registrar (står `venter-ns` til delegeringen er på plass). NS-bytte,
  DNSSEC, fornyelse og overføring (`nysky domene overta`) går fra CLI/API;
  authkode ut vises kun i luka, aldri til agenten.
- **Konto fra CLI:** `nysky konto flytt|pafyll|kvitteringer|forbruk|varsler|eksport|avslutt`,
  `nysky app flytt`, `nysky bedrift inviter --trekk`, `nysky team add --kjopsrett`.
  Menneskelige steg er passkey-bekreftelser i luka. CI-tokens er rene lesetokens.
- **Sandkasse:** `POST /v1/konto/underkonto/forslag` foreslår en underkonto
  med budsjett; mennesket bekrefter, og scopet CI-token leveres én gang via
  `GET /v1/handlinger/{id}`.
- **E-post** sendes fra nysky.no (avsender no-reply@nysky.no).
- **Avtaler:** databehandleravtalen og bruksvilkårene har versjon og sha256 i
  `GET /v1/avtaler`.

Full historikk ligger i git.

---

## Kontrakt 0.2.39 — nullstilt 12. august 2026

Alt før denne datoen var utviklingsfasen. Fra 12. august 2026 har nysky reelle
kunder, og loggen sporer endringer som kan påvirke apper som allerede kjører.
Eldre historikk ligger i repoets git-historie.

**Gjeldende kontrakt står ALLTID i `X-Nysky-Contract`-headeren og øverst i
denne loggen.** Alt agent.md beskriver, gjelder uavhengig av hva som står her.
