c0py/AGENTS.md

C0PY — AGENTS.md

Repo-konventioner

• Package manager: pnpm (frozen-lockfile)
• Framework: Next.js (apps/web), Fastify (apps/api)
• TypeScript: strict mode, bundler module resolution
• CI: Gitea Actions — .gitea/workflows/ci.yml
• Deploy: Coolify via .gitea/workflows/deploy.yml
• Secrets: Infisical (vault.siax.io) — ALDRIG i repo
• Testing: vitest (apps/api, packages/*)
• Lint: eslint flat config
• OTel: not yet wired — add bootstrap at apps/api/src/index.ts entry when available
• Tenant: bound to session via CL0UD, NEVER from client input

Drift (Coolify)

• App UUID API: wvmn6eg40jofssvm3nigmav6, server6 — c0py-api.siax.io
• App UUID Web: 58pa82h4qlzcwsc4shreuwk0, server6 — c0py-web.siax.io (Dockerfile.web)
• Postgres UUID: qhucpjjpv3mx9jupqkbyf5uh, server6
• Images: <app-uuid>:latest (built on server6 from /tmp/c0py-build)
• Deploy: docker build -t <app-uuid>:latest . && cd /data/coolify/applications/<app-uuid> && docker compose up -d
• DNS: c0py-api + c0py-web → 65.109.19.146 (Cloudflare A, DNS-only — proxied ger TLS-fail på tredjenivå)
• Coolify API: POST /api/v1/applications/dockerfile (NOT /api/v1/applications)
• Health check: GET /health → 200 (wget-based, Fastify HTTP)
• ⚠️ c0py.siax.io apex är Worker-kapad ("Hello World!") — ej åtgärdbar utan Workers-perms
• Coolify dockerfile+git-buildpack: trasig för detta monorepo (build-context saknar repo-träd) — bygg manuellt

Kontrakt

• API-kontrakt: contracts/openapi.yaml
• Schema-versionshantering: semantisk versionering i packages/types
• Digital Twin Spec: docs/spec/DIGITAL-TWIN-SPEC.md (fullständig specifikation för webbplats-analys och identisk reproduktion)

Fällor

• NEXT_PUBLIC_* ska ALDRI innehålla hemligheter
• Alla writes till AUD0/ST0RE via klientskikt, aldrig direkt
• Crawling ska vara throttle-ad och respect robots.txt
• Docker COPY over build stages bryter pnpm-symlinks — kör pnpm install --frozen-lockfile i runtime-staget, lägg till tsx-symlink efteråt
• tsx är devDependency i @siax/c0py-api — pnpm länkar workspace-devDeps INTE till rot-nivå
• Auth: preHandler hook kollar Authorization: Bearer *-header, returnerar 401 annars
• GitHub push: använd gh auth login (keyring), INTE inbäddade tokens i URLs
• Coolify compose på disk kan vara stale — labels/port regenereras ej vid misslyckad deploy; sed:a compose-filen + docker compose up -d, och docker rm -f gammal container (den lever kvar vid recreate)