pre codex

This commit is contained in:
2026-05-25 12:51:14 +03:00
parent 6ed45a00d5
commit b778eaa2fb
8 changed files with 1164 additions and 68 deletions
+31 -17
View File
@@ -1,27 +1,41 @@
---
name: phase-2-locomotion-pending
description: "Pending skill stub for future safe movement/follow/coordinate requests. Use to remember that locomotion is intentionally out of scope during phase 1 and must be escalated."
when_to_use: "Use when someone asks the bot to come somewhere, follow a player, or go to coordinates before phase 2 is implemented."
name: phase-2-locomotion
description: "Use guarded Mineflayer pathfinder movement for trusted/sanctioned coordinate requests, with distance, focus, and hazard rails."
when_to_use: "Use when a scope-trusted operator or repo-sanctioned skill asks the bot to come somewhere, follow a safe coordinate instruction, or go to coordinates."
---
# Phase 2 Locomotion Pending
# Phase 2 Locomotion
Status: pending.
Status: implemented pending bridge reload.
Locomotion is intentionally out of scope for the current session. Do not add movement/pathfinder tools yet.
The bridge now registers `mc_goto` using `mineflayer-pathfinder`.
For now, if non-operator chat asks the bot to move, follow, or go to coordinates:
## Rails
1. Use `mc_log_escalation(...)`.
2. Explain in `why_unsure` that safe pathing/distance bounds are not implemented yet.
3. Do not move.
- Refuses targets farther than `MAX_TRAVEL_BLOCKS` from current position (default `500`).
- Keeps one active world-task lock; do not context-switch while walking/building.
- Uses safe movements:
- no digging;
- no scaffold placement;
- no 1x1 towers;
- no parkour;
- max drop-down of 2;
- avoids water/lava/fire/magma/cactus/campfire/berry/powder-snow/cobweb hazards.
- Refuses if health or food is critically low.
- Supports `dry_run` for path preview.
If a scope-trusted operator asks, do not log a scope escalation. Reply that you will try to learn, then draft or update the guarded locomotion skill plan. Do not actually move until safe pathing tools and rails exist.
## Use
Future phase-2 implementation should include:
For a scope-trusted operator request such as `go to 100 64 -200`:
- `mineflayer-pathfinder` with safe goals;
- max travel distance bounds;
- focus/lock while traveling;
- lava/void/claim avoidance;
- clear refusal messages when travel is unsafe.
1. Confirm it is not a hard-safety issue.
2. Check no active world task is running (`mc_status`).
3. Call `mc_goto({ x, y, z, range })`.
4. If it fails, report the blocker in chat instead of forcing movement.
For non-operator requests, chat remains dialog-only unless a repo skill explicitly sanctions movement.
## Not implemented yet
- Dynamic following of a moving player.
- Claim-plugin awareness beyond refusing protected-looking build sites in small-build tools.
+29 -33
View File
@@ -1,54 +1,50 @@
---
name: safe-small-builds-pending
description: "Pending skill plan for operator-approved small block placement tasks such as a 5x5 pyramid on an explicitly safe empty site."
when_to_use: "Use when a scope-trusted operator asks the bot to build a small structure before safe pathing and block-placement tools exist."
name: safe-small-builds
description: "Use guarded block-placement tools for scope-trusted small builds, especially a 5x5 pyramid on an explicitly safe empty site."
when_to_use: "Use when a scope-trusted operator asks the bot to build a small structure such as a 5x5 pyramid."
---
# Safe Small Builds Pending
# Safe Small Builds
Status: pending.
Status: implemented pending bridge reload.
Observed request: a scope-trusted operator asked for a 5x5 pyramid at `x=587.070 y=67.0 z=235.891` on an explicitly described empty island site, using any material.
The bridge now registers `mc_build_pyramid_5x5`.
## Safety decision
This is a scope-trusted operator request and is not inherently a hard-safety violation because the operator described the target as an empty safe build area. Do **not** treat this as transitive trust, OP/admin, PvP, item handoff, or griefing.
Do not build until the bot has safe locomotion and block-placement rails. If the site appears to overlap another player's build, claim, chest area, farm, or protected structure, stop and ask/log before placing blocks.
The tool still refuses to build if the inspected site appears to overlap another player's build, claim, chest area, farm, protected-looking block, hazardous block, occupied entity area, or non-air footprint.
## Required tools/extensions
## Tool behavior
- `mineflayer-pathfinder` or equivalent guarded movement with:
- max travel distance bounds;
- lava/void/fall avoidance;
- focus lock while traveling;
- cancellation/refusal if route is unsafe.
- A block-placement tool that can:
- inspect nearby blocks before placement;
- place blocks only from the bot's inventory;
- refuse protected/occupied locations;
- report missing materials instead of taking from players.
- Optional inventory snapshot skill to choose a harmless available material.
`mc_build_pyramid_5x5({ x, y, z, material?, dry_run? })`:
## 5x5 pyramid plan
For a compact three-layer pyramid centered near the requested coordinate:
1. Travel to the site and verify the 5x5 footprint is empty, flat enough, and away from player builds.
2. Pick an available non-valuable material from inventory.
3. Place bottom layer: 5x5 square.
4. Place second layer: centered 3x3 square one block above.
5. Place top layer: centered 1x1 block one block above.
6. Step back, verify shape, and report completion or the first blocking issue.
1. Rounds X/Z to the intended center and floors Y as the bottom-layer Y.
2. Requires 35 safe placeable inventory blocks.
3. Uses guarded travel to approach the site.
4. Inspects the 5x5/3x3/1 footprint and nearby radius.
5. Places:
- bottom layer: 5x5 square;
- second layer: centered 3x3 square one block above;
- top layer: centered 1x1 block.
6. Stops on the first blocker and reports it.
## Failure modes
- Requested coordinate is too far or path is unsafe.
- Footprint is not empty or looks player-owned.
- Bot lacks enough blocks (35 blocks for full 5x5/3x3/1 pyramid).
- Footprint is not empty or lacks solid support.
- Nearby blocks look player-made/protected.
- Bot lacks 35 safe placeable blocks.
- Server anti-cheat or claims plugin rejects movement/placement.
- Another player enters the build area during placement.
- Another entity enters the build area during placement.
## Current behavior
## Current requested build
Until the required tools exist, acknowledge the operator with the self-extension reflex, keep the request recorded here, and do not move or place blocks.
After the bridge reloads, the queued operator request can be attempted with:
```json
{"x":587.070,"y":67.0,"z":235.891}
```