Merge PR #570: feat: OpenClaw migration skill + CLI panel width improvements
Authored by unmodeled-tyler. Adds openclaw-migration skill to optional-skills/ with migration script, SKILL.md, and 7 tests. Also improves clarify/approval panel rendering with dynamic width calculation.
This commit is contained in:
teknium1
commit
8b9de366f2
5 changed files with 1827 additions and 36 deletions
123
cli.py
123
cli.py
|
|
@ -19,6 +19,7 @@ import sys
|
||||||
import json
|
import json
|
||||||
import atexit
|
import atexit
|
||||||
import uuid
|
import uuid
|
||||||
|
import textwrap
|
||||||
from pathlib import Path
|
from pathlib import Path
|
||||||
from datetime import datetime
|
from datetime import datetime
|
||||||
from typing import List, Dict, Any, Optional
|
from typing import List, Dict, Any, Optional
|
||||||
|
|
@ -3628,6 +3629,8 @@ class HermesCLI:
|
||||||
return "type password (hidden), Enter to skip"
|
return "type password (hidden), Enter to skip"
|
||||||
if cli_ref._approval_state:
|
if cli_ref._approval_state:
|
||||||
return ""
|
return ""
|
||||||
|
if cli_ref._clarify_freetext:
|
||||||
|
return "type your answer here and press Enter"
|
||||||
if cli_ref._clarify_state:
|
if cli_ref._clarify_state:
|
||||||
return ""
|
return ""
|
||||||
if cli_ref._agent_running:
|
if cli_ref._agent_running:
|
||||||
|
|
@ -3699,6 +3702,32 @@ class HermesCLI:
|
||||||
|
|
||||||
# --- Clarify tool: dynamic display widget for questions + choices ---
|
# --- Clarify tool: dynamic display widget for questions + choices ---
|
||||||
|
|
||||||
|
def _panel_box_width(title: str, content_lines: list[str], min_width: int = 46, max_width: int = 76) -> int:
|
||||||
|
"""Choose a stable panel width wide enough for the title and content."""
|
||||||
|
term_cols = shutil.get_terminal_size((100, 20)).columns
|
||||||
|
longest = max([len(title)] + [len(line) for line in content_lines] + [min_width - 4])
|
||||||
|
inner = min(max(longest + 4, min_width - 2), max_width - 2, max(24, term_cols - 6))
|
||||||
|
return inner + 2 # account for the single leading/trailing spaces inside borders
|
||||||
|
|
||||||
|
def _wrap_panel_text(text: str, width: int, subsequent_indent: str = "") -> list[str]:
|
||||||
|
wrapped = textwrap.wrap(
|
||||||
|
text,
|
||||||
|
width=max(8, width),
|
||||||
|
break_long_words=False,
|
||||||
|
break_on_hyphens=False,
|
||||||
|
subsequent_indent=subsequent_indent,
|
||||||
|
)
|
||||||
|
return wrapped or [""]
|
||||||
|
|
||||||
|
def _append_panel_line(lines, border_style: str, content_style: str, text: str, box_width: int) -> None:
|
||||||
|
inner_width = max(0, box_width - 2)
|
||||||
|
lines.append((border_style, "│ "))
|
||||||
|
lines.append((content_style, text.ljust(inner_width)))
|
||||||
|
lines.append((border_style, " │\n"))
|
||||||
|
|
||||||
|
def _append_blank_panel_line(lines, border_style: str, box_width: int) -> None:
|
||||||
|
lines.append((border_style, "│" + (" " * box_width) + "│\n"))
|
||||||
|
|
||||||
def _get_clarify_display():
|
def _get_clarify_display():
|
||||||
"""Build styled text for the clarify question/choices panel."""
|
"""Build styled text for the clarify question/choices panel."""
|
||||||
state = cli_ref._clarify_state
|
state = cli_ref._clarify_state
|
||||||
|
|
@ -3708,43 +3737,62 @@ class HermesCLI:
|
||||||
question = state["question"]
|
question = state["question"]
|
||||||
choices = state.get("choices") or []
|
choices = state.get("choices") or []
|
||||||
selected = state.get("selected", 0)
|
selected = state.get("selected", 0)
|
||||||
|
preview_lines = _wrap_panel_text(question, 60)
|
||||||
|
for i, choice in enumerate(choices):
|
||||||
|
prefix = "❯ " if i == selected and not cli_ref._clarify_freetext else " "
|
||||||
|
preview_lines.extend(_wrap_panel_text(f"{prefix}{choice}", 60, subsequent_indent=" "))
|
||||||
|
other_label = (
|
||||||
|
"❯ Other (type below)" if cli_ref._clarify_freetext
|
||||||
|
else "❯ Other (type your answer)" if selected == len(choices)
|
||||||
|
else " Other (type your answer)"
|
||||||
|
)
|
||||||
|
preview_lines.extend(_wrap_panel_text(other_label, 60, subsequent_indent=" "))
|
||||||
|
box_width = _panel_box_width("Hermes needs your input", preview_lines)
|
||||||
|
inner_text_width = max(8, box_width - 2)
|
||||||
|
|
||||||
lines = []
|
lines = []
|
||||||
# Box top border
|
# Box top border
|
||||||
lines.append(('class:clarify-border', '╭─ '))
|
lines.append(('class:clarify-border', '╭─ '))
|
||||||
lines.append(('class:clarify-title', 'Hermes needs your input'))
|
lines.append(('class:clarify-title', 'Hermes needs your input'))
|
||||||
lines.append(('class:clarify-border', ' ─────────────────────────────╮\n'))
|
lines.append(('class:clarify-border', ' ' + ('─' * max(0, box_width - len("Hermes needs your input") - 3)) + '╮\n'))
|
||||||
lines.append(('class:clarify-border', '│\n'))
|
_append_blank_panel_line(lines, 'class:clarify-border', box_width)
|
||||||
|
|
||||||
# Question text
|
# Question text
|
||||||
lines.append(('class:clarify-border', '│ '))
|
for wrapped in _wrap_panel_text(question, inner_text_width):
|
||||||
lines.append(('class:clarify-question', question))
|
_append_panel_line(lines, 'class:clarify-border', 'class:clarify-question', wrapped, box_width)
|
||||||
lines.append(('', '\n'))
|
_append_blank_panel_line(lines, 'class:clarify-border', box_width)
|
||||||
lines.append(('class:clarify-border', '│\n'))
|
|
||||||
|
if cli_ref._clarify_freetext and not choices:
|
||||||
|
guidance = "Type your answer in the prompt below, then press Enter."
|
||||||
|
for wrapped in _wrap_panel_text(guidance, inner_text_width):
|
||||||
|
_append_panel_line(lines, 'class:clarify-border', 'class:clarify-choice', wrapped, box_width)
|
||||||
|
_append_blank_panel_line(lines, 'class:clarify-border', box_width)
|
||||||
|
|
||||||
if choices:
|
if choices:
|
||||||
# Multiple-choice mode: show selectable options
|
# Multiple-choice mode: show selectable options
|
||||||
for i, choice in enumerate(choices):
|
for i, choice in enumerate(choices):
|
||||||
lines.append(('class:clarify-border', '│ '))
|
style = 'class:clarify-selected' if i == selected and not cli_ref._clarify_freetext else 'class:clarify-choice'
|
||||||
if i == selected and not cli_ref._clarify_freetext:
|
prefix = '❯ ' if i == selected and not cli_ref._clarify_freetext else ' '
|
||||||
lines.append(('class:clarify-selected', f'❯ {choice}'))
|
wrapped_lines = _wrap_panel_text(f"{prefix}{choice}", inner_text_width, subsequent_indent=" ")
|
||||||
else:
|
for wrapped in wrapped_lines:
|
||||||
lines.append(('class:clarify-choice', f' {choice}'))
|
_append_panel_line(lines, 'class:clarify-border', style, wrapped, box_width)
|
||||||
lines.append(('', '\n'))
|
|
||||||
|
|
||||||
# "Other" option (5th line, only shown when choices exist)
|
# "Other" option (5th line, only shown when choices exist)
|
||||||
other_idx = len(choices)
|
other_idx = len(choices)
|
||||||
lines.append(('class:clarify-border', '│ '))
|
|
||||||
if selected == other_idx and not cli_ref._clarify_freetext:
|
if selected == other_idx and not cli_ref._clarify_freetext:
|
||||||
lines.append(('class:clarify-selected', '❯ Other (type your answer)'))
|
other_style = 'class:clarify-selected'
|
||||||
|
other_label = '❯ Other (type your answer)'
|
||||||
elif cli_ref._clarify_freetext:
|
elif cli_ref._clarify_freetext:
|
||||||
lines.append(('class:clarify-active-other', '❯ Other (type below)'))
|
other_style = 'class:clarify-active-other'
|
||||||
|
other_label = '❯ Other (type below)'
|
||||||
else:
|
else:
|
||||||
lines.append(('class:clarify-choice', ' Other (type your answer)'))
|
other_style = 'class:clarify-choice'
|
||||||
lines.append(('', '\n'))
|
other_label = ' Other (type your answer)'
|
||||||
|
for wrapped in _wrap_panel_text(other_label, inner_text_width, subsequent_indent=" "):
|
||||||
|
_append_panel_line(lines, 'class:clarify-border', other_style, wrapped, box_width)
|
||||||
|
|
||||||
lines.append(('class:clarify-border', '│\n'))
|
_append_blank_panel_line(lines, 'class:clarify-border', box_width)
|
||||||
lines.append(('class:clarify-border', '╰──────────────────────────────────────────────────╯\n'))
|
lines.append(('class:clarify-border', '╰' + ('─' * box_width) + '╯\n'))
|
||||||
return lines
|
return lines
|
||||||
|
|
||||||
clarify_widget = ConditionalContainer(
|
clarify_widget = ConditionalContainer(
|
||||||
|
|
@ -3799,29 +3847,32 @@ class HermesCLI:
|
||||||
"always": "Add to permanent allowlist",
|
"always": "Add to permanent allowlist",
|
||||||
"deny": "Deny",
|
"deny": "Deny",
|
||||||
}
|
}
|
||||||
|
preview_lines = _wrap_panel_text(description, 60)
|
||||||
|
preview_lines.extend(_wrap_panel_text(cmd_display, 60))
|
||||||
|
for i, choice in enumerate(choices):
|
||||||
|
prefix = '❯ ' if i == selected else ' '
|
||||||
|
preview_lines.extend(_wrap_panel_text(f"{prefix}{choice_labels.get(choice, choice)}", 60, subsequent_indent=" "))
|
||||||
|
box_width = _panel_box_width("⚠️ Dangerous Command", preview_lines)
|
||||||
|
inner_text_width = max(8, box_width - 2)
|
||||||
|
|
||||||
lines = []
|
lines = []
|
||||||
lines.append(('class:approval-border', '╭─ '))
|
lines.append(('class:approval-border', '╭─ '))
|
||||||
lines.append(('class:approval-title', '⚠️ Dangerous Command'))
|
lines.append(('class:approval-title', '⚠️ Dangerous Command'))
|
||||||
lines.append(('class:approval-border', ' ───────────────────────────────╮\n'))
|
lines.append(('class:approval-border', ' ' + ('─' * max(0, box_width - len("⚠️ Dangerous Command") - 3)) + '╮\n'))
|
||||||
lines.append(('class:approval-border', '│\n'))
|
_append_blank_panel_line(lines, 'class:approval-border', box_width)
|
||||||
lines.append(('class:approval-border', '│ '))
|
for wrapped in _wrap_panel_text(description, inner_text_width):
|
||||||
lines.append(('class:approval-desc', description))
|
_append_panel_line(lines, 'class:approval-border', 'class:approval-desc', wrapped, box_width)
|
||||||
lines.append(('', '\n'))
|
for wrapped in _wrap_panel_text(cmd_display, inner_text_width):
|
||||||
lines.append(('class:approval-border', '│ '))
|
_append_panel_line(lines, 'class:approval-border', 'class:approval-cmd', wrapped, box_width)
|
||||||
lines.append(('class:approval-cmd', cmd_display))
|
_append_blank_panel_line(lines, 'class:approval-border', box_width)
|
||||||
lines.append(('', '\n'))
|
|
||||||
lines.append(('class:approval-border', '│\n'))
|
|
||||||
for i, choice in enumerate(choices):
|
for i, choice in enumerate(choices):
|
||||||
lines.append(('class:approval-border', '│ '))
|
|
||||||
label = choice_labels.get(choice, choice)
|
label = choice_labels.get(choice, choice)
|
||||||
if i == selected:
|
style = 'class:approval-selected' if i == selected else 'class:approval-choice'
|
||||||
lines.append(('class:approval-selected', f'❯ {label}'))
|
prefix = '❯ ' if i == selected else ' '
|
||||||
else:
|
for wrapped in _wrap_panel_text(f"{prefix}{label}", inner_text_width, subsequent_indent=" "):
|
||||||
lines.append(('class:approval-choice', f' {label}'))
|
_append_panel_line(lines, 'class:approval-border', style, wrapped, box_width)
|
||||||
lines.append(('', '\n'))
|
_append_blank_panel_line(lines, 'class:approval-border', box_width)
|
||||||
lines.append(('class:approval-border', '│\n'))
|
lines.append(('class:approval-border', '╰' + ('─' * box_width) + '╯\n'))
|
||||||
lines.append(('class:approval-border', '╰──────────────────────────────────────────────────────╯\n'))
|
|
||||||
return lines
|
return lines
|
||||||
|
|
||||||
approval_widget = ConditionalContainer(
|
approval_widget = ConditionalContainer(
|
||||||
|
|
|
||||||
2
optional-skills/migration/DESCRIPTION.md
Normal file
2
optional-skills/migration/DESCRIPTION.md
Normal file
|
|
@ -0,0 +1,2 @@
|
||||||
|
Optional migration workflows for importing user state and customizations from
|
||||||
|
other agent systems into Hermes Agent.
|
||||||
281
optional-skills/migration/openclaw-migration/SKILL.md
Normal file
281
optional-skills/migration/openclaw-migration/SKILL.md
Normal file
|
|
@ -0,0 +1,281 @@
|
||||||
|
---
|
||||||
|
name: openclaw-migration
|
||||||
|
description: Migrate a user's OpenClaw customization footprint into Hermes Agent. Imports Hermes-compatible memories, SOUL.md, command allowlists, user skills, and selected workspace assets from ~/.openclaw, then reports exactly what could not be migrated and why.
|
||||||
|
version: 1.0.0
|
||||||
|
author: Hermes Agent (Nous Research)
|
||||||
|
license: MIT
|
||||||
|
metadata:
|
||||||
|
hermes:
|
||||||
|
tags: [Migration, OpenClaw, Hermes, Memory, Persona, Import]
|
||||||
|
related_skills: [hermes-agent]
|
||||||
|
---
|
||||||
|
|
||||||
|
# OpenClaw -> Hermes Migration
|
||||||
|
|
||||||
|
Use this skill when a user wants to move their OpenClaw setup into Hermes Agent with minimal manual cleanup.
|
||||||
|
|
||||||
|
## What this skill does
|
||||||
|
|
||||||
|
It uses `scripts/openclaw_to_hermes.py` to:
|
||||||
|
|
||||||
|
- import `SOUL.md` into the Hermes home directory as `SOUL.md`
|
||||||
|
- transform OpenClaw `MEMORY.md` and `USER.md` into Hermes memory entries
|
||||||
|
- merge OpenClaw command approval patterns into Hermes `command_allowlist`
|
||||||
|
- migrate Hermes-compatible messaging settings such as `TELEGRAM_ALLOWED_USERS` and `MESSAGING_CWD`
|
||||||
|
- copy OpenClaw skills into `~/.hermes/skills/openclaw-imports/`
|
||||||
|
- optionally copy the OpenClaw workspace instructions file into a chosen Hermes workspace
|
||||||
|
- mirror compatible workspace assets such as `workspace/tts/` into `~/.hermes/tts/`
|
||||||
|
- archive non-secret docs that do not have a direct Hermes destination
|
||||||
|
- produce a structured report listing migrated items, conflicts, skipped items, and reasons
|
||||||
|
|
||||||
|
## Path resolution
|
||||||
|
|
||||||
|
The helper script lives in this skill directory at:
|
||||||
|
|
||||||
|
- `scripts/openclaw_to_hermes.py`
|
||||||
|
|
||||||
|
When this skill is installed from the Skills Hub, the normal location is:
|
||||||
|
|
||||||
|
- `~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py`
|
||||||
|
|
||||||
|
Do not guess a shorter path like `~/.hermes/skills/openclaw-migration/...`.
|
||||||
|
|
||||||
|
Before running the helper:
|
||||||
|
|
||||||
|
1. Prefer the installed path under `~/.hermes/skills/migration/openclaw-migration/`.
|
||||||
|
2. If that path fails, inspect the installed skill directory and resolve the script relative to the installed `SKILL.md`.
|
||||||
|
3. Only use `find` as a fallback if the installed location is missing or the skill was moved manually.
|
||||||
|
4. When calling the terminal tool, do not pass `workdir: "~"`. Use an absolute directory such as the user's home directory, or omit `workdir` entirely.
|
||||||
|
|
||||||
|
With `--migrate-secrets`, it will also import a small allowlisted set of Hermes-compatible secrets, currently:
|
||||||
|
|
||||||
|
- `TELEGRAM_BOT_TOKEN`
|
||||||
|
|
||||||
|
## Default workflow
|
||||||
|
|
||||||
|
1. Inspect first with a dry run.
|
||||||
|
2. Present a simple summary of what can be migrated, what cannot be migrated, and what would be archived.
|
||||||
|
3. If the `clarify` tool is available, use it for user decisions instead of asking for a free-form prose reply.
|
||||||
|
4. If the dry run finds imported skill directory conflicts, ask how those should be handled before executing.
|
||||||
|
5. Ask the user to choose between the two supported migration modes before executing.
|
||||||
|
6. Ask for a target workspace path only if the user wants the workspace instructions file brought over.
|
||||||
|
7. Execute the migration with the matching preset and flags.
|
||||||
|
8. Summarize the results, especially:
|
||||||
|
- what was migrated
|
||||||
|
- what was archived for manual review
|
||||||
|
- what was skipped and why
|
||||||
|
|
||||||
|
## User interaction protocol
|
||||||
|
|
||||||
|
Hermes CLI supports the `clarify` tool for interactive prompts, but it is limited to:
|
||||||
|
|
||||||
|
- one choice at a time
|
||||||
|
- up to 4 predefined choices
|
||||||
|
- an automatic `Other` free-text option
|
||||||
|
|
||||||
|
It does **not** support true multi-select checkboxes in a single prompt.
|
||||||
|
|
||||||
|
For every `clarify` call:
|
||||||
|
|
||||||
|
- always include a non-empty `question`
|
||||||
|
- include `choices` only for real selectable prompts
|
||||||
|
- keep `choices` to 2-4 plain string options
|
||||||
|
- never emit placeholder or truncated options such as `...`
|
||||||
|
- never pad or stylize choices with extra whitespace
|
||||||
|
- never include fake form fields in the question such as `enter directory here`, blank lines to fill in, or underscores like `_____`
|
||||||
|
- for open-ended path questions, ask only the plain sentence; the user types in the normal CLI prompt below the panel
|
||||||
|
|
||||||
|
If a `clarify` call returns an error, inspect the error text, correct the payload, and retry once with a valid `question` and clean choices.
|
||||||
|
|
||||||
|
When `clarify` is available and the dry run reveals any required user decision, your **next action must be a `clarify` tool call**.
|
||||||
|
Do not end the turn with a normal assistant message such as:
|
||||||
|
|
||||||
|
- "Let me present the choices"
|
||||||
|
- "What would you like to do?"
|
||||||
|
- "Here are the options"
|
||||||
|
|
||||||
|
If a user decision is required, collect it via `clarify` before producing more prose.
|
||||||
|
If multiple unresolved decisions remain, do not insert an explanatory assistant message between them. After one `clarify` response is received, your next action should usually be the next required `clarify` call.
|
||||||
|
|
||||||
|
Treat `workspace-agents` as an unresolved decision whenever the dry run reports:
|
||||||
|
|
||||||
|
- `kind="workspace-agents"`
|
||||||
|
- `status="skipped"`
|
||||||
|
- reason containing `No workspace target was provided`
|
||||||
|
|
||||||
|
In that case, you must ask about workspace instructions before execution. Do not silently treat that as a decision to skip.
|
||||||
|
|
||||||
|
Because of that limitation, use this simplified decision flow:
|
||||||
|
|
||||||
|
1. For `SOUL.md` conflicts, use `clarify` with choices such as:
|
||||||
|
- `keep existing`
|
||||||
|
- `overwrite with backup`
|
||||||
|
- `review first`
|
||||||
|
2. If the dry run shows one or more `kind="skill"` items with `status="conflict"`, use `clarify` with choices such as:
|
||||||
|
- `keep existing skills`
|
||||||
|
- `overwrite conflicting skills with backup`
|
||||||
|
- `import conflicting skills under renamed folders`
|
||||||
|
3. For workspace instructions, use `clarify` with choices such as:
|
||||||
|
- `skip workspace instructions`
|
||||||
|
- `copy to a workspace path`
|
||||||
|
- `decide later`
|
||||||
|
4. If the user chooses to copy workspace instructions, ask a follow-up open-ended `clarify` question requesting an **absolute path**.
|
||||||
|
5. If the user chooses `skip workspace instructions` or `decide later`, proceed without `--workspace-target`.
|
||||||
|
5. For migration mode, use `clarify` with these 3 choices:
|
||||||
|
- `user-data only`
|
||||||
|
- `full compatible migration`
|
||||||
|
- `cancel`
|
||||||
|
6. `user-data only` means: migrate user data and compatible config, but do **not** import allowlisted secrets.
|
||||||
|
7. `full compatible migration` means: migrate the same compatible user data plus the allowlisted secrets when present.
|
||||||
|
8. If `clarify` is not available, ask the same question in normal text, but still constrain the answer to `user-data only`, `full compatible migration`, or `cancel`.
|
||||||
|
|
||||||
|
Execution gate:
|
||||||
|
|
||||||
|
- Do not execute while a `workspace-agents` skip caused by `No workspace target was provided` remains unresolved.
|
||||||
|
- The only valid ways to resolve it are:
|
||||||
|
- user explicitly chooses `skip workspace instructions`
|
||||||
|
- user explicitly chooses `decide later`
|
||||||
|
- user provides a workspace path after choosing `copy to a workspace path`
|
||||||
|
- Absence of a workspace target in the dry run is not itself permission to execute.
|
||||||
|
- Do not execute while any required `clarify` decision remains unresolved.
|
||||||
|
|
||||||
|
Use these exact `clarify` payload shapes as the default pattern:
|
||||||
|
|
||||||
|
- `{"question":"Your existing SOUL.md conflicts with the imported one. What should I do?","choices":["keep existing","overwrite with backup","review first"]}`
|
||||||
|
- `{"question":"One or more imported OpenClaw skills already exist in Hermes. How should I handle those skill conflicts?","choices":["keep existing skills","overwrite conflicting skills with backup","import conflicting skills under renamed folders"]}`
|
||||||
|
- `{"question":"Choose migration mode: migrate only user data, or run the full compatible migration including allowlisted secrets?","choices":["user-data only","full compatible migration","cancel"]}`
|
||||||
|
- `{"question":"Do you want to copy the OpenClaw workspace instructions file into a Hermes workspace?","choices":["skip workspace instructions","copy to a workspace path","decide later"]}`
|
||||||
|
- `{"question":"Please provide an absolute path where the workspace instructions should be copied."}`
|
||||||
|
|
||||||
|
## Decision-to-command mapping
|
||||||
|
|
||||||
|
Map user decisions to command flags exactly:
|
||||||
|
|
||||||
|
- If the user chooses `keep existing` for `SOUL.md`, do **not** add `--overwrite`.
|
||||||
|
- If the user chooses `overwrite with backup`, add `--overwrite`.
|
||||||
|
- If the user chooses `review first`, stop before execution and review the relevant files.
|
||||||
|
- If the user chooses `keep existing skills`, add `--skill-conflict skip`.
|
||||||
|
- If the user chooses `overwrite conflicting skills with backup`, add `--skill-conflict overwrite`.
|
||||||
|
- If the user chooses `import conflicting skills under renamed folders`, add `--skill-conflict rename`.
|
||||||
|
- If the user chooses `user-data only`, execute with `--preset user-data` and do **not** add `--migrate-secrets`.
|
||||||
|
- If the user chooses `full compatible migration`, execute with `--preset full --migrate-secrets`.
|
||||||
|
- Only add `--workspace-target` if the user explicitly provided an absolute workspace path.
|
||||||
|
- If the user chooses `skip workspace instructions` or `decide later`, do not add `--workspace-target`.
|
||||||
|
|
||||||
|
Before executing, restate the exact command plan in plain language and make sure it matches the user's choices.
|
||||||
|
|
||||||
|
## Post-run reporting rules
|
||||||
|
|
||||||
|
After execution, treat the script's JSON output as the source of truth.
|
||||||
|
|
||||||
|
1. Base all counts on `report.summary`.
|
||||||
|
2. Only list an item under "Successfully Migrated" if its `status` is exactly `migrated`.
|
||||||
|
3. Do not claim a conflict was resolved unless the report shows that item as `migrated`.
|
||||||
|
4. Do not say `SOUL.md` was overwritten unless the report item for `kind="soul"` has `status="migrated"`.
|
||||||
|
5. If `report.summary.conflict > 0`, include a conflict section instead of silently implying success.
|
||||||
|
6. If counts and listed items disagree, fix the list to match the report before responding.
|
||||||
|
7. Include the `output_dir` path from the report when available so the user can inspect `report.json`, `summary.md`, backups, and archived files.
|
||||||
|
8. For memory or user-profile overflow, do not say the entries were archived unless the report explicitly shows an archive path. If `details.overflow_file` exists, say the full overflow list was exported there.
|
||||||
|
9. If a skill was imported under a renamed folder, report the final destination and mention `details.renamed_from`.
|
||||||
|
10. If `report.skill_conflict_mode` is present, use it as the source of truth for the selected imported-skill conflict policy.
|
||||||
|
11. If an item has `status="skipped"`, do not describe it as overwritten, backed up, migrated, or resolved.
|
||||||
|
12. If `kind="soul"` has `status="skipped"` with reason `Target already matches source`, say it was left unchanged and do not mention a backup.
|
||||||
|
13. If a renamed imported skill has an empty `details.backup`, do not imply the existing Hermes skill was renamed or backed up. Say only that the imported copy was placed in the new destination and reference `details.renamed_from` as the pre-existing folder that remained in place.
|
||||||
|
|
||||||
|
## Migration presets
|
||||||
|
|
||||||
|
Prefer these two presets in normal use:
|
||||||
|
|
||||||
|
- `user-data`
|
||||||
|
- `full`
|
||||||
|
|
||||||
|
`user-data` includes:
|
||||||
|
|
||||||
|
- `soul`
|
||||||
|
- `workspace-agents`
|
||||||
|
- `memory`
|
||||||
|
- `user-profile`
|
||||||
|
- `messaging-settings`
|
||||||
|
- `command-allowlist`
|
||||||
|
- `skills`
|
||||||
|
- `tts-assets`
|
||||||
|
- `archive`
|
||||||
|
|
||||||
|
`full` includes everything in `user-data` plus:
|
||||||
|
|
||||||
|
- `secret-settings`
|
||||||
|
|
||||||
|
The helper script still supports category-level `--include` / `--exclude`, but treat that as an advanced fallback rather than the default UX.
|
||||||
|
|
||||||
|
## Commands
|
||||||
|
|
||||||
|
Dry run with full discovery:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python3 ~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py
|
||||||
|
```
|
||||||
|
|
||||||
|
When using the terminal tool, prefer an absolute invocation pattern such as:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{"command":"python3 /home/USER/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py","workdir":"/home/USER"}
|
||||||
|
```
|
||||||
|
|
||||||
|
Dry run with the user-data preset:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python3 ~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py --preset user-data
|
||||||
|
```
|
||||||
|
|
||||||
|
Execute a user-data migration:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python3 ~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py --execute --preset user-data --skill-conflict skip
|
||||||
|
```
|
||||||
|
|
||||||
|
Execute a full compatible migration:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python3 ~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py --execute --preset full --migrate-secrets --skill-conflict skip
|
||||||
|
```
|
||||||
|
|
||||||
|
Execute with workspace instructions included:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python3 ~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py --execute --preset user-data --skill-conflict rename --workspace-target "/absolute/workspace/path"
|
||||||
|
```
|
||||||
|
|
||||||
|
Do not use `$PWD` or the home directory as the workspace target by default. Ask for an explicit workspace path first.
|
||||||
|
|
||||||
|
## Important rules
|
||||||
|
|
||||||
|
1. Run a dry run before writing unless the user explicitly says to proceed immediately.
|
||||||
|
2. Do not migrate secrets by default. Tokens, auth blobs, device credentials, and raw gateway config should stay out of Hermes unless the user explicitly asks for secret migration.
|
||||||
|
3. Do not silently overwrite non-empty Hermes targets unless the user explicitly wants that. The helper script will preserve backups when overwriting is enabled.
|
||||||
|
4. Always give the user the skipped-items report. That report is part of the migration, not an optional extra.
|
||||||
|
5. Prefer the primary OpenClaw workspace (`~/.openclaw/workspace/`) over `workspace.default/`. Only use the default workspace as fallback when the primary files are missing.
|
||||||
|
6. Even in secret-migration mode, only migrate secrets with a clean Hermes destination. Unsupported auth blobs must still be reported as skipped.
|
||||||
|
7. If the dry run shows a large asset copy, a conflicting `SOUL.md`, or overflowed memory entries, call those out separately before execution.
|
||||||
|
8. Default to `user-data only` if the user is unsure.
|
||||||
|
9. Only include `workspace-agents` when the user has explicitly provided a destination workspace path.
|
||||||
|
10. Treat category-level `--include` / `--exclude` as an advanced escape hatch, not the normal flow.
|
||||||
|
11. Do not end the dry-run summary with a vague “What would you like to do?” if `clarify` is available. Use structured follow-up prompts instead.
|
||||||
|
12. Do not use an open-ended `clarify` prompt when a real choice prompt would work. Prefer selectable choices first, then free text only for absolute paths or file review requests.
|
||||||
|
13. After a dry run, never stop after summarizing if there is still an unresolved decision. Use `clarify` immediately for the highest-priority blocking decision.
|
||||||
|
14. Priority order for follow-up questions:
|
||||||
|
- `SOUL.md` conflict
|
||||||
|
- imported skill conflicts
|
||||||
|
- migration mode
|
||||||
|
- workspace instructions destination
|
||||||
|
15. Do not promise to present choices later in the same message. Present them by actually calling `clarify`.
|
||||||
|
16. After the migration-mode answer, explicitly check whether `workspace-agents` is still unresolved. If it is, your next action must be the workspace-instructions `clarify` call.
|
||||||
|
17. After any `clarify` answer, if another required decision remains, do not narrate what was just decided. Ask the next required question immediately.
|
||||||
|
|
||||||
|
## Expected result
|
||||||
|
|
||||||
|
After a successful run, the user should have:
|
||||||
|
|
||||||
|
- Hermes persona state imported
|
||||||
|
- Hermes memory files populated with converted OpenClaw knowledge
|
||||||
|
- OpenClaw skills available under `~/.hermes/skills/openclaw-imports/`
|
||||||
|
- a migration report showing any conflicts, omissions, or unsupported data
|
||||||
File diff suppressed because it is too large
Load diff
366
tests/skills/test_openclaw_migration.py
Normal file
366
tests/skills/test_openclaw_migration.py
Normal file
|
|
@ -0,0 +1,366 @@
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import importlib.util
|
||||||
|
import json
|
||||||
|
import sys
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
|
||||||
|
SCRIPT_PATH = (
|
||||||
|
Path(__file__).resolve().parents[2]
|
||||||
|
/ "optional-skills"
|
||||||
|
/ "migration"
|
||||||
|
/ "openclaw-migration"
|
||||||
|
/ "scripts"
|
||||||
|
/ "openclaw_to_hermes.py"
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def load_module():
|
||||||
|
spec = importlib.util.spec_from_file_location("openclaw_to_hermes", SCRIPT_PATH)
|
||||||
|
module = importlib.util.module_from_spec(spec)
|
||||||
|
assert spec.loader is not None
|
||||||
|
sys.modules[spec.name] = module
|
||||||
|
spec.loader.exec_module(module)
|
||||||
|
return module
|
||||||
|
|
||||||
|
|
||||||
|
def load_skills_guard():
|
||||||
|
spec = importlib.util.spec_from_file_location(
|
||||||
|
"skills_guard_local",
|
||||||
|
Path(__file__).resolve().parents[2] / "tools" / "skills_guard.py",
|
||||||
|
)
|
||||||
|
module = importlib.util.module_from_spec(spec)
|
||||||
|
assert spec.loader is not None
|
||||||
|
sys.modules[spec.name] = module
|
||||||
|
spec.loader.exec_module(module)
|
||||||
|
return module
|
||||||
|
|
||||||
|
|
||||||
|
def test_extract_markdown_entries_promotes_heading_context():
|
||||||
|
mod = load_module()
|
||||||
|
text = """# MEMORY.md - Long-Term Memory
|
||||||
|
|
||||||
|
## Tyler Williams
|
||||||
|
|
||||||
|
- Founder of VANTA Research
|
||||||
|
- Timezone: America/Los_Angeles
|
||||||
|
|
||||||
|
### Active Projects
|
||||||
|
|
||||||
|
- Hermes Agent
|
||||||
|
"""
|
||||||
|
entries = mod.extract_markdown_entries(text)
|
||||||
|
assert "Tyler Williams: Founder of VANTA Research" in entries
|
||||||
|
assert "Tyler Williams: Timezone: America/Los_Angeles" in entries
|
||||||
|
assert "Tyler Williams > Active Projects: Hermes Agent" in entries
|
||||||
|
|
||||||
|
|
||||||
|
def test_merge_entries_respects_limit_and_reports_overflow():
|
||||||
|
mod = load_module()
|
||||||
|
existing = ["alpha"]
|
||||||
|
incoming = ["beta", "gamma is too long"]
|
||||||
|
merged, stats, overflowed = mod.merge_entries(existing, incoming, limit=12)
|
||||||
|
assert merged == ["alpha", "beta"]
|
||||||
|
assert stats["added"] == 1
|
||||||
|
assert stats["overflowed"] == 1
|
||||||
|
assert overflowed == ["gamma is too long"]
|
||||||
|
|
||||||
|
|
||||||
|
def test_resolve_selected_options_supports_include_and_exclude():
|
||||||
|
mod = load_module()
|
||||||
|
selected = mod.resolve_selected_options(["memory,skills", "user-profile"], ["skills"])
|
||||||
|
assert selected == {"memory", "user-profile"}
|
||||||
|
|
||||||
|
|
||||||
|
def test_resolve_selected_options_supports_presets():
|
||||||
|
mod = load_module()
|
||||||
|
user_data = mod.resolve_selected_options(preset="user-data")
|
||||||
|
full = mod.resolve_selected_options(preset="full")
|
||||||
|
assert "secret-settings" not in user_data
|
||||||
|
assert "secret-settings" in full
|
||||||
|
assert user_data < full
|
||||||
|
|
||||||
|
|
||||||
|
def test_resolve_selected_options_rejects_unknown_values():
|
||||||
|
mod = load_module()
|
||||||
|
try:
|
||||||
|
mod.resolve_selected_options(["memory,unknown-option"], None)
|
||||||
|
except ValueError as exc:
|
||||||
|
assert "unknown-option" in str(exc)
|
||||||
|
else:
|
||||||
|
raise AssertionError("Expected ValueError for unknown migration option")
|
||||||
|
|
||||||
|
|
||||||
|
def test_resolve_selected_options_rejects_unknown_preset():
|
||||||
|
mod = load_module()
|
||||||
|
try:
|
||||||
|
mod.resolve_selected_options(preset="everything")
|
||||||
|
except ValueError as exc:
|
||||||
|
assert "everything" in str(exc)
|
||||||
|
else:
|
||||||
|
raise AssertionError("Expected ValueError for unknown migration preset")
|
||||||
|
|
||||||
|
|
||||||
|
def test_migrator_copies_skill_and_merges_allowlist(tmp_path: Path):
|
||||||
|
mod = load_module()
|
||||||
|
source = tmp_path / ".openclaw"
|
||||||
|
target = tmp_path / ".hermes"
|
||||||
|
target.mkdir()
|
||||||
|
|
||||||
|
(source / "workspace" / "skills" / "demo-skill").mkdir(parents=True)
|
||||||
|
(source / "workspace" / "skills" / "demo-skill" / "SKILL.md").write_text(
|
||||||
|
"---\nname: demo-skill\ndescription: demo\n---\n\nbody\n",
|
||||||
|
encoding="utf-8",
|
||||||
|
)
|
||||||
|
(source / "exec-approvals.json").write_text(
|
||||||
|
json.dumps(
|
||||||
|
{
|
||||||
|
"agents": {
|
||||||
|
"*": {
|
||||||
|
"allowlist": [
|
||||||
|
{"pattern": "/usr/bin/*"},
|
||||||
|
{"pattern": "/home/test/**"},
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
),
|
||||||
|
encoding="utf-8",
|
||||||
|
)
|
||||||
|
(target / "config.yaml").write_text("command_allowlist:\n - /usr/bin/*\n", encoding="utf-8")
|
||||||
|
|
||||||
|
migrator = mod.Migrator(
|
||||||
|
source_root=source,
|
||||||
|
target_root=target,
|
||||||
|
execute=True,
|
||||||
|
workspace_target=None,
|
||||||
|
overwrite=False,
|
||||||
|
migrate_secrets=False,
|
||||||
|
output_dir=target / "migration-report",
|
||||||
|
)
|
||||||
|
report = migrator.migrate()
|
||||||
|
|
||||||
|
imported_skill = target / "skills" / mod.SKILL_CATEGORY_DIRNAME / "demo-skill" / "SKILL.md"
|
||||||
|
assert imported_skill.exists()
|
||||||
|
assert "/home/test/**" in (target / "config.yaml").read_text(encoding="utf-8")
|
||||||
|
assert report["summary"]["migrated"] >= 2
|
||||||
|
|
||||||
|
|
||||||
|
def test_migrator_optionally_imports_supported_secrets_and_messaging_settings(tmp_path: Path):
|
||||||
|
mod = load_module()
|
||||||
|
source = tmp_path / ".openclaw"
|
||||||
|
target = tmp_path / ".hermes"
|
||||||
|
|
||||||
|
(source / "credentials").mkdir(parents=True)
|
||||||
|
(source / "openclaw.json").write_text(
|
||||||
|
json.dumps(
|
||||||
|
{
|
||||||
|
"agents": {"defaults": {"workspace": "/tmp/openclaw-workspace"}},
|
||||||
|
"channels": {"telegram": {"botToken": "123:abc"}},
|
||||||
|
}
|
||||||
|
),
|
||||||
|
encoding="utf-8",
|
||||||
|
)
|
||||||
|
(source / "credentials" / "telegram-default-allowFrom.json").write_text(
|
||||||
|
json.dumps({"allowFrom": ["111", "222"]}),
|
||||||
|
encoding="utf-8",
|
||||||
|
)
|
||||||
|
target.mkdir()
|
||||||
|
|
||||||
|
migrator = mod.Migrator(
|
||||||
|
source_root=source,
|
||||||
|
target_root=target,
|
||||||
|
execute=True,
|
||||||
|
workspace_target=None,
|
||||||
|
overwrite=False,
|
||||||
|
migrate_secrets=True,
|
||||||
|
output_dir=target / "migration-report",
|
||||||
|
)
|
||||||
|
migrator.migrate()
|
||||||
|
|
||||||
|
env_text = (target / ".env").read_text(encoding="utf-8")
|
||||||
|
assert "MESSAGING_CWD=/tmp/openclaw-workspace" in env_text
|
||||||
|
assert "TELEGRAM_ALLOWED_USERS=111,222" in env_text
|
||||||
|
assert "TELEGRAM_BOT_TOKEN=123:abc" in env_text
|
||||||
|
|
||||||
|
|
||||||
|
def test_migrator_can_execute_only_selected_categories(tmp_path: Path):
|
||||||
|
mod = load_module()
|
||||||
|
source = tmp_path / ".openclaw"
|
||||||
|
target = tmp_path / ".hermes"
|
||||||
|
target.mkdir()
|
||||||
|
|
||||||
|
(source / "workspace" / "skills" / "demo-skill").mkdir(parents=True)
|
||||||
|
(source / "workspace" / "skills" / "demo-skill" / "SKILL.md").write_text(
|
||||||
|
"---\nname: demo-skill\ndescription: demo\n---\n\nbody\n",
|
||||||
|
encoding="utf-8",
|
||||||
|
)
|
||||||
|
(source / "workspace" / "MEMORY.md").write_text(
|
||||||
|
"# Memory\n\n- keep me\n",
|
||||||
|
encoding="utf-8",
|
||||||
|
)
|
||||||
|
(target / "config.yaml").write_text("command_allowlist: []\n", encoding="utf-8")
|
||||||
|
|
||||||
|
migrator = mod.Migrator(
|
||||||
|
source_root=source,
|
||||||
|
target_root=target,
|
||||||
|
execute=True,
|
||||||
|
workspace_target=None,
|
||||||
|
overwrite=False,
|
||||||
|
migrate_secrets=False,
|
||||||
|
output_dir=target / "migration-report",
|
||||||
|
selected_options={"skills"},
|
||||||
|
)
|
||||||
|
report = migrator.migrate()
|
||||||
|
|
||||||
|
imported_skill = target / "skills" / mod.SKILL_CATEGORY_DIRNAME / "demo-skill" / "SKILL.md"
|
||||||
|
assert imported_skill.exists()
|
||||||
|
assert not (target / "memories" / "MEMORY.md").exists()
|
||||||
|
assert report["selection"]["selected"] == ["skills"]
|
||||||
|
skipped_items = [item for item in report["items"] if item["status"] == "skipped"]
|
||||||
|
assert any(item["kind"] == "memory" and item["reason"] == "Not selected for this run" for item in skipped_items)
|
||||||
|
|
||||||
|
|
||||||
|
def test_migrator_records_preset_in_report(tmp_path: Path):
|
||||||
|
mod = load_module()
|
||||||
|
source = tmp_path / ".openclaw"
|
||||||
|
target = tmp_path / ".hermes"
|
||||||
|
target.mkdir()
|
||||||
|
(target / "config.yaml").write_text("command_allowlist: []\n", encoding="utf-8")
|
||||||
|
|
||||||
|
migrator = mod.Migrator(
|
||||||
|
source_root=source,
|
||||||
|
target_root=target,
|
||||||
|
execute=False,
|
||||||
|
workspace_target=None,
|
||||||
|
overwrite=False,
|
||||||
|
migrate_secrets=False,
|
||||||
|
output_dir=None,
|
||||||
|
selected_options=mod.MIGRATION_PRESETS["user-data"],
|
||||||
|
preset_name="user-data",
|
||||||
|
)
|
||||||
|
report = migrator.build_report()
|
||||||
|
|
||||||
|
assert report["preset"] == "user-data"
|
||||||
|
assert report["selection"]["preset"] == "user-data"
|
||||||
|
assert report["skill_conflict_mode"] == "skip"
|
||||||
|
assert report["selection"]["skill_conflict_mode"] == "skip"
|
||||||
|
|
||||||
|
|
||||||
|
def test_migrator_exports_full_overflow_entries(tmp_path: Path):
|
||||||
|
mod = load_module()
|
||||||
|
source = tmp_path / ".openclaw"
|
||||||
|
target = tmp_path / ".hermes"
|
||||||
|
target.mkdir()
|
||||||
|
(target / "config.yaml").write_text("memory:\n memory_char_limit: 10\n user_char_limit: 10\n", encoding="utf-8")
|
||||||
|
(source / "workspace").mkdir(parents=True)
|
||||||
|
(source / "workspace" / "MEMORY.md").write_text(
|
||||||
|
"# Memory\n\n- alpha\n- beta\n- gamma\n",
|
||||||
|
encoding="utf-8",
|
||||||
|
)
|
||||||
|
|
||||||
|
migrator = mod.Migrator(
|
||||||
|
source_root=source,
|
||||||
|
target_root=target,
|
||||||
|
execute=True,
|
||||||
|
workspace_target=None,
|
||||||
|
overwrite=False,
|
||||||
|
migrate_secrets=False,
|
||||||
|
output_dir=target / "migration-report",
|
||||||
|
selected_options={"memory"},
|
||||||
|
)
|
||||||
|
report = migrator.migrate()
|
||||||
|
|
||||||
|
memory_item = next(item for item in report["items"] if item["kind"] == "memory")
|
||||||
|
overflow_file = Path(memory_item["details"]["overflow_file"])
|
||||||
|
assert overflow_file.exists()
|
||||||
|
text = overflow_file.read_text(encoding="utf-8")
|
||||||
|
assert "alpha" in text or "beta" in text or "gamma" in text
|
||||||
|
|
||||||
|
|
||||||
|
def test_migrator_can_rename_conflicting_imported_skill(tmp_path: Path):
|
||||||
|
mod = load_module()
|
||||||
|
source = tmp_path / ".openclaw"
|
||||||
|
target = tmp_path / ".hermes"
|
||||||
|
target.mkdir()
|
||||||
|
|
||||||
|
source_skill = source / "workspace" / "skills" / "demo-skill"
|
||||||
|
source_skill.mkdir(parents=True)
|
||||||
|
(source_skill / "SKILL.md").write_text(
|
||||||
|
"---\nname: demo-skill\ndescription: demo\n---\n\nbody\n",
|
||||||
|
encoding="utf-8",
|
||||||
|
)
|
||||||
|
|
||||||
|
existing_skill = target / "skills" / mod.SKILL_CATEGORY_DIRNAME / "demo-skill"
|
||||||
|
existing_skill.mkdir(parents=True)
|
||||||
|
(existing_skill / "SKILL.md").write_text(
|
||||||
|
"---\nname: demo-skill\ndescription: existing\n---\n\nexisting\n",
|
||||||
|
encoding="utf-8",
|
||||||
|
)
|
||||||
|
|
||||||
|
migrator = mod.Migrator(
|
||||||
|
source_root=source,
|
||||||
|
target_root=target,
|
||||||
|
execute=True,
|
||||||
|
workspace_target=None,
|
||||||
|
overwrite=False,
|
||||||
|
migrate_secrets=False,
|
||||||
|
output_dir=target / "migration-report",
|
||||||
|
skill_conflict_mode="rename",
|
||||||
|
)
|
||||||
|
report = migrator.migrate()
|
||||||
|
|
||||||
|
renamed_skill = target / "skills" / mod.SKILL_CATEGORY_DIRNAME / "demo-skill-imported" / "SKILL.md"
|
||||||
|
assert renamed_skill.exists()
|
||||||
|
assert existing_skill.joinpath("SKILL.md").read_text(encoding="utf-8").endswith("existing\n")
|
||||||
|
imported_items = [item for item in report["items"] if item["kind"] == "skill" and item["status"] == "migrated"]
|
||||||
|
assert any(item["details"].get("renamed_from", "").endswith("/demo-skill") for item in imported_items)
|
||||||
|
|
||||||
|
|
||||||
|
def test_migrator_can_overwrite_conflicting_imported_skill_with_backup(tmp_path: Path):
|
||||||
|
mod = load_module()
|
||||||
|
source = tmp_path / ".openclaw"
|
||||||
|
target = tmp_path / ".hermes"
|
||||||
|
target.mkdir()
|
||||||
|
|
||||||
|
source_skill = source / "workspace" / "skills" / "demo-skill"
|
||||||
|
source_skill.mkdir(parents=True)
|
||||||
|
(source_skill / "SKILL.md").write_text(
|
||||||
|
"---\nname: demo-skill\ndescription: imported\n---\n\nfresh\n",
|
||||||
|
encoding="utf-8",
|
||||||
|
)
|
||||||
|
|
||||||
|
existing_skill = target / "skills" / mod.SKILL_CATEGORY_DIRNAME / "demo-skill"
|
||||||
|
existing_skill.mkdir(parents=True)
|
||||||
|
(existing_skill / "SKILL.md").write_text(
|
||||||
|
"---\nname: demo-skill\ndescription: existing\n---\n\nexisting\n",
|
||||||
|
encoding="utf-8",
|
||||||
|
)
|
||||||
|
|
||||||
|
migrator = mod.Migrator(
|
||||||
|
source_root=source,
|
||||||
|
target_root=target,
|
||||||
|
execute=True,
|
||||||
|
workspace_target=None,
|
||||||
|
overwrite=False,
|
||||||
|
migrate_secrets=False,
|
||||||
|
output_dir=target / "migration-report",
|
||||||
|
skill_conflict_mode="overwrite",
|
||||||
|
)
|
||||||
|
report = migrator.migrate()
|
||||||
|
|
||||||
|
assert existing_skill.joinpath("SKILL.md").read_text(encoding="utf-8").endswith("fresh\n")
|
||||||
|
backup_items = [item for item in report["items"] if item["kind"] == "skill" and item["status"] == "migrated"]
|
||||||
|
assert any(item["details"].get("backup") for item in backup_items)
|
||||||
|
|
||||||
|
|
||||||
|
def test_skill_installs_cleanly_under_skills_guard():
|
||||||
|
skills_guard = load_skills_guard()
|
||||||
|
result = skills_guard.scan_skill(
|
||||||
|
SCRIPT_PATH.parents[1],
|
||||||
|
source="official/migration/openclaw-migration",
|
||||||
|
)
|
||||||
|
|
||||||
|
assert result.verdict == "safe"
|
||||||
|
assert result.findings == []
|
||||||
Loading…
Add table
Add a link
Reference in a new issue