@hobin/developer 0.1.6 → 0.1.8
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.
- package/README.md +127 -95
- package/SOURCES.md +8 -8
- package/extensions/developer.ts +1752 -1441
- package/extensions/machine.ts +418 -286
- package/extensions/references/behavior-preserving-structural-change.md +14 -13
- package/extensions/state.ts +463 -419
- package/extensions/tool-policy.ts +158 -65
- package/extensions/tui.ts +1666 -910
- package/package.json +1 -1
- package/skills/sketch/references/responsibility-and-variation.md +1 -1
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
# Behavior-Preserving Structural Change
|
|
2
2
|
|
|
3
|
-
Use this protocol only after
|
|
4
|
-
movement and its stable landing. It governs that single
|
|
5
|
-
it does not discover the move, approve an abstraction,
|
|
6
|
-
a multi-step implementation queue across landings.
|
|
3
|
+
Use this protocol only after an `implementation` route has justified one
|
|
4
|
+
concrete structural movement and its stable landing. It governs that single
|
|
5
|
+
green-to-green mutation; it does not discover the move, approve an abstraction,
|
|
6
|
+
decide its timing, or carry a multi-step implementation queue across landings.
|
|
7
7
|
|
|
8
8
|
## Entry Contract
|
|
9
9
|
|
|
@@ -19,7 +19,7 @@ Stop: the next stable, pausable state
|
|
|
19
19
|
```
|
|
20
20
|
|
|
21
21
|
If the behavior claim, timing, or candidate is still under judgment, close or
|
|
22
|
-
pause the
|
|
22
|
+
pause the implementation route and route that question to the appropriate leaf.
|
|
23
23
|
|
|
24
24
|
## Smallest Green Transformation
|
|
25
25
|
|
|
@@ -49,8 +49,8 @@ Within the routed movement:
|
|
|
49
49
|
2. inspect the diff for mixed behavior and structural changes;
|
|
50
50
|
3. reduce the step when the failure cannot be explained locally;
|
|
51
51
|
4. return to the declared green, deployable stable landing;
|
|
52
|
-
5. close the
|
|
53
|
-
question instead of following a predetermined final design.
|
|
52
|
+
5. close the implementation route there and let Developer re-observe and route
|
|
53
|
+
the next question instead of following a predetermined final design.
|
|
54
54
|
|
|
55
55
|
A passing test is useful only when it exercises the preserved behavior. When no
|
|
56
56
|
cheap verifier exists, keep the movement smaller and record the residual risk.
|
|
@@ -65,15 +65,16 @@ A stable landing is not merely a green command. It is a state where:
|
|
|
65
65
|
- the diff has one explainable structural purpose;
|
|
66
66
|
- the next decision can be made from the new evidence.
|
|
67
67
|
|
|
68
|
-
Stop and close the
|
|
69
|
-
work remaining. Developer must select the next movement or focused
|
|
70
|
-
the new evidence. Further caller movement, cleanup, polymorphism,
|
|
71
|
-
or public abstraction requires another route and its own current
|
|
68
|
+
Stop and close the implementation route there even when the wider accepted task
|
|
69
|
+
still has work remaining. Developer must select the next movement or focused
|
|
70
|
+
judgment from the new evidence. Further caller movement, cleanup, polymorphism,
|
|
71
|
+
factory design, or public abstraction requires another route and its own current
|
|
72
|
+
pressure.
|
|
72
73
|
|
|
73
74
|
## Reroute Conditions
|
|
74
75
|
|
|
75
|
-
Close
|
|
76
|
-
when the movement reveals:
|
|
76
|
+
Close the implementation route at the latest stable landing and open a focused
|
|
77
|
+
judgment when the movement reveals:
|
|
77
78
|
|
|
78
79
|
- an unexpected product behavior or policy choice: `specify`;
|
|
79
80
|
- missing cases, transition rules, or replacement obligations: `model`;
|