@stylecrib/cli 0.0.0-stage → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +78 -2
  2. package/dist/index.js +6068 -0
  3. package/package.json +62 -4
package/README.md CHANGED
@@ -1,3 +1,79 @@
1
- # Temporary Holding Version
1
+ # @stylecrib/cli
2
2
 
3
- 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.
3
+ Design upgrade for vibe-coded React apps. Installs 20 Claude Code subagents + a chosen theme from a 120-theme library into your repo. Refuses AI-default patterns at commit time.
4
+
5
+ Full mandate + rule catalog: [github.com/frischermf/stylecrib/blob/main/SLOP-BLOCKLIST.md](https://github.com/frischermf/stylecrib/blob/main/SLOP-BLOCKLIST.md).
6
+
7
+ ## Install + run
8
+
9
+ ```bash
10
+ # one-off
11
+ npx @stylecrib/cli init
12
+
13
+ # project-local
14
+ npm i -D @stylecrib/cli
15
+ npx stylecrib init
16
+
17
+ # global
18
+ npm i -g @stylecrib/cli
19
+ stylecrib init
20
+ ```
21
+
22
+ You'll need Claude Code on your PATH (default) OR `ANTHROPIC_API_KEY` set — `stylecrib check` (the pre-commit gate) uses one or the other to run the QA-conductor review.
23
+
24
+ ## What `stylecrib init` does
25
+
26
+ 1. **Wizard** — pick a base direction (from the 120-theme library or custom), name brand references, anti-references, a vibe sentence, optional URLs and reference images.
27
+ 2. **Ingest** — fetches URL content and reads images to feed the Director as multimodal context.
28
+ 3. **Director synthesis** — Anthropic call with the Director Feel-mode system prompt. Produces synthesized ethos, token plan, typography stack, full `DIRECTION.md`.
29
+ 4. **Writes** — `design-system/DIRECTION.md`, `.claude/agents/*.md` (19 agents including brief-enforcer + cto + vp-architecture + vp-engineering), and appends a routing block to your `CLAUDE.md` (creates one if missing).
30
+
31
+ Existing files are never overwritten. `--dry-run` shows the plan without writing.
32
+
33
+ ## What `stylecrib init` does NOT do (yet)
34
+
35
+ - **Install + wire the runtime provider files** — `<ThemeAdminProvider>`, `<SectionRegistryProvider>`, `<StyleCribAdmin />`, `<StyleCribSection>`. Those live in **[`@stylecrib/react`](https://www.npmjs.com/package/@stylecrib/react)** on npm as of 2026-08-13. `init` doesn't yet run `npm install` on your behalf or scaffold the wire-up code into your `App.tsx` — run `npm install @stylecrib/react` yourself and follow [docs/STYLECRIB_ADMIN.md](https://github.com/frischermf/stylecrib/blob/main/docs/STYLECRIB_ADMIN.md). Full automation is phase 4 of the runtime extraction.
36
+ - **Install a theme's runtime assets** — init picks a theme and writes its `DIRECTION.md`, but the theme's `tokens.ts` / `THEME.md` / `BUILD_BRIEF.md` files aren't copied into your repo. Fetch them from the [theme detail page](https://stylecrib.ai/themes) via the "Copy for Claude Code" button.
37
+
38
+ ## The pre-commit gate
39
+
40
+ `stylecrib install-hooks` wires:
41
+
42
+ - **Pre-commit hook** at `.git/hooks/pre-commit` → runs `stylecrib check --staged` on every commit. Diff-scoped: only NEW slop hits introduced by the commit block. Pre-existing debt in hot files doesn't stop new commits; that's the nightly-sweep report's job.
43
+ - **On-save hook** via `.claude/settings.json` → runs `stylecrib hook-check` on every Claude Code Write/Edit event.
44
+ - **CI gate** at `.github/workflows/stylecrib-review.yml` → runs the pack on every PR.
45
+
46
+ Emergency bypass (logs the reason for weekly review): `STYLECRIB_SKIP_QA="<reason>" git commit`. Never `--no-verify` — that leaves no audit trail.
47
+
48
+ ## Commands
49
+
50
+ - `stylecrib init` — install the pack + a theme
51
+ - `stylecrib check` — run the review loop against the current diff (called by pre-commit)
52
+ - `stylecrib apply` — run the Director synthesis to generate / regenerate a DIRECTION.md
53
+ - `stylecrib review-site` — walk every UI file and run the structural detectors (nightly sweep)
54
+ - `stylecrib install-hooks` — install the pre-commit + on-save + CI gates
55
+ - `stylecrib audit` — one-shot drift report against your existing repo (no install required)
56
+ - `stylecrib rule add` / `stylecrib rule share` — author + share slop rules
57
+ - `stylecrib harness *` — theme-materialization + grading (advanced)
58
+ - `stylecrib status` — show current install state
59
+ - `stylecrib reject "<pattern>"` — append to `.stylecrib/feedback.md`
60
+
61
+ ## The pack that ships
62
+
63
+ **Orchestrator (1):** qa-conductor
64
+
65
+ **Craft reviewers (13):** design-director, marketing-designer, motion-engineer, homogeneity-detector, audacity-director, media-curator, render-qa, art-director, brand-identity, brand-precedent, logo-designer, direction-curator, component-qa
66
+
67
+ **Craft writers (1):** design-systems-engineer
68
+
69
+ (`upgrade-simulator` is dogfood-only — powers the /try marketing surface at stylecrib.ai; not part of the review loop customers run inside their own repo. Retired from the customer bundle 2026-08-09.)
70
+
71
+ **Enforcer (1):** brief-enforcer — fires per-diff on any section-source change when a matching `themes/<slug>/BUILD_BRIEF.md` exists
72
+
73
+ **Exec auditors (3):** cto (claim-vs-code), vp-architecture (install-story), vp-engineering (ship-readiness)
74
+
75
+ Full architecture: [AGENTS_ARCHITECTURE.md](https://github.com/frischermf/stylecrib/blob/main/AGENTS_ARCHITECTURE.md).
76
+
77
+ ## License
78
+
79
+ Fair Source — free for personal use; commercial from $20/mo. See [LICENSE](https://github.com/frischermf/stylecrib/blob/main/LICENSE) (pending — see [TODO](https://github.com/frischermf/stylecrib/blob/main/TODO.md)).