feat: support metta://policy/<short_name_or_class_path> URIs for built-in policies

[daveey]

TL;DR

Added GitHub integration instructions and support for built-in policy URIs.

What changed?

• Added a section to CLAUDE.md about GitHub integration, recommending the use of Graphite ("gt") for creating PRs and providing branch naming conventions
• Enhanced the policy_spec_from_uri function to handle metta://policy/<builtin> URIs for built-in policies
• Implemented logic to resolve policy identifiers from the policy registry or interpret them as full class paths

How to test?

1. Verify that metta://policy/some_registered_policy URIs correctly resolve to the appropriate policy class
2. Test with both registered short names and full class paths (containing dots)
3. Ensure the policy registry is properly populated via discover_and_register_policies()

Why make this change?

This change improves developer workflow by documenting GitHub integration practices and enhances the URI resolution system to support built-in policies through a convenient URI scheme. The metta://policy/ URI format provides a standardized way to reference built-in policies without needing to specify full file paths.

[daveey]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• Enhance attack system with armor, weapons, and configurable loot #4313 : 2 dependent PRs (#4321 , #4477 )
• Make Transfer action optional and add vibe-triggered attack #4315
• Implement bidirectional resource transfer system with vibe-based triggers #4314
• feat: support metta://policy/<short_name_or_class_path> URIs for built-in policies #4561 👈 (View in Graphite)
• feat: allow negative inventory_regen_amounts for decay #4564
• Add clarification about when to run install commands #4563
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Avoid shadowing metta:// policy names with built-ins

This new early return for metta://policy/<identifier> intercepts all such URIs before the MettaSchemeResolver path can resolve policies from the stats server. If a stats-server policy is named the same as a built‑in short name (e.g. random, stateless, lstm, mpt), metta://policy/random will now load the built‑in policy instead of the registered policy version, silently changing evaluation/training behavior. This is a regression from the previous flow where resolve_uri would route metta://policy/* through MettaSchemeResolver. Consider only treating built‑ins when explicitly namespaced (or after a failed stats lookup) so stats policies aren’t shadowed.

Useful? React with 👍 / 👎.

[graphite-app]

Merge activity

• Dec 29, 9:29 PM UTC: Graphite rebased this pull request, because this pull request is set to merge when ready.
• Dec 29, 9:34 PM UTC: Graphite rebased this pull request, because this pull request is set to merge when ready.

[datadog-official]

⚠️ Tests

⚠️ Warnings

🧪 1 Test failed

test_launch_two_token_syntax from test_launch.py (Datadog)

Expected exit code 0, got 1
  stderr: 
assert 1 == 0
 +  where 1 = <Result SystemExit(1)>.exit_code

ℹ️ Info

❄️ No new flaky tests detected

_{This comment will be updated automatically if new data arrives.
🔗 Commit SHA: 24a4af1 | Docs | Was this helpful? Give us feedback!}