pwn-migrate

Drive PWN::Migrate from pwn_eval.

SKILL.md

GitHub

PWN::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/.schemawith{ schema:, pwn_version:, at: }the first time it runs. Any release that changes the on-disk shape of a/.pwnfile 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_schema
  • needed
  • status
  • check
  • run
  • vault_drift
  • backfill_vault
  • env_template
  • authors
  • help
  • needed?

Source

pwn/migrate.rb

Verification

PWN::Migrate.respond_to?(:installed_schema) after the module is loaded. Read the source for parameter names.