frontend-precision 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,46 @@
-# Temporary Holding Version
+# frontend-precision
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Cursor-first frontend precision toolkit: Playwright screenshots, pixel visual diff, configured test runs, and JSON/Markdown/HTML reports.
+
+## Install
+
+This package is not yet published to the npm registry. Install it from a
+local checkout or a generated tarball:
+
+```bash
+pnpm add -D /absolute/path/to/frontend-precision/packages/cli
+pnpm exec frontend-precision init
+pnpm exec playwright install chromium
+```
+
+After an npm release is verified, the supported registry command will be:
+
+```bash
+pnpm add -D frontend-precision
+```
+
+## Commands
+
+| Command | Purpose |
+|---|---|
+| `init` | Create config, Cursor Skill, rules, and templates (does not overwrite by default) |
+| `doctor` | Check Node, pnpm, config, baseUrl (2xx), references, Playwright, Skill |
+| `capture` | Screenshot configured routes |
+| `visual` | Compare screenshots to reference PNGs |
+| `test` | Run `testCommand` (and optional checks) and record results |
+| `report` | Aggregate capture/visual/test into `report.json` / `.md` / `.html` |
+
+Typical verify loop:
+
+```bash
+frontend-precision capture --run-id <id>
+frontend-precision visual --run-id <id>
+frontend-precision test --run-id <id>
+frontend-precision report --run-id <id>
+```
+
+Overall `report` status is `PASS` only when capture, visual, and tests all completed successfully. Missing stages yield `SKIPPED`; failures yield `FAIL`; `fixAttempts > maxFixAttempts` yields `BLOCKED`.
+
+## Docs
+
+See the repository root README for Skill workflow, Figma MCP notes, and the Vite demo walkthrough.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }