Skip to content

feat(perps): regenerate the Perps review and add Extension and Core platform overlays - #192

Open
abretonc7s wants to merge 10 commits into
mainfrom
docs/retro-perps-review-snapshot
Open

abretonc7s wants to merge 10 commits into
mainfrom
docs/retro-perps-review-snapshot

Conversation

@abretonc7s

@abretonc7s abretonc7s commented Oct 6, 2026 •

Copy link
Copy Markdown
Contributor

Description

Brings the Perps review and two platform skills up to date with what MetaMask's development runs need, so per-repo agent fixtures outside this repository can be retired.

  • Perps review (perps-review-pr): regenerated from MetaMask/experimental-metamask-recipe-perps @ f9f8cb9 (branch docs/preserve-missing-perps-values) with scripts/materialize-review.mjs. The library update keeps missing values visible and invokes the domain self-review, replaces the removed MYX provider with Lighter, states one formatting rule (formatPerpsFiat for displayed fiat values), points shared utils and services at @metamask/perps-controller instead of a drifting list, and adds that Mobile docs/perps/ pages change with the pattern they document.
  • feature-flags, new MetaMask Extension overlay: names the shared helper, the production-synced E2E registry (reuse synced entries, pre-launch keys with inProd: false), and the E2E override order (manifestFlags.remoteFeatureFlags first; fixture state plus the /v1/flags mock only for code that reads RemoteFeatureFlagController state directly).
  • controller-guidelines, new Core overlay: test both API failure shapes; classify a public type change by AGENTS.md.
  • ab-testing Extension overlay: the stale FixtureBuilder.withRemoteFeatureFlags override line now points at the feature-flags overlay.
  • Install: keep real skills over directories without skill.md, and prune unprefixed aliases before their targets during --prune-stale.

Type of Change

  • New skill
  • Skill improvement/update
  • Bug fix
  • Documentation update
  • Other (please describe):

Checklist

  • I have read the CONTRIBUTING.md guidelines
  • My skill follows the SKILL_TEMPLATE.md format
  • I have tested this skill with an AI agent
  • My skill does not contain any secrets, private keys, or sensitive data
  • I have added appropriate documentation
  • My changes don't break existing skills

Testing

  • node --test test/*.test.mjs: 76 pass (new install cases for alias pruning and skill.md-less directories).
  • yarn lint:changelog passes; lint-skill-entry reports no errors (the tsc-blindspots description is trimmed to the 1024-character budget, which the full-audit run triggered by the installer change enforces).
  • materialize-review.mjs --check verifies perps-review-pr against the library at f9f8cb9.
  • Every claim in the new overlays was checked against current main of metamask-extension and core.

Additional Context

Companion changes: Consensys/skills#92 (Recipe Cook dev and fix-bug templates) and the perps library branch docs/preserve-missing-perps-values.

Adds the missing-numeric-data family and the delayed balance tracker rule.
A later source's directory without skill.md replaced an earlier source's
skill during resolution, then got skipped, so the skill never installed
(consensys testing/mobile-testing shadowed the public mobile-testing).
Prune-stale now also removes unprefixed symlink aliases of managed
skills, such as recipe-cook -> mms-recipe-cook.
Run the alias pass before the stale pass and treat a dangling sibling
mms-* link as an alias, so switching to a smaller selection with
--prune-stale no longer leaves recipe-cook -> mms-recipe-cook dangling.
Cover later-source overrides and aliases in every destination.
Carries the remaining repo knowledge from the Farmslot farm fixtures
into the skills: the Extension feature-flag registry is synced from
production and E2E flag seeds must match the /v1/flags mock; Core tests
both API failure shapes and judges public type changes by AGENTS.md.
…character budget

The full skill audit runs when the installer changes and rejects the 1341-character description; the trimmed one keeps every defect class and the main triggers.
@abretonc7s
abretonc7s marked this pull request as ready for review October 6, 2026 18:12
@abretonc7s
abretonc7s requested a review from a team as a code owner October 6, 2026 18:12

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant