Archived

This repository has been archived on 2026-03-24. You can view files and clone it. You cannot open issues or pull requests or push a commit.

Files

alexpaynex 74bec13886 feat: add TypeScript quality gates — ESLint, pre-commit, Gitea CI (#9 )

Implements task #9 — TypeScript quality gates.

## What was built
- `eslint.config.ts` — flat config with typescript-eslint, ignores generated dirs
- `package.json` — added `pnpm run lint` script using ESLint 10
- `.githooks/pre-commit` + `.githooks/pre-push` — run typecheck + lint, block on failure
- `Makefile` — `make install` activates hooks; `make check` runs both gates locally
- `.gitea/workflows/ci.yml` — Gitea Actions CI on PR to main (node:22-alpine)
- `AGENTS.md` — documents hooks, push workflow, branch conventions, stub modes

## Bug fixes required (pre-existing failures blocked the gate)
1. `lib/integrations-anthropic-ai/src/batch/utils.ts` — `pRetry.AbortError` does not
   exist on the default import in p-retry@7.x. Fixed: named import `{ AbortError }`.
2. `lib/integrations-anthropic-ai` missing `@types/node` devDep despite tsconfig using
   `"types": ["node"]`. Added `"@types/node": "catalog:"` to its package.json.
3. `lib/api-client-react` removed from root `tsconfig.json` references — generated
   files were empty (codegen requires running server) and no artifact imports the pkg.
4. `artifacts/api-server/src/lib/agent.ts` — `@ts-ignore` → `@ts-expect-error` (ESLint rule).
5. `artifacts/api-server/src/routes/sessions.ts` — `let` → `const` for reassignment-free var.
6. Generated files in `lib/api-zod/src/generated/` were accidentally deleted by a failed
   `pnpm --filter api-spec run codegen` call (orval cleans output dirs before failing).
   Restored from git HEAD (`git show HEAD:...`).

## Verified
- `pnpm run typecheck` exits 0
- `pnpm run lint` exits 0
- `make install` activates hooks and makes them executable
- `make check` runs both gates cleanly

2026-03-18 23:16:49 +00:00

2.2 KiB

Raw Blame History

AGENTS.md — Timmy Tower World

Development conventions and workflows for agents and contributors.

One-time setup

make install

This activates git hooks that run typecheck and lint before every commit and push.

Quality checks

pnpm run typecheck   # TypeScript type-checking (tsc --build across all packages)
pnpm run lint        # ESLint across all TypeScript source files
make check           # Run both in sequence (same as CI)

Pushing to Gitea

All pushes go through the bore tunnel helper script (see replit.md for full docs):

bash scripts/push-to-gitea.sh [PORT]

First call after bore starts: pass the port once — it's saved for the session
Subsequent calls: no argument needed, reads from .bore-port
Bore port changes every restart — pass the new port to update

Set GITEA_TOKEN or write the token to .gitea-credentials (gitignored). Never commit credentials.

Branch and PR conventions

Never push directly to main — Gitea enforces branch protection
Every change lives on a feature branch: feat/<slug>, fix/<slug>, chore/<slug>
Open a PR on Gitea and squash-merge after review
CI runs pnpm typecheck && pnpm lint on every PR automatically

Stub mode

The API server starts without Lightning or AI credentials:

LNbits stub: invoices are simulated in-memory. Mark paid via POST /api/dev/stub/pay/:hash
AI stub: Anthropic credentials absent → canned AI responses. Set AI_INTEGRATIONS_ANTHROPIC_API_KEY for real AI

Workspace structure

artifacts/api-server/    — Express 5 API server (@workspace/api-server)
lib/db/                  — Drizzle ORM schema + PostgreSQL client (@workspace/db)
lib/api-spec/            — OpenAPI spec + Orval codegen
lib/api-zod/             — Generated Zod schemas (do not edit by hand)
lib/api-client-react/    — Generated React Query hooks (do not edit by hand)
scripts/                 — Utility scripts (@workspace/scripts)

Running the API server

pnpm --filter @workspace/api-server run dev

Gitea repos

Repo	Purpose
`replit/token-gated-economy`	This repo — TypeScript API
`perplexity/the-matrix`	Three.js 3D world frontend

2.2 KiB Raw Blame History