monkeybot-cli 0.6.0__tar.gz → 0.7.0__tar.gz

{monkeybot_cli-0.6.0 → monkeybot_cli-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: monkeybot-cli
-Version: 0.6.0
+Version: 0.7.0
 Summary: CLI to create, configure, validate, and chat with monkeybot agents.
 Requires-Python: >=3.11
 Requires-Dist: httpx>=0.27.0

{monkeybot_cli-0.6.0 → monkeybot_cli-0.7.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "monkeybot-cli"
-version = "0.6.0"
+version = "0.7.0"
 description = "CLI to create, configure, validate, and chat with monkeybot agents."
 requires-python = ">=3.11"
 dependencies = [

{monkeybot_cli-0.6.0 → monkeybot_cli-0.7.0}/src/monkeybot_cli/scaffold.py

@@ -176,6 +176,13 @@ def install_loop_skill(dest: Path, *, force: bool) -> str:
     return _install_file(target, resources.files(_DEFAULTS_PKG) / "loop" / "SKILL.md", force=force)
 
 
+def install_goal_skill(dest: Path, *, force: bool) -> str:
+    """Install the bundled native-goal procedure into ``skills/goal``."""
+    target = dest / "skills" / "goal" / "SKILL.md"
+    target.parent.mkdir(parents=True, exist_ok=True)
+    return _install_file(target, resources.files(_DEFAULTS_PKG) / "goal" / "SKILL.md", force=force)
+
+
 def install_env_example(dest: Path, *, force: bool) -> str:
     env_example = dest / ".env.example"
     if env_example.exists() and not force:
@@ -399,6 +406,7 @@ def run_refresh(*, dest: Path) -> list[str]:
     report.append(refresh_permissions_if_default(cfg_dir))
     report.append(refresh_monkeybot_yaml(cfg_dir))
     report.extend(ensure_memory(dest, force=False))
+    report.append(f"  skills/goal/SKILL.md: {install_goal_skill(dest, force=False)}")
     return report
 
 
@@ -412,11 +420,12 @@ def run_new(
 ) -> list[str]:
     """Full scaffold: config bundle, empty skills root, writable state, and image files.
 
-    Capability skills (``browser``, ``image-generator``, ``loop``) are packaged
+    Optional capability skills (``browser``, ``image-generator``, ``loop``) are packaged
     under ``scaffold_defaults`` but not installed into new agents for now —
     the Mac Main Agent loads them from ``~/.monkeybot/.internal/skills``
     instead. Re-enable via ``install_*_skill`` when custom agents should get
-    them again.
+    them again. The ``goal`` skill is installed because native goal tools are
+    intentionally exposed only for explicit ``/goal`` invocations.
     """
     cfg_dir = dest / "monkeybot_config"
     report = install_config_bundle(cfg_dir, force=force)
@@ -426,7 +435,7 @@ def run_new(
     )
     report.extend(ensure_memory(dest, force=force))
     report.extend(ensure_workspace(dest, force=force))
-    report.append("  skills/: ensured (empty — capability skills deferred)")
+    report.append(f"  skills/goal/SKILL.md: {install_goal_skill(dest, force=force)}")
     report.append(f"  .env.example: {install_env_example(dest, force=force)}")
     report.extend(install_container_files(dest, force=force))
     report.append(

monkeybot_cli-0.7.0/src/monkeybot_cli/scaffold_defaults/goal/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: goal
+description: Create one durable objective that continues across scheduled turns until completed.
+---
+
+# Goal
+
+Use this skill only when the user explicitly invokes `/goal` with an objective
+that may require multiple turns.
+
+## Start
+
+1. Preserve the user's complete objective without narrowing its scope.
+2. Call `create_goal` exactly once with that objective.
+3. Do the first concrete increment of work in the same turn.
+4. Keep the returned goal id; every `update_goal` call must include it.
+
+## Continue
+
+- Goal continuations are scheduled automatically.
+- Treat the stored objective as authoritative.
+- Make measurable progress and verify results before declaring completion.
+- Temporary session-busy deferrals are normal and are not goal failures.
+- Persistent execution failures stop the goal after the retry limit so it
+  cannot consume resources indefinitely.
+
+## Complete
+
+Call `update_goal` with the returned `goal_id` and `status="complete"` only
+after evidence proves every requirement is satisfied. Otherwise leave the goal
+active. Use the `/goals` control plane to pause, resume, or stop it manually.

{monkeybot_cli-0.6.0 → monkeybot_cli-0.7.0}/src/monkeybot_cli/scaffold_defaults/monkeybot.example.yaml

@@ -253,6 +253,17 @@ scheduler:
   # Env override: MONKEYBOT_SCHEDULER_ENABLED (1 | true | yes | on).
   enabled: false
 
+# Background verifier (YAML-only). Off by default: ledger costs one model call
+# per human message. `enabled: true` turns on omitted ledger/tracker flags;
+# omitted judge.enabled turns on only when the tracker is on. Explicit
+# `enabled: false` still opts a nested section out. Omitted ledger.model /
+# judge.model inherit model.name (same fallback as the agent). The live
+# worker is session-bound ProviderJudge. Realtime loops ignore this block.
+# verifier:
+#   enabled: true
+#   escalation:
+#     max_severity: nudge
+
 # Optional JSON for model.provider: fake tests (env: MONKEYBOT_FAKE_PROVIDER_EVENTS)
 # fake_provider:
 #   events_json: '[[]]'

{monkeybot_cli-0.6.0 → monkeybot_cli-0.7.0}/tests/test_scaffold.py

@@ -34,6 +34,7 @@ def test_run_new_creates_bundle(tmp_path: Path) -> None:
     assert not (tmp_path / "skills" / "browser").exists()
     assert not (tmp_path / "skills" / "image-generator").exists()
     assert not (tmp_path / "skills" / "loop").exists()
+    assert (tmp_path / "skills" / "goal" / "SKILL.md").is_file()
     assert (tmp_path / "workspace" / ".gitkeep").is_file()
     assert (tmp_path / "workspace" / "browser" / "playbooks").is_dir()
     assert (tmp_path / "workspace" / "generated-media" / "images").is_dir()
@@ -153,6 +154,8 @@ def test_run_refresh_adds_template_commands_and_keeps_extras(tmp_path: Path) ->
     doc = yaml.safe_load(yaml_path.read_text(encoding="utf-8")) or {}
     doc.pop("memory", None)
     yaml_path.write_text(yaml.safe_dump(doc, sort_keys=False), encoding="utf-8")
+    goal_skill = tmp_path / "skills" / "goal" / "SKILL.md"
+    goal_skill.unlink()
 
     report = run_refresh(dest=tmp_path)
     text = allow.read_text(encoding="utf-8")
@@ -166,6 +169,7 @@ def test_run_refresh_adds_template_commands_and_keeps_extras(tmp_path: Path) ->
     refreshed_yaml = yaml_path.read_text(encoding="utf-8")
     assert "enabled: true" in refreshed_yaml
     assert "custom persona" not in refreshed_yaml
+    assert goal_skill.is_file()
     joined = "\n".join(report)
     assert "command_allowlist.yaml: updated" in joined
     assert "monkeybot.yaml: updated" in joined
@@ -174,7 +178,10 @@ def test_run_refresh_adds_template_commands_and_keeps_extras(tmp_path: Path) ->
 def test_run_refresh_skips_custom_permissions_and_model(tmp_path: Path) -> None:
     run_new(dest=tmp_path, force=False, provider="nvidia", model="keep-me")
     perms = tmp_path / "monkeybot_config" / "permissions.yaml"
-    perms.write_text("default: deny\nrules:\n  - tool: '*'\n    pattern: '*'\n    effect: deny\n", encoding="utf-8")
+    perms.write_text(
+        "default: deny\nrules:\n  - tool: '*'\n    pattern: '*'\n    effect: deny\n",
+        encoding="utf-8",
+    )
     yaml_path = tmp_path / "monkeybot_config" / "monkeybot.yaml"
     before = yaml_path.read_text(encoding="utf-8")