@whisperr/wizard 0.7.4 → 0.9.0

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 +23 -18
  2. package/dist/index.js +1809 -546
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -13,22 +13,25 @@ hands you a clean diff to review and commit.
13
13
 
14
14
  ## How it works
15
15
 
16
- The wizard is an agentic integrator with a planner/editor split:
17
-
18
- 1. **Plan** — one read-only pass charts your repo (entry points, end-user vs
19
- admin auth flows, billing surfaces, existing analytics wrappers) and
20
- decides, per event, exactly where it belongs (`file @ anchor`) with the
21
- properties available in scope or says honestly that it doesn't exist on
22
- this surface. It also notes churn-relevant moments your plan is missing.
23
- 2. **See the plan** — every placement is printed before a single line
24
- changes. The run then proceeds on its own; pass `--review-plan` if you'd
25
- rather confirm placements first, or `--propose-only` to keep new
26
- events/interventions behind dashboard approval instead of adding them.
27
- 3. **Wire** — a fast editor model executes the plan mechanically.
28
- 4. **Review** the agent re-reads its own diff and fixes wrong subjects,
29
- wrong lifecycle moments, and missing discriminators.
30
- 5. **Verify** — placements are scanned back out of the diff, your build/lint
31
- command runs, and failures get one automatic repair pass. Every event ends
16
+ The wizard is an agentic integrator with task-aware hybrid routing:
17
+
18
+ 1. **Survey** — Opus 5 low/fast maps the stack, feature areas, auth lifecycle,
19
+ existing analytics, and integratable call sites into a source-free run
20
+ artifact.
21
+ 2. **Design** a separate Opus 5 low/fast session designs and validates the
22
+ complete event batch from that saved survey. The batch is frozen and
23
+ registered atomically; there is no terminal event-approval prompt.
24
+ 3. **Set up** another isolated Opus 5 low/fast session installs and initializes
25
+ the SDK, binds generated wrappers, wires `identify()` for login/restoration,
26
+ and wires `reset()` for logout.
27
+ 4. **Wire** — Terra 5.6 medium/priority runs a rolling queue of up to four
28
+ file-isolated edit clusters, with no more than four events per cluster and
29
+ no concurrent edits to the same file.
30
+ 5. **Review** — Sol 5.6 medium/priority reviews file-isolated event placements
31
+ for outcome timing, deduplication, payload correctness, PII safety, and
32
+ wrapper usage, repairing only failed files.
33
+ 6. **Verify** — the wizard runs the repository's available typecheck, lint, and
34
+ build scripts. Sol gets at most two targeted repair cycles. Every event ends
32
35
  the run as `✓ wired @ file` or `○ skipped — reason`.
33
36
 
34
37
  Multi-surface aware: run it in your web app, then your mobile app, then your
@@ -65,8 +68,10 @@ Options:
65
68
  -v, --version Show version
66
69
  ```
67
70
 
68
- Environment knobs: `WHISPERR_WIZARD_PLANNER_MODEL`,
69
- `WHISPERR_WIZARD_BUDGET_USD` (default 25), `WHISPERR_WIZARD_EFFORT`.
71
+ Environment knobs: `WHISPERR_WIZARD_ENGINE_<TASK>_MODEL` (for example
72
+ `WHISPERR_WIZARD_ENGINE_DESIGN_MODEL`), `WHISPERR_WIZARD_BUDGET_USD`
73
+ (default 25), `WHISPERR_WIZARD_EFFORT`.
74
+ Set `WHISPERR_WIZARD_PRESET=claude-default` for the Opus-only rollback preset.
70
75
 
71
76
  ## Safety
72
77