pwn-migrate
Drive PWN::Migrate from pwn_eval.
SKILL.mdetc/default_skills/pwn/migrate/SKILL.md
GitHubPWN::Migrate
PWN::Migrate — the /.pwn state doctor and auto-migrator. PWN persists a growing set of files under `/.pwn(encrypted config, memory, learning outcomes, metrics, mistakes, extrospection, cron jobs, agents, skills, sessions, swarm buses, …). Each file is owned by a different module and each release can add keys or change shape. A user upgradinggem install pwnbetween two versions could therefore hitKeyError, NoMethodError for nil, or a silent empty-fallback because their on-disk state predates the new loader. PWN::Migratecloses that gap. It is called from: *pwn setup --migrate— explicit doctor + autofix *PWN::Setup.check— read-only ~/.pwn state section *PWN::Config.refresh_env— one-line drift warning on every launch It works by: 1. Stamping/.pwn/.schema/.pwnwith{ schema:, pwn_version:, at: }the first time it runs. Any release that changes the on-disk shape of afile bumpsSCHEMA_VERSIONhere and appends an idempotent lambda toMIGRATIONS. 2. Declaratively verifying every state file against its OWNING module's own loader (STATE_FILES) — no re-implemented parsers. If the raw file has bytes but the owner returned its empty-fallback, the file is flagged incompatible. 3. Autofixing: timestamped backup → ordered schema migrations → per-file repair (quarantine corrupt / re-seed missing) → pwn.yamldeep-key backfill (missing keys from the currentPWN::Config.env_template` are merged in-place under the user's values, then the vault is re-encrypted with the SAME key/iv). Everything is idempotent, dry-run capable, and never overwrites a user-set value.
When to use
Call PWN::Migrate from pwn_eval when the task needs this module.
Do not reimplement it in shell.
Methodologies
Generated from pwn/migrate.rb. Prefer the public class methods below.
Class methods take (opts = {}) and read opts.
How to call
PWN::Migrate.help
PWN::Migrate.installed_schema(opts)
Public methods
installed_schemaneededstatuscheckrunvault_driftbackfill_vaultenv_templateauthorshelpneeded?
Source
pwn/migrate.rb
Verification
PWN::Migrate.respond_to?(:installed_schema) after the
module is loaded. Read the source for parameter names.