@randomplay/data 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fairy contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,26 @@
+# @randomplay/data
+
+Source ingestion and cleaned data package for Fairy.
+
+Current state:
+
+- source descriptors and metadata helpers are implemented;
+- raw source archives are retained under the repo-level `data/source/`;
+- buhflipexplode and Mihoyo Deadly Assault source snapshots have offline
+  verification scripts;
+- V1 golden source candidates, manual acceptance records, and the replay report
+  are generated under repo-level `data/cleaned/`;
+- `pnpm --filter @randomplay/data sync-cleaned` mirrors repo-level cleaned JSON into
+  package-local `packages/data/cleaned/` for npm packaging;
+- package exports include TypeScript source/types plus package-local cleaned
+  JSON, and exclude raw source archives.
+
+Do not add hand-written formal game data to this package. Formal rows must be
+derived from source documents and preserve source metadata.
+
+Useful source checks:
+
+- `pnpm --filter @randomplay/data verify:buhflipexplode-da`
+- `pnpm --filter @randomplay/data verify:excel`
+- `pnpm --filter @randomplay/data verify:golden-v1`
+- `pnpm --filter @randomplay/data verify:mihoyo-da`

package/cleaned/audit/mihoyo-buhflipexplode.source-conflicts.json

@@ -0,0 +1,282 @@
+{
+  "schemaVersion": "fairy-da-source-conflict-audit-v1",
+  "parserVersion": "manual-da-source-conflict-audit-v0.1.0",
+  "generatedAt": "2026-05-08T15:55:00+08:00",
+  "policy": {
+    "scope": "Manual audit resolution for the three historical non-blocking Mihoyo/buhflipexplode Deadly Assault buff sourceConflict records from the 2026-05-05 Mihoyo alignment snapshot.",
+    "cleanedDataEffect": "These records resolve release evidence for the source conflicts only. They do not publish formal typed modifiers or overwrite retained raw source snapshots.",
+    "selectedSource": "buhflipexplode-zzz-da",
+    "resolutionStatus": "resolved",
+    "rawSnapshotPolicy": "Retained raw Mihoyo alignment still records the original sourceConflict issues for audit trace. Cleaned release evidence uses this manual audit artifact as the resolution layer.",
+    "thirdPartyLookupPolicy": "nanoka is used as manual tie-breaker evidence only. It is not a crawler source, not part of the cleaned-data pipeline, and not redistributed as source data.",
+    "starterScenarioImpact": {
+      "checkedPath": "docs/ux/starter-scenarios.md",
+      "checkedPattern": "澄意|灼冽|破招|Clarity|Blazing Chill|Interrupt",
+      "matches": 0,
+      "action": "No UX starter-scenario update required."
+    }
+  },
+  "decision": {
+    "selectedBy": "@lo-user",
+    "selectedAt": "2026-05-08T10:54:29+08:00",
+    "decisionRef": {
+      "target": "#fairy",
+      "messageId": "0a08cfb6"
+    },
+    "decisionText": "Q1，按 buhflipexplode",
+    "rationale": "nanoka manual lookup matched buhflipexplode for all three conflicts, giving a 2:1 evidence split against the retained Mihoyo text."
+  },
+  "manualLookupSource": {
+    "sourceId": "nanoka-zzz-boss-manual-2026-05-07",
+    "url": "https://zzz.nanoka.cc/boss/",
+    "role": "manual-tie-breaker-only",
+    "observedDataVersion": "3.0.1+15390262",
+    "checkedBy": "@TechLead",
+    "checkedAt": "2026-05-07T19:49:33+08:00"
+  },
+  "summary": {
+    "totalRecords": 3,
+    "resolvedPreferBuhflipexplode": 3,
+    "remainingBlockingConflicts": 0,
+    "remainingNonBlockingReleaseConflicts": 0
+  },
+  "records": [
+    {
+      "auditId": "da-buff-69000030-period-21-clarity",
+      "status": "resolved-prefer-buhflipexplode",
+      "period": {
+        "periodNumber": 21,
+        "title": "危局强袭战（第21期）",
+        "mihoyoContentId": 1605,
+        "buhflipexplodeVersionKey": "2.2.3"
+      },
+      "buff": {
+        "slotIndex": 2,
+        "mihoyoName": "澄意",
+        "buhflipexplodeName": "Clarity",
+        "buhflipexplodeBuffId": "69000030"
+      },
+      "sourceRefs": {
+        "mihoyo": {
+          "sourceId": "mihoyo-zzz-critical-assault",
+          "sourceVersion": "sha256:see-fetch-manifest",
+          "sourceAnchor": "details/1605.entry_page.json#data.page.modules[0].components[0].data.tables[0].row[2]",
+          "sourceTextHash": "3c8f8638445db50ac70bc75f651f77dd546155ffcfb7c2fcdbd58dfe73ada742"
+        },
+        "buhflipexplode": {
+          "sourceId": "buhflipexplode-zzz-da",
+          "sourceVersion": "sha256:see-fetch-manifest",
+          "sourceAnchor": "assets/zzz/buffs.live.json#69000030",
+          "sourceTextHash": "68b6720414f4edd87e27f1ef9481eda84e213d98910c19e4dad4350352cb13d1"
+        },
+        "nanoka": {
+          "sourceId": "nanoka-zzz-boss-manual-2026-05-07",
+          "sourceVersion": "3.0.1+15390262",
+          "sourceAnchor": "https://zzz.nanoka.cc/boss/ manual lookup: period 21 / Clarity"
+        }
+      },
+      "sourceText": {
+        "mihoyo": [
+          "代理人的暴击伤害提升30%，贯穿伤害提升15%。",
+          "[命破]特性的代理人造成的伤害提升15%，终结技造成的伤害额外提升15%。"
+        ],
+        "buhflipexplode": "Agent HP increases by 25%, and their Sheer DMG increases by 15%.\nAgents with Rupture specialty deal 15% more DMG, and their Ultimate DMG is additionally increased by 15%.",
+        "nanoka": "Matches buhflipexplode: HP +25%, Sheer DMG +15%, Rupture DMG +15%, Ultimate DMG +15%."
+      },
+      "normalizedComparison": {
+        "mihoyo": {
+          "critDamage": 0.3,
+          "sheerDamage": 0.15,
+          "ruptureDamage": 0.15,
+          "ultimateDamage": 0.15
+        },
+        "buhflipexplode": {
+          "maxHp": 0.25,
+          "sheerDamage": 0.15,
+          "ruptureDamage": 0.15,
+          "ultimateDamage": 0.15
+        },
+        "nanoka": {
+          "maxHp": 0.25,
+          "sheerDamage": 0.15,
+          "ruptureDamage": 0.15,
+          "ultimateDamage": 0.15
+        }
+      },
+      "originalIssue": {
+        "severity": "nonBlocking",
+        "reason": "sourceConflict",
+        "message": "Mihoyo/buhflipexplode buff numeric text differs for \"澄意\" in 危局强袭战（第21期）; mapped to 69000030 with score 0.75",
+        "mihoyoNumericSignature": "15|15|15|30",
+        "buhflipexplodeNumericSignature": "15|15|15|25"
+      },
+      "releaseDecision": {
+        "sourceForCleanedResolution": "buhflipexplode-zzz-da",
+        "mihoyoHandling": "retained-as-conflicting-source-trace",
+        "nanokaSupport": "supports-buhflipexplode"
+      }
+    },
+    {
+      "auditId": "da-buff-69000015-period-8-blazing-chill",
+      "status": "resolved-prefer-buhflipexplode",
+      "period": {
+        "periodNumber": 8,
+        "title": "危局强袭战（第8期）",
+        "mihoyoContentId": 1260,
+        "buhflipexplodeVersionKey": "1.6.2"
+      },
+      "buff": {
+        "slotIndex": 2,
+        "mihoyoName": "灼冽",
+        "buhflipexplodeName": "Blazing Chill",
+        "buhflipexplodeBuffId": "69000015"
+      },
+      "sourceRefs": {
+        "mihoyo": {
+          "sourceId": "mihoyo-zzz-critical-assault",
+          "sourceVersion": "sha256:see-fetch-manifest",
+          "sourceAnchor": "details/1260.entry_page.json#data.page.modules[0].components[0].data.tables[0].row[2]",
+          "sourceTextHash": "ae3281d78854c0cfcd4f9f1cdbf536bf7fb1f330713559dfaff577e837416fa0"
+        },
+        "buhflipexplode": {
+          "sourceId": "buhflipexplode-zzz-da",
+          "sourceVersion": "sha256:see-fetch-manifest",
+          "sourceAnchor": "assets/zzz/buffs.live.json#69000015",
+          "sourceTextHash": "8fdbd740ba8a8293aa76b75b610a995ad8500633948ad32c88d095c1504d0968"
+        },
+        "nanoka": {
+          "sourceId": "nanoka-zzz-boss-manual-2026-05-07",
+          "sourceVersion": "3.0.1+15390262",
+          "sourceAnchor": "https://zzz.nanoka.cc/boss/ manual lookup: period 8 / Blazing Chill"
+        }
+      },
+      "sourceText": {
+        "mihoyo": [
+          "代理人的火属性异常积蓄效率和冰属性异常积蓄效率将提升20%，攻击力提升25%。",
+          "对敌人施加属性异常效果时，代理人回复300点喧响值，提升80点异常精通，持续15秒。"
+        ],
+        "buhflipexplode": "Agent Fire Anomaly Buildup Rate and Ice Anomaly Buildup Rate increase by 20%, and ATK increases by 25%.\nWhen inflicting an Attribute Anomaly on enemies, the Agent restores 400 Decibels and Anomaly Proficiency is increased by 80, lasting 15s. Decibels recovery can be triggered once every 15s.",
+        "nanoka": "Matches buhflipexplode: Fire/Ice Anomaly Buildup Rate +20%, ATK +25%, restores 400 Decibels, Anomaly Proficiency +80 for 15s, Decibels recovery trigger interval 15s."
+      },
+      "normalizedComparison": {
+        "mihoyo": {
+          "fireAnomalyBuildupRate": 0.2,
+          "iceAnomalyBuildupRate": 0.2,
+          "attack": 0.25,
+          "decibelsRestored": 300,
+          "anomalyProficiency": 80,
+          "durationSeconds": 15,
+          "decibelsRecoveryCooldownSeconds": null
+        },
+        "buhflipexplode": {
+          "fireAnomalyBuildupRate": 0.2,
+          "iceAnomalyBuildupRate": 0.2,
+          "attack": 0.25,
+          "decibelsRestored": 400,
+          "anomalyProficiency": 80,
+          "durationSeconds": 15,
+          "decibelsRecoveryCooldownSeconds": 15
+        },
+        "nanoka": {
+          "fireAnomalyBuildupRate": 0.2,
+          "iceAnomalyBuildupRate": 0.2,
+          "attack": 0.25,
+          "decibelsRestored": 400,
+          "anomalyProficiency": 80,
+          "durationSeconds": 15,
+          "decibelsRecoveryCooldownSeconds": 15
+        }
+      },
+      "originalIssue": {
+        "severity": "nonBlocking",
+        "reason": "sourceConflict",
+        "message": "Mihoyo/buhflipexplode buff numeric text differs for \"灼冽\" in 危局强袭战（第8期）; mapped to 69000015 with score 0.67",
+        "mihoyoNumericSignature": "15|20|25|80|300",
+        "buhflipexplodeNumericSignature": "15|15|20|25|80|400"
+      },
+      "releaseDecision": {
+        "sourceForCleanedResolution": "buhflipexplode-zzz-da",
+        "mihoyoHandling": "retained-as-conflicting-source-trace",
+        "nanokaSupport": "supports-buhflipexplode"
+      }
+    },
+    {
+      "auditId": "da-buff-69000002-period-1-interrupt",
+      "status": "resolved-prefer-buhflipexplode",
+      "period": {
+        "periodNumber": 1,
+        "title": "危局强袭战（第1期）",
+        "mihoyoContentId": 1035,
+        "buhflipexplodeVersionKey": "1.4.1"
+      },
+      "buff": {
+        "slotIndex": 2,
+        "mihoyoName": "破招",
+        "buhflipexplodeName": "Interrupt",
+        "buhflipexplodeBuffId": "69000002"
+      },
+      "sourceRefs": {
+        "mihoyo": {
+          "sourceId": "mihoyo-zzz-critical-assault",
+          "sourceVersion": "sha256:see-fetch-manifest",
+          "sourceAnchor": "details/1035.entry_page.json#data.page.modules[0].components[0].data.tables[0].row[2]",
+          "sourceTextHash": "fd421cd01efbc75658d56b349487f4e5250a80051d9aaed7ab3c5d6b17a3c848"
+        },
+        "buhflipexplode": {
+          "sourceId": "buhflipexplode-zzz-da",
+          "sourceVersion": "sha256:see-fetch-manifest",
+          "sourceAnchor": "assets/zzz/buffs.live.json#69000002",
+          "sourceTextHash": "97ad93b2094505dd03cce313ae3e469bbc36666a2f9db36e102f1a9575a1cc44"
+        },
+        "nanoka": {
+          "sourceId": "nanoka-zzz-boss-manual-2026-05-07",
+          "sourceVersion": "3.0.1+15390262",
+          "sourceAnchor": "https://zzz.nanoka.cc/boss/ manual lookup: period 1 / Interrupt"
+        }
+      },
+      "sourceText": {
+        "mihoyo": [
+          "[普通攻击]、[闪避反击]、[强化特殊技]、[冲刺攻击]造成的伤害提升30%。",
+          "触发[极限闪避]或[极限支援]后，全队攻击力提升10%，暴击伤害提升20%，持续15秒，最多叠加3层，每层效果单独结算持续时间。"
+        ],
+        "buhflipexplode": "Basic Attack, Dodge Counter, EX Special Attack, and Dash Attack DMG increases by 30%.\nAfter triggering a Perfect Dodge or Perfect Assist, increases all squad members' ATK by 10% and CRIT DMG by 10% for 15s. Stacks up to 3 times. The duration of each stack is calculated separately.",
+        "nanoka": "Matches buhflipexplode: listed attack DMG +30%; after Perfect Dodge/Assist, squad ATK +10% and CRIT DMG +10% for 15s, up to 3 stacks."
+      },
+      "normalizedComparison": {
+        "mihoyo": {
+          "listedAttackDamage": 0.3,
+          "attack": 0.1,
+          "critDamage": 0.2,
+          "durationSeconds": 15,
+          "maxStacks": 3
+        },
+        "buhflipexplode": {
+          "listedAttackDamage": 0.3,
+          "attack": 0.1,
+          "critDamage": 0.1,
+          "durationSeconds": 15,
+          "maxStacks": 3
+        },
+        "nanoka": {
+          "listedAttackDamage": 0.3,
+          "attack": 0.1,
+          "critDamage": 0.1,
+          "durationSeconds": 15,
+          "maxStacks": 3
+        }
+      },
+      "originalIssue": {
+        "severity": "nonBlocking",
+        "reason": "sourceConflict",
+        "message": "Mihoyo/buhflipexplode buff numeric text differs for \"破招\" in 危局强袭战（第1期）; mapped to 69000002 with score 0.80",
+        "mihoyoNumericSignature": "3|10|15|20|30",
+        "buhflipexplodeNumericSignature": "3|10|10|15|30"
+      },
+      "releaseDecision": {
+        "sourceForCleanedResolution": "buhflipexplode-zzz-da",
+        "mihoyoHandling": "retained-as-conflicting-source-trace",
+        "nanokaSupport": "supports-buhflipexplode"
+      }
+    }
+  ]
+}

package/cleaned/audit/nicole.acceptance.json

@@ -0,0 +1,45 @@
+{
+  "schemaVersion": "fairy-manual-acceptance-v1",
+  "parserVersion": "golden-v1-replay-v0.1.0",
+  "generatedAt": "2026-05-05T18:20:00+08:00",
+  "agentId": "nicole",
+  "records": [
+    {
+      "agentId": "nicole",
+      "effectId": "nicole-defense-reduction",
+      "sourceId": "lo-user-excel",
+      "sourceRefs": [
+        {
+          "sourceId": "lo-user-excel",
+          "sourceVersion": "2.6.0_R14028417",
+          "sourceAnchor": "代理人核心技描述!D4:J4"
+        }
+      ],
+      "sourceTextHash": "07f9d239f43d3deafd4a001cdae349a6f10325cb3bbae090181a00f48e293549",
+      "parserVersion": "golden-v1-replay-v0.1.0",
+      "acceptedBy": "@lo-user",
+      "acceptedAt": "2026-05-05T18:45:21+08:00",
+      "decisionRef": {
+        "target": "#fairy:e2e57d52",
+        "messageId": "6af6f017"
+      },
+      "reason": "lo-user confirmed A/B as explicit active/inactive states and C as a skill-level-parameterized formula based on source formula, guide, and context.",
+      "acceptedMapping": {
+        "effectTemplateId": "excel-core-passive-defense-reduction-v1",
+        "handlerId": "defense-reduction",
+        "bucket": "defenseZone",
+        "appliesTo": {
+          "kind": "enemy"
+        },
+        "params": {
+          "value": 0.4,
+          "corePassiveLevel": 7,
+          "durationSeconds": 3.5
+        },
+        "requiresActivation": true,
+        "activationModel": "snapshotActiveFlag",
+        "inactiveStateMustHaveNoEffect": true
+      }
+    }
+  ]
+}