pandora-cli-skills 1.1.128 → 1.1.129

package/README.md

@@ -95,6 +95,7 @@ npm install
 npx pandora setup --interactive
 npm run doctor
 npm run build
+npm run verify:repo
 npx pandora help
 ```
 
@@ -103,7 +104,8 @@ What each step is for:
 - `npm install`: install the local CLI and docs/test dependencies
 - `npx pandora setup --interactive`: scaffold and validate the first-run onboarding path
 - `npm run doctor`: inspect local runtime readiness before live work
-- `npm run build`: run the repo’s verification gates, including docs, trust, SDK parity, and benchmark checks
+- `npm run build`: run the TypeScript typecheck gate
+- `npm run verify:repo`: run repo-wide verification for docs, trust, SDK parity, and hygiene
 - `npx pandora help`: browse the command surface manually
 
 If you prefer manual control, use `npm run init-env` first and then `npm run doctor`. Guided onboarding is optional and can be skipped at any step.
@@ -263,6 +265,7 @@ npx pandora --output json profile explain --id market_observer_ro
 - Policies, profiles, and scopes: [`docs/skills/policy-profiles.md`](./docs/skills/policy-profiles.md)
 - Recipes: [`docs/skills/recipes.md`](./docs/skills/recipes.md)
 - Benchmarks and scorecards: [`docs/benchmarks/README.md`](./docs/benchmarks/README.md), [`docs/benchmarks/scenario-catalog.md`](./docs/benchmarks/scenario-catalog.md), [`docs/benchmarks/scorecard.md`](./docs/benchmarks/scorecard.md)
+- Proving-ground research lane: [`docs/proving-ground/README.md`](./docs/proving-ground/README.md)
 - Trust and release posture: [`docs/trust/release-verification.md`](./docs/trust/release-verification.md), [`docs/trust/release-bundle-playbook.md`](./docs/trust/release-bundle-playbook.md), [`docs/trust/security-model.md`](./docs/trust/security-model.md), [`docs/trust/support-matrix.md`](./docs/trust/support-matrix.md)
 
 ## SDK Surfaces
@@ -286,6 +289,9 @@ Notes:
 |-- docs/skills/          operator and agent documentation
 |-- docs/trust/           release, security, and support docs
 |-- docs/benchmarks/      benchmark methodology and scorecards
+|-- docs/proving-ground/  proving-ground explainer docs
+|-- knowledge-base/       maintained repo wiki layer
+|-- proving-ground/       sandbox research lane and generated local evidence
 |-- sdk/typescript/       TypeScript SDK surface
 |-- sdk/python/           Python SDK surface
 |-- sdk/generated/        shared generated contract bundle

package/README_FOR_SHARING.md

@@ -64,6 +64,7 @@ docs/
   skills/               human and agent documentation
   trust/                release, security, and support docs
   benchmarks/           benchmark methodology and scorecards
+  proving-ground/       research-lane explainer docs
 sdk/
   typescript/           TypeScript SDK surface
   python/               Python SDK surface
@@ -81,6 +82,7 @@ Included files of interest:
 - `docs/skills/*.md`
 - `docs/trust/*.md`
 - `docs/benchmarks/**`
+- `docs/proving-ground/**`
 - `benchmarks/latest/core-report.json`
 - `sdk/generated/*`
 - `sdk/typescript/**`
@@ -247,6 +249,7 @@ bootstrap
 - Policies, profiles, and scopes: [`docs/skills/policy-profiles.md`](./docs/skills/policy-profiles.md)
 - Recipes: [`docs/skills/recipes.md`](./docs/skills/recipes.md)
 - Benchmarks: [`docs/benchmarks/README.md`](./docs/benchmarks/README.md), [`docs/benchmarks/scenario-catalog.md`](./docs/benchmarks/scenario-catalog.md), [`docs/benchmarks/scorecard.md`](./docs/benchmarks/scorecard.md)
+- Proving-ground research lane: [`docs/proving-ground/README.md`](./docs/proving-ground/README.md)
 - Trust docs: [`docs/trust/release-verification.md`](./docs/trust/release-verification.md), [`docs/trust/release-bundle-playbook.md`](./docs/trust/release-bundle-playbook.md), [`docs/trust/security-model.md`](./docs/trust/security-model.md), [`docs/trust/support-matrix.md`](./docs/trust/support-matrix.md)
 
 ## SDK Surfaces

package/SKILL.md

@@ -133,10 +133,11 @@ First move:
 - Anthropic skill install and evaluation docs:
   - [`docs/skills/install-anthropic-skill.md`](./docs/skills/install-anthropic-skill.md)
   - [`docs/skills/anthropic-skill-evals.md`](./docs/skills/anthropic-skill-evals.md)
-- Benchmark methodology and score interpretation:
+- Benchmark and proving-ground evaluation docs:
   - [`docs/benchmarks/README.md`](./docs/benchmarks/README.md)
   - [`docs/benchmarks/scenario-catalog.md`](./docs/benchmarks/scenario-catalog.md)
   - [`docs/benchmarks/scorecard.md`](./docs/benchmarks/scorecard.md)
+  - [`docs/proving-ground/README.md`](./docs/proving-ground/README.md)
 - Release verification and trust posture:
   - [`docs/trust/release-verification.md`](./docs/trust/release-verification.md)
   - [`docs/trust/security-model.md`](./docs/trust/security-model.md)

package/benchmarks/latest/core-bundle.json

@@ -1,18 +1,18 @@
 {
   "schemaVersion": "1.0.0",
   "suite": "core",
-  "generatedAt": "2026-03-28T18:16:20.266Z",
+  "generatedAt": "2026-04-05T22:25:33.752Z",
   "package": {
     "name": "pandora-cli-skills",
-    "version": "1.1.128"
+    "version": "1.1.129"
   },
   "assets": {
     "reportPath": "benchmarks/latest/core-report.json",
     "lockPath": "benchmarks/locks/core.lock.json",
     "historyPath": "benchmarks/latest/core-history.json",
     "docsHistoryPath": "docs/benchmarks/history.json",
-    "reportSha256": "28ca830612444fc4da175fd3d1d8815ff331b44b19081f1ad730a17e0d76fec8",
-    "lockSha256": "4d1d02e2b44d5c996dac30d1038ed496b6536a1a9cdf5885d3a682f72285d2d0"
+    "reportSha256": "94caa32a45f24ebaf36ade64d92b642e36fa333be330b4e70502c606415ad0be",
+    "lockSha256": "7df51d1d695ce33ac0dc1292766d9f62d4ea224b30054613e93ef83d11626000"
   },
   "latest": {
     "summary": {
@@ -144,68 +144,97 @@
       ]
     },
     "runtime": {
-      "packageVersion": "1.1.128"
+      "packageVersion": "1.1.129"
     },
     "contractLock": {
-      "capabilitiesLocalHash": "234948154a514575db24bf36a3a1959ffa52825d221fda6341b9bdf033ba857b",
-      "capabilitiesRemoteTemplateHash": "4f1ee42dfcdefa2708dcc85cc16fe3dd25426562911a833600b315f94fc364f8",
+      "capabilitiesLocalHash": "99c1518dac4d608f9ff652d3945070c90fedbaf49838f492714a2e109163c885",
+      "capabilitiesRemoteTemplateHash": "b3f2aef2a799653a525d50f0902447ae5ed90cdfbcbae02627ef8e964e47556a",
       "commandDescriptorVersion": "1.4.3",
-      "documentationContentHash": "74fc7863c3b3f684149f2feb518c9b0c9f9d7ef113c09dd8ba1872f690ab7f95",
-      "documentationRegistryHash": "2bca31729c9c580125bd25764291699b63532afaa67d9380c72d1dda637944b7",
+      "documentationContentHash": "cb130209bc40f5bdb9fccbd55ad07b6ec1fefbc95ab0d11fe6d50ef8eb6fa566",
+      "documentationRegistryHash": "eebe2a201c559e44b45d1a780713f6b302f56726a03a4a57538fcf6762530826",
       "generatedArtifactHashes": {
-        "generatedCommandDescriptors": "5f415b7528d7e5b6086a96032d4d29d58e90ca082704f6bb4b25afd8f89c3fae",
-        "generatedContractRegistry": "db1a9655e99a92ca81b3bfc934b8658ef42584c312c5488f2c699cce080b864c",
-        "generatedManifest": "b4ae9d0b063ba2a04e3ea41a8330fbe7dc095f4180e616bc034e4901bde9ffe1",
-        "generatedMcpToolDefinitions": "b37ce9423e4672326a42038dd2a99d04e9e5c9077d7613b9b516b4655cd1f16c",
-        "pyCommandDescriptors": "5f415b7528d7e5b6086a96032d4d29d58e90ca082704f6bb4b25afd8f89c3fae",
-        "pyContractRegistry": "db1a9655e99a92ca81b3bfc934b8658ef42584c312c5488f2c699cce080b864c",
-        "pyManifest": "bc70ded5deabf23bd688aef4fb35e6f78590f7a883861d3eae75ab5a5fe7150f",
-        "pyMcpToolDefinitions": "b37ce9423e4672326a42038dd2a99d04e9e5c9077d7613b9b516b4655cd1f16c",
-        "tsCommandDescriptors": "5f415b7528d7e5b6086a96032d4d29d58e90ca082704f6bb4b25afd8f89c3fae",
-        "tsContractRegistry": "db1a9655e99a92ca81b3bfc934b8658ef42584c312c5488f2c699cce080b864c",
-        "tsManifest": "cda400d5fbd005646128c7b1a0cdd324a95328c63a1630872b5303b7dfb3adf4",
-        "tsMcpToolDefinitions": "b37ce9423e4672326a42038dd2a99d04e9e5c9077d7613b9b516b4655cd1f16c"
+        "generatedCommandDescriptors": "60ab2ae91d950b5639093413fb1806d979f024203ffad0b686705a94d5b06e07",
+        "generatedContractRegistry": "fe8b9a3b82f1490b37448a109c4f3f0ff4fbf4ee7c90902d7e79edf60612498b",
+        "generatedManifest": "bbd5d4175d871062c4c148f912baa6523dce57208dd25db98daabb434aace14f",
+        "generatedMcpToolDefinitions": "6dc62098f1c71b3816d75115ab5e31734484d9bc19ecff0bce32e7ab50fc00d6",
+        "pyCommandDescriptors": "60ab2ae91d950b5639093413fb1806d979f024203ffad0b686705a94d5b06e07",
+        "pyContractRegistry": "fe8b9a3b82f1490b37448a109c4f3f0ff4fbf4ee7c90902d7e79edf60612498b",
+        "pyManifest": "ad8226fc146d310e85223d86640d7dda04918f0f6b24050084202cab51c56661",
+        "pyMcpToolDefinitions": "6dc62098f1c71b3816d75115ab5e31734484d9bc19ecff0bce32e7ab50fc00d6",
+        "tsCommandDescriptors": "60ab2ae91d950b5639093413fb1806d979f024203ffad0b686705a94d5b06e07",
+        "tsContractRegistry": "fe8b9a3b82f1490b37448a109c4f3f0ff4fbf4ee7c90902d7e79edf60612498b",
+        "tsManifest": "e75660c84753fc91de7b54c5f9adcb35df9a4535966bea3e5d7545e009229e99",
+        "tsMcpToolDefinitions": "6dc62098f1c71b3816d75115ab5e31734484d9bc19ecff0bce32e7ab50fc00d6"
       },
       "generatedManifestCommandDescriptorVersion": "1.4.3",
       "generatedManifestPackageVersion": "0.1.0-alpha.21",
       "generatedManifestRegistryDigest": {
         "canonicalHash": "cce2ede8f658d43e0807f7f194e28fc356085e00fc70d99d27ecbd674be14a9f",
-        "commandDigestHash": "ff5ffd264b768cb059973405a2bbac264e790e8c583ce066668263259cf9d565",
-        "descriptorHash": "0ce356cf2e77ac1228df9de4a89d5b4bcba73fb5b43a83cf59d34b92bc561d46",
-        "documentationHash": "2bca31729c9c580125bd25764291699b63532afaa67d9380c72d1dda637944b7",
-        "fullDescriptorHash": "a90cc06c3d9ab9068f87e2b1005847e685b7f86952cba5b2af9d2e38b8f963bb",
+        "commandDigestHash": "85f685455fdf85b757674a3086eb03354a628f22ada1a25afee0fd86b14b92c7",
+        "descriptorHash": "664970d781e477a11a683bc265cbd7fc8b0cf9576b50da49ab301b773e38b47d",
+        "documentationHash": "eebe2a201c559e44b45d1a780713f6b302f56726a03a4a57538fcf6762530826",
+        "fullDescriptorHash": "422f7c73ce499d926c92ea792b0c590c41c916dac377cf6790c5465d1eb5f384",
         "namespaceHash": "cd39afc4f4e8b76473a4768c07d979c44e0421973786c54e12bb6d7888f5952a",
         "policyProfilesHash": "9fb054a4f29be73c2ebf33f643bc17d904b2872dd8e7d564a690db828071a7ce",
         "principalTemplatesHash": "525835bb3c4710fa326e662e8a961e74de1798f4fb1bccb2a00be557ed037740",
         "routedTopLevelHash": "02e98ac94f1eadbeded065bef652f8a917f108a8a08726ad7163503cc1b3384d",
         "topLevelHash": "04e58344eaec2c14dfa336b13eff952a584c7c5355d90775c3bc8336ab0752ee",
-        "trustDistributionHash": "7d7b666b4376791a20e9851954953805368c70059921bdc9de714bcb2732f80f"
+        "trustDistributionHash": "3a926813503a3638bd98ce9689077494031ba758b0a322c4218815935d105459"
       },
       "generatedManifestVersion": "1.0.0",
       "registryDigest": {
         "canonicalHash": "cce2ede8f658d43e0807f7f194e28fc356085e00fc70d99d27ecbd674be14a9f",
-        "commandDigestHash": "ff5ffd264b768cb059973405a2bbac264e790e8c583ce066668263259cf9d565",
-        "descriptorHash": "0ce356cf2e77ac1228df9de4a89d5b4bcba73fb5b43a83cf59d34b92bc561d46",
-        "documentationHash": "2bca31729c9c580125bd25764291699b63532afaa67d9380c72d1dda637944b7",
-        "fullDescriptorHash": "a90cc06c3d9ab9068f87e2b1005847e685b7f86952cba5b2af9d2e38b8f963bb",
+        "commandDigestHash": "85f685455fdf85b757674a3086eb03354a628f22ada1a25afee0fd86b14b92c7",
+        "descriptorHash": "664970d781e477a11a683bc265cbd7fc8b0cf9576b50da49ab301b773e38b47d",
+        "documentationHash": "eebe2a201c559e44b45d1a780713f6b302f56726a03a4a57538fcf6762530826",
+        "fullDescriptorHash": "422f7c73ce499d926c92ea792b0c590c41c916dac377cf6790c5465d1eb5f384",
         "namespaceHash": "cd39afc4f4e8b76473a4768c07d979c44e0421973786c54e12bb6d7888f5952a",
         "policyProfilesHash": "9fb054a4f29be73c2ebf33f643bc17d904b2872dd8e7d564a690db828071a7ce",
         "principalTemplatesHash": "525835bb3c4710fa326e662e8a961e74de1798f4fb1bccb2a00be557ed037740",
         "routedTopLevelHash": "02e98ac94f1eadbeded065bef652f8a917f108a8a08726ad7163503cc1b3384d",
         "topLevelHash": "04e58344eaec2c14dfa336b13eff952a584c7c5355d90775c3bc8336ab0752ee",
-        "trustDistributionHash": "7d7b666b4376791a20e9851954953805368c70059921bdc9de714bcb2732f80f"
+        "trustDistributionHash": "3a926813503a3638bd98ce9689077494031ba758b0a322c4218815935d105459"
       },
-      "schemaHash": "d3b9c2aa7df64647187584fdccbb4e62b459e072537136aa4c9795ad87d98701"
+      "schemaHash": "491cbbceb1c302dd6c9fa5a60509b74c46a17d1be2eb0dbe5522cd141d4b0d18"
     },
     "contractLockMatchesExpected": true
   },
   "history": {
     "schemaVersion": "1.0.0",
     "suite": "core",
-    "generatedAt": "2026-03-28T18:16:20.266Z",
-    "latestVersion": "1.1.128",
-    "latestGeneratedAt": "2026-03-28T18:16:20.266Z",
+    "generatedAt": "2026-04-05T22:25:33.752Z",
+    "latestVersion": "1.1.129",
+    "latestGeneratedAt": "2026-04-05T22:25:33.752Z",
     "entries": [
+      {
+        "schemaVersion": "1.0.0",
+        "suite": "core",
+        "packageName": "pandora-cli-skills",
+        "version": "1.1.129",
+        "packageVersion": "1.1.129",
+        "generatedAt": "2026-04-05T22:25:33.752Z",
+        "summary": {
+          "weightedScore": 100,
+          "overallPass": true,
+          "scenarioCount": 19,
+          "passedCount": 19,
+          "failedCount": 0,
+          "failedParityGroupCount": 0
+        },
+        "weightedScore": 100,
+        "overallPass": true,
+        "scenarioCount": 19,
+        "passedCount": 19,
+        "failedCount": 0,
+        "failedParityGroupCount": 0,
+        "contractLockMatchesExpected": true,
+        "parityFailedGroups": [],
+        "descriptorHash": "664970d781e477a11a683bc265cbd7fc8b0cf9576b50da49ab301b773e38b47d",
+        "documentationContentHash": "cb130209bc40f5bdb9fccbd55ad07b6ec1fefbc95ab0d11fe6d50ef8eb6fa566",
+        "reportSha256": "94caa32a45f24ebaf36ade64d92b642e36fa333be330b4e70502c606415ad0be",
+        "lockSha256": "7df51d1d695ce33ac0dc1292766d9f62d4ea224b30054613e93ef83d11626000",
+        "lockSchemaVersion": "1.0.0"
+      },
       {
         "schemaVersion": "1.0.0",
         "suite": "core",

package/benchmarks/latest/core-history.json

@@ -1,10 +1,39 @@
 {
   "schemaVersion": "1.0.0",
   "suite": "core",
-  "generatedAt": "2026-03-28T18:16:20.266Z",
-  "latestVersion": "1.1.128",
-  "latestGeneratedAt": "2026-03-28T18:16:20.266Z",
+  "generatedAt": "2026-04-05T22:25:33.752Z",
+  "latestVersion": "1.1.129",
+  "latestGeneratedAt": "2026-04-05T22:25:33.752Z",
   "entries": [
+    {
+      "schemaVersion": "1.0.0",
+      "suite": "core",
+      "packageName": "pandora-cli-skills",
+      "version": "1.1.129",
+      "packageVersion": "1.1.129",
+      "generatedAt": "2026-04-05T22:25:33.752Z",
+      "summary": {
+        "weightedScore": 100,
+        "overallPass": true,
+        "scenarioCount": 19,
+        "passedCount": 19,
+        "failedCount": 0,
+        "failedParityGroupCount": 0
+      },
+      "weightedScore": 100,
+      "overallPass": true,
+      "scenarioCount": 19,
+      "passedCount": 19,
+      "failedCount": 0,
+      "failedParityGroupCount": 0,
+      "contractLockMatchesExpected": true,
+      "parityFailedGroups": [],
+      "descriptorHash": "664970d781e477a11a683bc265cbd7fc8b0cf9576b50da49ab301b773e38b47d",
+      "documentationContentHash": "cb130209bc40f5bdb9fccbd55ad07b6ec1fefbc95ab0d11fe6d50ef8eb6fa566",
+      "reportSha256": "94caa32a45f24ebaf36ade64d92b642e36fa333be330b4e70502c606415ad0be",
+      "lockSha256": "7df51d1d695ce33ac0dc1292766d9f62d4ea224b30054613e93ef83d11626000",
+      "lockSchemaVersion": "1.0.0"
+    },
     {
       "schemaVersion": "1.0.0",
       "suite": "core",

package/benchmarks/latest/core-report.json

@@ -1,54 +1,54 @@
 {
   "contractLock": {
-    "capabilitiesLocalHash": "234948154a514575db24bf36a3a1959ffa52825d221fda6341b9bdf033ba857b",
-    "capabilitiesRemoteTemplateHash": "4f1ee42dfcdefa2708dcc85cc16fe3dd25426562911a833600b315f94fc364f8",
+    "capabilitiesLocalHash": "99c1518dac4d608f9ff652d3945070c90fedbaf49838f492714a2e109163c885",
+    "capabilitiesRemoteTemplateHash": "b3f2aef2a799653a525d50f0902447ae5ed90cdfbcbae02627ef8e964e47556a",
     "commandDescriptorVersion": "1.4.3",
-    "documentationContentHash": "74fc7863c3b3f684149f2feb518c9b0c9f9d7ef113c09dd8ba1872f690ab7f95",
-    "documentationRegistryHash": "2bca31729c9c580125bd25764291699b63532afaa67d9380c72d1dda637944b7",
+    "documentationContentHash": "cb130209bc40f5bdb9fccbd55ad07b6ec1fefbc95ab0d11fe6d50ef8eb6fa566",
+    "documentationRegistryHash": "eebe2a201c559e44b45d1a780713f6b302f56726a03a4a57538fcf6762530826",
     "generatedArtifactHashes": {
-      "generatedCommandDescriptors": "5f415b7528d7e5b6086a96032d4d29d58e90ca082704f6bb4b25afd8f89c3fae",
-      "generatedContractRegistry": "db1a9655e99a92ca81b3bfc934b8658ef42584c312c5488f2c699cce080b864c",
-      "generatedManifest": "b4ae9d0b063ba2a04e3ea41a8330fbe7dc095f4180e616bc034e4901bde9ffe1",
-      "generatedMcpToolDefinitions": "b37ce9423e4672326a42038dd2a99d04e9e5c9077d7613b9b516b4655cd1f16c",
-      "pyCommandDescriptors": "5f415b7528d7e5b6086a96032d4d29d58e90ca082704f6bb4b25afd8f89c3fae",
-      "pyContractRegistry": "db1a9655e99a92ca81b3bfc934b8658ef42584c312c5488f2c699cce080b864c",
-      "pyManifest": "bc70ded5deabf23bd688aef4fb35e6f78590f7a883861d3eae75ab5a5fe7150f",
-      "pyMcpToolDefinitions": "b37ce9423e4672326a42038dd2a99d04e9e5c9077d7613b9b516b4655cd1f16c",
-      "tsCommandDescriptors": "5f415b7528d7e5b6086a96032d4d29d58e90ca082704f6bb4b25afd8f89c3fae",
-      "tsContractRegistry": "db1a9655e99a92ca81b3bfc934b8658ef42584c312c5488f2c699cce080b864c",
-      "tsManifest": "cda400d5fbd005646128c7b1a0cdd324a95328c63a1630872b5303b7dfb3adf4",
-      "tsMcpToolDefinitions": "b37ce9423e4672326a42038dd2a99d04e9e5c9077d7613b9b516b4655cd1f16c"
+      "generatedCommandDescriptors": "60ab2ae91d950b5639093413fb1806d979f024203ffad0b686705a94d5b06e07",
+      "generatedContractRegistry": "fe8b9a3b82f1490b37448a109c4f3f0ff4fbf4ee7c90902d7e79edf60612498b",
+      "generatedManifest": "bbd5d4175d871062c4c148f912baa6523dce57208dd25db98daabb434aace14f",
+      "generatedMcpToolDefinitions": "6dc62098f1c71b3816d75115ab5e31734484d9bc19ecff0bce32e7ab50fc00d6",
+      "pyCommandDescriptors": "60ab2ae91d950b5639093413fb1806d979f024203ffad0b686705a94d5b06e07",
+      "pyContractRegistry": "fe8b9a3b82f1490b37448a109c4f3f0ff4fbf4ee7c90902d7e79edf60612498b",
+      "pyManifest": "ad8226fc146d310e85223d86640d7dda04918f0f6b24050084202cab51c56661",
+      "pyMcpToolDefinitions": "6dc62098f1c71b3816d75115ab5e31734484d9bc19ecff0bce32e7ab50fc00d6",
+      "tsCommandDescriptors": "60ab2ae91d950b5639093413fb1806d979f024203ffad0b686705a94d5b06e07",
+      "tsContractRegistry": "fe8b9a3b82f1490b37448a109c4f3f0ff4fbf4ee7c90902d7e79edf60612498b",
+      "tsManifest": "e75660c84753fc91de7b54c5f9adcb35df9a4535966bea3e5d7545e009229e99",
+      "tsMcpToolDefinitions": "6dc62098f1c71b3816d75115ab5e31734484d9bc19ecff0bce32e7ab50fc00d6"
     },
     "generatedManifestCommandDescriptorVersion": "1.4.3",
     "generatedManifestPackageVersion": "0.1.0-alpha.21",
     "generatedManifestRegistryDigest": {
       "canonicalHash": "cce2ede8f658d43e0807f7f194e28fc356085e00fc70d99d27ecbd674be14a9f",
-      "commandDigestHash": "ff5ffd264b768cb059973405a2bbac264e790e8c583ce066668263259cf9d565",
-      "descriptorHash": "0ce356cf2e77ac1228df9de4a89d5b4bcba73fb5b43a83cf59d34b92bc561d46",
-      "documentationHash": "2bca31729c9c580125bd25764291699b63532afaa67d9380c72d1dda637944b7",
-      "fullDescriptorHash": "a90cc06c3d9ab9068f87e2b1005847e685b7f86952cba5b2af9d2e38b8f963bb",
+      "commandDigestHash": "85f685455fdf85b757674a3086eb03354a628f22ada1a25afee0fd86b14b92c7",
+      "descriptorHash": "664970d781e477a11a683bc265cbd7fc8b0cf9576b50da49ab301b773e38b47d",
+      "documentationHash": "eebe2a201c559e44b45d1a780713f6b302f56726a03a4a57538fcf6762530826",
+      "fullDescriptorHash": "422f7c73ce499d926c92ea792b0c590c41c916dac377cf6790c5465d1eb5f384",
       "namespaceHash": "cd39afc4f4e8b76473a4768c07d979c44e0421973786c54e12bb6d7888f5952a",
       "policyProfilesHash": "9fb054a4f29be73c2ebf33f643bc17d904b2872dd8e7d564a690db828071a7ce",
       "principalTemplatesHash": "525835bb3c4710fa326e662e8a961e74de1798f4fb1bccb2a00be557ed037740",
       "routedTopLevelHash": "02e98ac94f1eadbeded065bef652f8a917f108a8a08726ad7163503cc1b3384d",
       "topLevelHash": "04e58344eaec2c14dfa336b13eff952a584c7c5355d90775c3bc8336ab0752ee",
-      "trustDistributionHash": "7d7b666b4376791a20e9851954953805368c70059921bdc9de714bcb2732f80f"
+      "trustDistributionHash": "3a926813503a3638bd98ce9689077494031ba758b0a322c4218815935d105459"
     },
     "generatedManifestVersion": "1.0.0",
     "registryDigest": {
       "canonicalHash": "cce2ede8f658d43e0807f7f194e28fc356085e00fc70d99d27ecbd674be14a9f",
-      "commandDigestHash": "ff5ffd264b768cb059973405a2bbac264e790e8c583ce066668263259cf9d565",
-      "descriptorHash": "0ce356cf2e77ac1228df9de4a89d5b4bcba73fb5b43a83cf59d34b92bc561d46",
-      "documentationHash": "2bca31729c9c580125bd25764291699b63532afaa67d9380c72d1dda637944b7",
-      "fullDescriptorHash": "a90cc06c3d9ab9068f87e2b1005847e685b7f86952cba5b2af9d2e38b8f963bb",
+      "commandDigestHash": "85f685455fdf85b757674a3086eb03354a628f22ada1a25afee0fd86b14b92c7",
+      "descriptorHash": "664970d781e477a11a683bc265cbd7fc8b0cf9576b50da49ab301b773e38b47d",
+      "documentationHash": "eebe2a201c559e44b45d1a780713f6b302f56726a03a4a57538fcf6762530826",
+      "fullDescriptorHash": "422f7c73ce499d926c92ea792b0c590c41c916dac377cf6790c5465d1eb5f384",
       "namespaceHash": "cd39afc4f4e8b76473a4768c07d979c44e0421973786c54e12bb6d7888f5952a",
       "policyProfilesHash": "9fb054a4f29be73c2ebf33f643bc17d904b2872dd8e7d564a690db828071a7ce",
       "principalTemplatesHash": "525835bb3c4710fa326e662e8a961e74de1798f4fb1bccb2a00be557ed037740",
       "routedTopLevelHash": "02e98ac94f1eadbeded065bef652f8a917f108a8a08726ad7163503cc1b3384d",
       "topLevelHash": "04e58344eaec2c14dfa336b13eff952a584c7c5355d90775c3bc8336ab0752ee",
-      "trustDistributionHash": "7d7b666b4376791a20e9851954953805368c70059921bdc9de714bcb2732f80f"
+      "trustDistributionHash": "3a926813503a3638bd98ce9689077494031ba758b0a322c4218815935d105459"
     },
-    "schemaHash": "d3b9c2aa7df64647187584fdccbb4e62b459e072537136aa4c9795ad87d98701"
+    "schemaHash": "491cbbceb1c302dd6c9fa5a60509b74c46a17d1be2eb0dbe5522cd141d4b0d18"
   },
   "contractLockMatchesExpected": true,
   "contractLockMismatches": [],
@@ -284,7 +284,7 @@
     ]
   },
   "publication": {
-    "contractLockHash": "a4bd815ef65a25b65b6e17a0bfb0e46989cee4398aa652a310d448c40abc47dd",
+    "contractLockHash": "561a99c5164b8dccfbe6ad83c36531462e46a0ae35b5332ad17e1f11f5b5ccae",
     "contractLockStatus": "locked",
     "deterministic": true,
     "expectedScenarioCount": 19,
@@ -293,12 +293,12 @@
     "minimumWeightedScore": 95,
     "releaseGatePass": true,
     "reportPath": "benchmarks/latest/core-report.json",
-    "scorecardHash": "849ddbf08196116b5137360cb135b062bb4289cecc51c9c00c9380b1a78ff659",
-    "suiteLockHash": "4d1d02e2b44d5c996dac30d1038ed496b6536a1a9cdf5885d3a682f72285d2d0",
+    "scorecardHash": "5a014e14aa2503889b833507f421a4b1d208d62d2f03c5c34ba34a3d6d450058",
+    "suiteLockHash": "7df51d1d695ce33ac0dc1292766d9f62d4ea224b30054613e93ef83d11626000",
     "suiteLockPath": "benchmarks/locks/core.lock.json"
   },
   "runtime": {
-    "packageVersion": "1.1.128"
+    "packageVersion": "1.1.129"
   },
   "scenarios": [
     {

package/benchmarks/locks/core.lock.json

@@ -1,61 +1,61 @@
 {
   "contractLock": {
-    "capabilitiesLocalHash": "234948154a514575db24bf36a3a1959ffa52825d221fda6341b9bdf033ba857b",
-    "capabilitiesRemoteTemplateHash": "4f1ee42dfcdefa2708dcc85cc16fe3dd25426562911a833600b315f94fc364f8",
+    "capabilitiesLocalHash": "99c1518dac4d608f9ff652d3945070c90fedbaf49838f492714a2e109163c885",
+    "capabilitiesRemoteTemplateHash": "b3f2aef2a799653a525d50f0902447ae5ed90cdfbcbae02627ef8e964e47556a",
     "commandDescriptorVersion": "1.4.3",
-    "documentationContentHash": "74fc7863c3b3f684149f2feb518c9b0c9f9d7ef113c09dd8ba1872f690ab7f95",
-    "documentationRegistryHash": "2bca31729c9c580125bd25764291699b63532afaa67d9380c72d1dda637944b7",
+    "documentationContentHash": "cb130209bc40f5bdb9fccbd55ad07b6ec1fefbc95ab0d11fe6d50ef8eb6fa566",
+    "documentationRegistryHash": "eebe2a201c559e44b45d1a780713f6b302f56726a03a4a57538fcf6762530826",
     "generatedArtifactHashes": {
-      "generatedCommandDescriptors": "5f415b7528d7e5b6086a96032d4d29d58e90ca082704f6bb4b25afd8f89c3fae",
-      "generatedContractRegistry": "db1a9655e99a92ca81b3bfc934b8658ef42584c312c5488f2c699cce080b864c",
-      "generatedManifest": "b4ae9d0b063ba2a04e3ea41a8330fbe7dc095f4180e616bc034e4901bde9ffe1",
-      "generatedMcpToolDefinitions": "b37ce9423e4672326a42038dd2a99d04e9e5c9077d7613b9b516b4655cd1f16c",
-      "pyCommandDescriptors": "5f415b7528d7e5b6086a96032d4d29d58e90ca082704f6bb4b25afd8f89c3fae",
-      "pyContractRegistry": "db1a9655e99a92ca81b3bfc934b8658ef42584c312c5488f2c699cce080b864c",
-      "pyManifest": "bc70ded5deabf23bd688aef4fb35e6f78590f7a883861d3eae75ab5a5fe7150f",
-      "pyMcpToolDefinitions": "b37ce9423e4672326a42038dd2a99d04e9e5c9077d7613b9b516b4655cd1f16c",
-      "tsCommandDescriptors": "5f415b7528d7e5b6086a96032d4d29d58e90ca082704f6bb4b25afd8f89c3fae",
-      "tsContractRegistry": "db1a9655e99a92ca81b3bfc934b8658ef42584c312c5488f2c699cce080b864c",
-      "tsManifest": "cda400d5fbd005646128c7b1a0cdd324a95328c63a1630872b5303b7dfb3adf4",
-      "tsMcpToolDefinitions": "b37ce9423e4672326a42038dd2a99d04e9e5c9077d7613b9b516b4655cd1f16c"
+      "generatedCommandDescriptors": "60ab2ae91d950b5639093413fb1806d979f024203ffad0b686705a94d5b06e07",
+      "generatedContractRegistry": "fe8b9a3b82f1490b37448a109c4f3f0ff4fbf4ee7c90902d7e79edf60612498b",
+      "generatedManifest": "bbd5d4175d871062c4c148f912baa6523dce57208dd25db98daabb434aace14f",
+      "generatedMcpToolDefinitions": "6dc62098f1c71b3816d75115ab5e31734484d9bc19ecff0bce32e7ab50fc00d6",
+      "pyCommandDescriptors": "60ab2ae91d950b5639093413fb1806d979f024203ffad0b686705a94d5b06e07",
+      "pyContractRegistry": "fe8b9a3b82f1490b37448a109c4f3f0ff4fbf4ee7c90902d7e79edf60612498b",
+      "pyManifest": "ad8226fc146d310e85223d86640d7dda04918f0f6b24050084202cab51c56661",
+      "pyMcpToolDefinitions": "6dc62098f1c71b3816d75115ab5e31734484d9bc19ecff0bce32e7ab50fc00d6",
+      "tsCommandDescriptors": "60ab2ae91d950b5639093413fb1806d979f024203ffad0b686705a94d5b06e07",
+      "tsContractRegistry": "fe8b9a3b82f1490b37448a109c4f3f0ff4fbf4ee7c90902d7e79edf60612498b",
+      "tsManifest": "e75660c84753fc91de7b54c5f9adcb35df9a4535966bea3e5d7545e009229e99",
+      "tsMcpToolDefinitions": "6dc62098f1c71b3816d75115ab5e31734484d9bc19ecff0bce32e7ab50fc00d6"
     },
     "generatedManifestCommandDescriptorVersion": "1.4.3",
     "generatedManifestPackageVersion": "0.1.0-alpha.21",
     "generatedManifestRegistryDigest": {
       "canonicalHash": "cce2ede8f658d43e0807f7f194e28fc356085e00fc70d99d27ecbd674be14a9f",
-      "commandDigestHash": "ff5ffd264b768cb059973405a2bbac264e790e8c583ce066668263259cf9d565",
-      "descriptorHash": "0ce356cf2e77ac1228df9de4a89d5b4bcba73fb5b43a83cf59d34b92bc561d46",
-      "documentationHash": "2bca31729c9c580125bd25764291699b63532afaa67d9380c72d1dda637944b7",
-      "fullDescriptorHash": "a90cc06c3d9ab9068f87e2b1005847e685b7f86952cba5b2af9d2e38b8f963bb",
+      "commandDigestHash": "85f685455fdf85b757674a3086eb03354a628f22ada1a25afee0fd86b14b92c7",
+      "descriptorHash": "664970d781e477a11a683bc265cbd7fc8b0cf9576b50da49ab301b773e38b47d",
+      "documentationHash": "eebe2a201c559e44b45d1a780713f6b302f56726a03a4a57538fcf6762530826",
+      "fullDescriptorHash": "422f7c73ce499d926c92ea792b0c590c41c916dac377cf6790c5465d1eb5f384",
       "namespaceHash": "cd39afc4f4e8b76473a4768c07d979c44e0421973786c54e12bb6d7888f5952a",
       "policyProfilesHash": "9fb054a4f29be73c2ebf33f643bc17d904b2872dd8e7d564a690db828071a7ce",
       "principalTemplatesHash": "525835bb3c4710fa326e662e8a961e74de1798f4fb1bccb2a00be557ed037740",
       "routedTopLevelHash": "02e98ac94f1eadbeded065bef652f8a917f108a8a08726ad7163503cc1b3384d",
       "topLevelHash": "04e58344eaec2c14dfa336b13eff952a584c7c5355d90775c3bc8336ab0752ee",
-      "trustDistributionHash": "7d7b666b4376791a20e9851954953805368c70059921bdc9de714bcb2732f80f"
+      "trustDistributionHash": "3a926813503a3638bd98ce9689077494031ba758b0a322c4218815935d105459"
     },
     "generatedManifestVersion": "1.0.0",
     "registryDigest": {
       "canonicalHash": "cce2ede8f658d43e0807f7f194e28fc356085e00fc70d99d27ecbd674be14a9f",
-      "commandDigestHash": "ff5ffd264b768cb059973405a2bbac264e790e8c583ce066668263259cf9d565",
-      "descriptorHash": "0ce356cf2e77ac1228df9de4a89d5b4bcba73fb5b43a83cf59d34b92bc561d46",
-      "documentationHash": "2bca31729c9c580125bd25764291699b63532afaa67d9380c72d1dda637944b7",
-      "fullDescriptorHash": "a90cc06c3d9ab9068f87e2b1005847e685b7f86952cba5b2af9d2e38b8f963bb",
+      "commandDigestHash": "85f685455fdf85b757674a3086eb03354a628f22ada1a25afee0fd86b14b92c7",
+      "descriptorHash": "664970d781e477a11a683bc265cbd7fc8b0cf9576b50da49ab301b773e38b47d",
+      "documentationHash": "eebe2a201c559e44b45d1a780713f6b302f56726a03a4a57538fcf6762530826",
+      "fullDescriptorHash": "422f7c73ce499d926c92ea792b0c590c41c916dac377cf6790c5465d1eb5f384",
       "namespaceHash": "cd39afc4f4e8b76473a4768c07d979c44e0421973786c54e12bb6d7888f5952a",
       "policyProfilesHash": "9fb054a4f29be73c2ebf33f643bc17d904b2872dd8e7d564a690db828071a7ce",
       "principalTemplatesHash": "525835bb3c4710fa326e662e8a961e74de1798f4fb1bccb2a00be557ed037740",
       "routedTopLevelHash": "02e98ac94f1eadbeded065bef652f8a917f108a8a08726ad7163503cc1b3384d",
       "topLevelHash": "04e58344eaec2c14dfa336b13eff952a584c7c5355d90775c3bc8336ab0752ee",
-      "trustDistributionHash": "7d7b666b4376791a20e9851954953805368c70059921bdc9de714bcb2732f80f"
+      "trustDistributionHash": "3a926813503a3638bd98ce9689077494031ba758b0a322c4218815935d105459"
     },
-    "schemaHash": "d3b9c2aa7df64647187584fdccbb4e62b459e072537136aa4c9795ad87d98701"
+    "schemaHash": "491cbbceb1c302dd6c9fa5a60509b74c46a17d1be2eb0dbe5522cd141d4b0d18"
   },
   "publication": {
-    "contractLockHash": "a4bd815ef65a25b65b6e17a0bfb0e46989cee4398aa652a310d448c40abc47dd",
+    "contractLockHash": "561a99c5164b8dccfbe6ad83c36531462e46a0ae35b5332ad17e1f11f5b5ccae",
     "deterministic": true,
     "grade": "release-grade",
     "kind": "benchmark-contract-lock",
-    "lockDocumentHash": "9901f00baa8024a2ce7d8e40b2a22eea8e2a30e20edafc2fc3a837a0b16a7b8b",
+    "lockDocumentHash": "090c19b306a285b417d7ea26034d5b558c3af6b4b7fcf66cc7eef45f886c0ee2",
     "suiteLockPath": "benchmarks/locks/core.lock.json"
   },
   "schemaVersion": "1.0.0",

package/cli/lib/agent_contract_registry.cjs

@@ -3458,7 +3458,7 @@ const commandContracts = [
   }),
   commandContract({
     name: 'mirror.hedge',
-    summary: 'LP hedging runtime family for plan, bundle, run, start, status, and stop. This is separate from mirror sync, which continues to manage the Pandora rebalance plus Polymarket hedge legs.',
+    summary: 'Polymarket Hedge Mode for plan, bundle, run, start, status, and stop. Use this when Pandora flow should be hedged on Polymarket without running Pandora Mirroring Mode.',
     usage: 'pandora [--output table|json] mirror hedge plan|run|start|status|stop|bundle ...',
     emits: ['mirror.hedge.help'],
     dataSchema: '#/definitions/MirrorHedgePayload',
@@ -3466,7 +3466,7 @@ const commandContracts = [
   }),
   commandContract({
     name: 'mirror.hedge.plan',
-    summary: 'Build a read-only LP hedge plan from selector-first market context or persisted state.',
+    summary: 'Build a read-only Polymarket Hedge Mode plan from selector-first market context or persisted state.',
     usage:
       'pandora [--output table|json] mirror hedge plan --state-file <path>|--strategy-hash <hash>|(--pandora-market-address <address>|--market-address <address>) (--polymarket-market-id <id>|--polymarket-slug <slug>) --internal-wallets-file <path> [--min-hedge-usdc <n>] [--partial-hedge-policy partial|skip] [--sell-hedge-policy depth-checked|manual-only] [--trust-deploy] [--indexer-url <url>] [--timeout-ms <ms>] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>]',
     emits: ['mirror.hedge.plan', 'mirror.hedge.plan.help'],
@@ -3474,7 +3474,7 @@ const commandContracts = [
     mcpExposed: true,
     mcp: {
       command: ['mirror', 'hedge', 'plan'],
-      description: 'Build a read-only LP hedge plan from selector-first market context or persisted state. Separate from mirror sync, which still manages the Pandora rebalance plus Polymarket hedge legs.',
+      description: 'Build a read-only Polymarket Hedge Mode plan from selector-first market context or persisted state. Use Pandora Mirroring Mode separately through mirror sync with --no-hedge when Pandora should follow Polymarket odds.',
       inputSchema: buildInputSchema({
         flagProperties: {
           'state-file': commonFlags.stateFile,
@@ -3515,7 +3515,7 @@ const commandContracts = [
   }),
   commandContract({
     name: 'mirror.hedge.bundle',
-    summary: 'Build deterministic VPS deployment artifacts for the LP hedge daemon without submitting a live hedge transaction.',
+    summary: 'Build deterministic VPS deployment artifacts for Polymarket Hedge Mode without submitting a live hedge transaction.',
     usage:
       'pandora [--output table|json] mirror hedge bundle --state-file <path>|--strategy-hash <hash>|(--pandora-market-address <address>|--market-address <address>) (--polymarket-market-id <id>|--polymarket-slug <slug>) --internal-wallets-file <path> [--output-dir <path>|--bundle-dir <path>] [--min-hedge-usdc <n>] [--partial-hedge-policy partial|skip] [--sell-hedge-policy depth-checked|manual-only] [--trust-deploy] [--indexer-url <url>] [--timeout-ms <ms>] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>]',
     emits: ['mirror.hedge.bundle', 'mirror.hedge.bundle.help'],
@@ -3523,7 +3523,7 @@ const commandContracts = [
     mcpExposed: true,
     mcp: {
       command: ['mirror', 'hedge', 'bundle'],
-      description: 'Build deterministic VPS deployment artifacts for the packaged LP hedge daemon without submitting a live hedge transaction.',
+      description: 'Build deterministic VPS deployment artifacts for Polymarket Hedge Mode without submitting a live hedge transaction.',
       inputSchema: buildInputSchema({
         flagProperties: {
           'state-file': commonFlags.stateFile,
@@ -3564,7 +3564,7 @@ const commandContracts = [
   }),
   commandContract({
     name: 'mirror.hedge.run',
-    summary: 'Run the LP hedge loop in the foreground.',
+    summary: 'Run Polymarket Hedge Mode in the foreground.',
     usage:
       'pandora [--output table|json] mirror hedge run --state-file <path>|--strategy-hash <hash>|(--pandora-market-address <address>|--market-address <address>) (--polymarket-market-id <id>|--polymarket-slug <slug>) --internal-wallets-file <path> [--paper|--dry-run|--execute-live|--execute] [--private-key <hex>|--profile-id <id>|--profile-file <path>] [--funder <address>] [--usdc <address>] [--chain-id <id>] [--rpc-url <url>] [--polymarket-rpc-url <url>] [--trust-deploy] [--indexer-url <url>] [--timeout-ms <ms>] [--interval-ms <ms>] [--iterations <n>] [--adopt-existing-positions] [--min-hedge-usdc <n>] [--partial-hedge-policy partial|skip] [--sell-hedge-policy depth-checked|manual-only] [--depth-slippage-bps <n>] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>]',
     emits: ['mirror.hedge.run', 'mirror.hedge.help'],
@@ -3574,7 +3574,7 @@ const commandContracts = [
     mutating: true,
     mcp: {
       command: ['mirror', 'hedge', 'run'],
-      description: 'Run the LP hedge loop in the foreground. Separate from mirror sync, which still manages the Pandora rebalance plus Polymarket hedge legs.',
+      description: 'Run Polymarket Hedge Mode in the foreground. Use this when Pandora trades should hedge on Polymarket and Pandora Mirroring Mode should stay off.',
       inputSchema: buildInputSchema({
         includeIntent: true,
         flagProperties: {
@@ -3639,7 +3639,7 @@ const commandContracts = [
   }),
   commandContract({
     name: 'mirror.hedge.start',
-    summary: 'Start detached LP hedge daemon.',
+    summary: 'Start detached Polymarket Hedge Mode daemon.',
     usage:
       'pandora [--output table|json] mirror hedge start --state-file <path>|--strategy-hash <hash>|(--pandora-market-address <address>|--market-address <address>) (--polymarket-market-id <id>|--polymarket-slug <slug>) --internal-wallets-file <path> [--paper|--dry-run|--execute-live|--execute] [--private-key <hex>|--profile-id <id>|--profile-file <path>] [--funder <address>] [--usdc <address>] [--chain-id <id>] [--rpc-url <url>] [--polymarket-rpc-url <url>] [--trust-deploy] [--indexer-url <url>] [--timeout-ms <ms>] [--interval-ms <ms>] [--iterations <n>] [--adopt-existing-positions] [--min-hedge-usdc <n>] [--partial-hedge-policy partial|skip] [--sell-hedge-policy depth-checked|manual-only] [--depth-slippage-bps <n>] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>]',
     emits: ['mirror.hedge.start', 'mirror.hedge.help'],
@@ -3649,7 +3649,7 @@ const commandContracts = [
     mutating: true,
     mcp: {
       command: ['mirror', 'hedge', 'start'],
-      description: 'Start detached LP hedge daemon. Separate from mirror sync, which still manages the Pandora rebalance plus Polymarket hedge legs.',
+      description: 'Start detached Polymarket Hedge Mode daemon. Use Pandora Mirroring Mode separately through mirror sync with --no-hedge when you only want Pandora repricing.',
       inputSchema: buildInputSchema({
         includeIntent: true,
         flagProperties: {
@@ -3917,14 +3917,14 @@ const commandContracts = [
   }),
   commandContract({
     name: 'mirror.sync',
-    summary: 'Mirror sync runtime command family for separate Pandora rebalance and Polymarket hedge legs. Rebalance-route flags affect only the Ethereum Pandora leg; cross-venue settlement is not atomic.',
+    summary: 'Mirror sync runtime family. Use `mirror sync --no-hedge` for Pandora Mirroring Mode, or plain mirror sync for the hybrid loop with separate Pandora rebalance and Polymarket hedge legs.',
     usage: 'pandora [--output table|json] mirror sync once|run|start|stop|status|unlock ...',
     emits: ['mirror.sync.help'],
     dataSchema: '#/definitions/MirrorStatusPayload',
   }),
   commandContract({
     name: 'mirror.sync.once',
-    summary: 'Execute one mirror sync tick with separate Pandora rebalance and Polymarket hedge legs. Rebalance-route flags affect only the Ethereum Pandora leg; cross-venue settlement is not atomic.',
+    summary: 'Execute one mirror sync tick. `--no-hedge` makes this Pandora Mirroring Mode; without it the loop may rebalance Pandora and hedge on Polymarket as separate Pandora rebalance and Polymarket hedge legs.',
     usage:
       'pandora [--output table|json] mirror sync once --pandora-market-address <address>|--market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--paper|--dry-run|--execute-live|--execute] [--private-key <hex>|--profile-id <id>|--profile-file <path>] [--funder <address>] [--usdc <address>] [--trust-deploy] [--manifest-file <path>] [--skip-gate] [--strict-close-time-delta] [--stream|--no-stream] [--verbose] [--interval-ms <ms>] [--drift-trigger-bps <n>] [--hedge-trigger-usdc <n>] [--hedge-ratio <n>] [--hedge-scope pool|total] [--skip-initial-hedge] [--adopt-existing-positions] [--no-hedge] [--rebalance-mode atomic|incremental] [--price-source on-chain|indexer] [--rebalance-route public|auto|flashbots-private|flashbots-bundle] [--rebalance-route-fallback fail|public] [--flashbots-relay-url <url>] [--flashbots-auth-key <key>] [--flashbots-target-block-offset <n>] [--max-rebalance-usdc <n>] [--max-hedge-usdc <n>] [--max-open-exposure-usdc <amount>] [--max-trades-per-day <n>] [--cooldown-ms <ms>] [--depth-slippage-bps <n>] [--min-time-to-close-sec <n>] [--iterations <n>] [--state-file <path>] [--kill-switch-file <path>] [--chain-id <id>] [--rpc-url <url>] [--polymarket-rpc-url <url>] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>] [--webhook-url <url>] [--telegram-bot-token <token>] [--telegram-chat-id <id>] [--discord-webhook-url <url>]',
     emits: ['mirror.sync.once', 'mirror.sync.help'],
@@ -3937,11 +3937,12 @@ const commandContracts = [
       notes: [
         'The default mirror stop file is ~/.pandora/mirror/STOP. Its presence intentionally blocks local mirror sync starts and ticks until cleared.',
         'Use mirror.panic clear mode after incident review, or remove the stop file manually only if you know the emergency lock is stale.',
+        'Pandora Mirroring Mode means mirror sync with --no-hedge. For hedge-only operation on Polymarket, use mirror hedge.',
       ],
     },
     mcp: {
       command: ['mirror', 'sync', 'once'],
-      description: 'Execute one mirror sync tick. Rebalance-route flags affect only the Ethereum Pandora leg. Snapshot/action payloads expose reserveSource and rebalance sizing provenance.',
+      description: 'Execute one mirror sync tick. Use --no-hedge for Pandora Mirroring Mode, where Pandora follows Polymarket odds without placing a Polymarket hedge. Without --no-hedge, sync is the hybrid loop.',
       inputSchema: buildInputSchema({
         includeIntent: true,
         flagProperties: {