onecrawl 4.0.0-alpha.57 → 4.0.0-alpha.59

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.
@@ -12,23 +12,36 @@ Enforce a strict iterative decision loop with consistent user checkpoints and ex
12
12
  - Hitting a decision point
13
13
  - Completing an autonomous run
14
14
 
15
- ## Checklist
16
- - Ask exactly one clear question per iteration.
17
- - Provide exactly 5 options:
18
- 1) Non-Breaking Path
19
- 2) Breaking Path
20
- 3) Alternative Structural Path
21
- 4) Freeform (set enum value to `custom` — allows the user to type a free-text direction inline)
22
- 5) Autonomous Mode
23
- - Mark the recommended (most future-proof) option.
24
- - At autonomous completion, ask for: rating, next action, satisfaction.
25
- - Continue iterating until the exact stop phrase is provided: **"I am satisfied"**.
15
+ ## Default 5-Option Structure
16
+ 1. **Recommended Development Path** (mark with star as most future-proof)
17
+ 2. **Alternative Development Path A**
18
+ 3. **Alternative Development Path B**
19
+ 4. **Freeform** — set enum value to `custom` (allows free-text input)
20
+ 5. **Autonomous Mode**
26
21
 
27
- ## Short examples
28
- - Start-of-task question: "Which path should I execute first?" (5 options above).
29
- - End-of-run question: "Rate this result, choose the next action, and confirm satisfaction."
22
+ ## Escalation (Compatibility Triad)
23
+ Use ONLY when there is a concrete compatibility/contract impact:
24
+ 1. Non-Breaking Path
25
+ 2. Breaking Path
26
+ 3. Alternative Structural Path
27
+ 4. Freeform
28
+ 5. Autonomous Mode
29
+
30
+ ## Option Card Format
31
+ Each option must include:
32
+ `<Title> — Why: <reason> | Leads to: <next step> | Risk: <low|medium|high>`
33
+
34
+ ## Rules
35
+ - One clear question per iteration
36
+ - Exactly 5 options every time
37
+ - Option 4 is ALWAYS Freeform (hard invariant)
38
+ - Options 1-3 carry forward from previous iteration unless explicitly replaced
39
+ - Mark recommendation with star; explain changes
40
+ - At autonomous completion: ask for rating, next action, satisfaction
41
+ - Loop stops ONLY on exact phrase: "I am satisfied"
30
42
 
31
43
  ## Anti-patterns
32
44
  - Multi-question prompts in one iteration
33
- - Missing one or more of the 5 mandatory options
45
+ - Missing or renaming Freeform option
34
46
  - Stopping without explicit "I am satisfied"
47
+ - Using compatibility triad as default (it's an escalation)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "onecrawl",
3
- "version": "4.0.0-alpha.57",
3
+ "version": "4.0.0-alpha.59",
4
4
  "description": "Browser automation engine — CLI, MCP server, and agent skills installer",
5
5
  "license": "BUSL-1.1",
6
6
  "author": "Giulio Leone <giulio@onecrawl.dev>",