Quilib

Quilib is a TypeScript-first QA harness for analyzing web app quality gaps and generating actionable reports from real app + repo scans.

Current Status

MVP path is implemented end-to-end:

• CLI analyze flow is wired through observe -> think -> act.
• Playwright explorer performs route discovery and page signal capture.
• Repo scanner inventories routes/tests and Cypress structure.
• Gap engine computes deterministic quality gaps and release confidence.
• Reports are generated as JSON and Markdown.
• State and decision logs are persisted in .scan-state.

Tech Stack

• TypeScript (strict, NodeNext)
• Commander (CLI)
• Zod (schemas and validation)
• Playwright (URL exploration)
• fast-glob (repo analysis)
• Anthropic API integration (optional scenario generation)

Project Structure

src/
  adapters/      # test rendering adapters (playwright, cypress, api)
  cli/           # command-line entrypoint
  harness/       # state + decision logging contracts
  llm/           # LLM provider/context contracts
  phases/        # observe / think / act orchestration contracts
  reporters/     # output report contracts
  schemas/       # shared zod schemas + inferred types
  tools/         # explorers, gap engine, repo scanner contracts

Configuration

Primary config lives in quilib.config.ts and is typed with HarnessConfig.

Scripts

• npm run dev - run CLI entry (src/cli/index.ts)
• npm run analyze -- --url <app-url> [--repo <repo-path>] - run full analysis pipeline
• npm run build - compile TypeScript into dist/

Usage

# analyze app only
npm run analyze -- --url http://localhost:3000

# analyze app + repo
npm run analyze -- --url http://localhost:3000 --repo ../notquality-app

Validate Setup

npm install
npx tsc --noEmit

Output and State Folders

• .scan-state/ holds persisted scan state files.
• output/ holds generated reports.

Expected state files:

• .scan-state/discovered-routes.json
• .scan-state/repo-inventory.json (when --repo is provided)
• .scan-state/gap-analysis.json
• .scan-state/decision-log.json

Expected reports:

• output/report.json
• output/report.md