@randomplay/data 0.0.1

package/cleaned/golden/v1-replay-report.json

@@ -0,0 +1,399 @@
+{
+  "schemaVersion": "fairy-v1-golden-replay-report-v1",
+  "parserVersion": "golden-v1-replay-v0.1.0",
+  "generatedAt": "2026-05-05T18:20:00+08:00",
+  "policy": {
+    "scope": "V1 true-data replay harness baseline after DD-002: 19 anchors in V1, G13/G18/G19/G20 deferred.",
+    "releaseGate": "releaseReady becomes true only when all V1 anchors pass executable replay and blockingDiagnostics is zero.",
+    "manualAcceptance": "G22/G23 use lo-user manual acceptance records tied to the sourceTextHash values in v1-agent-source-candidates.json; A/B effects are replayed as explicit inactive/active snapshot states, and C is skill-level parameterized."
+  },
+  "v1AnchorIds": [
+    "G01",
+    "G02",
+    "G03",
+    "G04",
+    "G05",
+    "G06",
+    "G07",
+    "G08",
+    "G09",
+    "G10",
+    "G11",
+    "G12",
+    "G14",
+    "G15",
+    "G16",
+    "G17",
+    "G21",
+    "G22",
+    "G23"
+  ],
+  "deferredAnchorIds": [
+    "G13",
+    "G18",
+    "G19",
+    "G20"
+  ],
+  "summary": {
+    "v1AnchorCount": 19,
+    "passed": 19,
+    "pendingHarness": 0,
+    "blocked": 0,
+    "deferred": 4,
+    "blockingDiagnostics": 0,
+    "releaseReady": true
+  },
+  "anchors": [
+    {
+      "id": "G01",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "buhflipexplode-zzz-da",
+          "sourceVersion": "2026-05-05T0445Z",
+          "sourceAnchor": "da/da-versions.live.json#2.7.3.versionEnemies[0]"
+        },
+        {
+          "sourceId": "buhflipexplode-zzz-da",
+          "sourceVersion": "2026-05-05T0445Z",
+          "sourceAnchor": "assets/zzz/enemies.live.json#27300"
+        }
+      ],
+      "notes": [
+        "Default boss defense multiplier replays against sourced DA slot 0 boss context."
+      ]
+    },
+    {
+      "id": "G02",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "buhflipexplode-zzz-da",
+          "sourceVersion": "2026-05-05T0445Z",
+          "sourceAnchor": "da/da-versions.live.json#2.7.3.versionEnemies[0]"
+        },
+        {
+          "sourceId": "buhflipexplode-zzz-da",
+          "sourceVersion": "2026-05-05T0445Z",
+          "sourceAnchor": "assets/zzz/enemies.live.json#27300"
+        }
+      ],
+      "notes": [
+        "Corrupted-shield state uses the core 1.8x defense multiplier with sourced boss context."
+      ]
+    },
+    {
+      "id": "G03",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "lo-user-excel",
+          "sourceVersion": "2.6.0_R14028417",
+          "sourceAnchor": "代理人属性!A37:AF37"
+        }
+      ],
+      "notes": [
+        "Crit expected value uses 1 + critRate * critDamage."
+      ]
+    },
+    {
+      "id": "G04",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "zzz-data-introduction",
+          "sourceVersion": "2026-05-05",
+          "sourceAnchor": "docs/reference/zzz-data-introduction.txt:121-123"
+        }
+      ],
+      "notes": [
+        "Executable bucket-scan replay reproduces the guide's 199.17%, 268.61%, and 161.67% penetration-vs-damage-bonus breakpoints."
+      ]
+    },
+    {
+      "id": "G05",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "buhflipexplode-zzz-da",
+          "sourceVersion": "2026-05-05T0445Z",
+          "sourceAnchor": "da/da-versions.live.json#2.7.3.versionEnemies[0]"
+        },
+        {
+          "sourceId": "buhflipexplode-zzz-da",
+          "sourceVersion": "2026-05-05T0445Z",
+          "sourceAnchor": "assets/zzz/enemies.live.json#27300"
+        }
+      ],
+      "notes": [
+        "Sheer damage skips defense while regular damage sees corrupted-shield defense."
+      ]
+    },
+    {
+      "id": "G06",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "buhflipexplode-zzz-da",
+          "sourceVersion": "2026-05-05T0445Z",
+          "sourceAnchor": "da/da-versions.live.json#2.7.3.versionEnemies[0]"
+        },
+        {
+          "sourceId": "buhflipexplode-zzz-da",
+          "sourceVersion": "2026-05-05T0445Z",
+          "sourceAnchor": "assets/zzz/enemies.live.json#27300"
+        }
+      ],
+      "notes": [
+        "Sheer vs default boss ratio replays with the same sourced boss context."
+      ]
+    },
+    {
+      "id": "G07",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "lo-user-excel",
+          "sourceVersion": "2.6.0_R14028417",
+          "sourceAnchor": "代理人属性!A37:AF37"
+        }
+      ],
+      "notes": [
+        "Two fractional segments ceil before summing."
+      ]
+    },
+    {
+      "id": "G08",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "lo-user-excel",
+          "sourceVersion": "2.6.0_R14028417",
+          "sourceAnchor": "代理人属性!A37:AF37"
+        }
+      ],
+      "notes": [
+        "Anomaly Mastery floors before buildup."
+      ]
+    },
+    {
+      "id": "G09",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "buhflipexplode-zzz-da",
+          "sourceVersion": "2026-05-05T0445Z",
+          "sourceAnchor": "da/da-versions.live.json#2.7.3.versionEnemies[0]"
+        },
+        {
+          "sourceId": "buhflipexplode-zzz-da",
+          "sourceVersion": "2026-05-05T0445Z",
+          "sourceAnchor": "assets/zzz/enemies.live.json#27300"
+        }
+      ],
+      "notes": [
+        "buhflipexplode DA baseDaze/versionDazeMult feeds enemy.dazeCap; replay asserts daze ratio display floors the percentage value."
+      ]
+    },
+    {
+      "id": "G10",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "lo-user-excel",
+          "sourceVersion": "2.6.0_R14028417",
+          "sourceAnchor": "代理人属性!A37:AF37"
+        }
+      ],
+      "notes": [
+        "Frost maps to Ice and Auric Ink maps to Ether for both resistanceZone and anomaly-buildup-resistance."
+      ]
+    },
+    {
+      "id": "G11",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "lo-user-excel",
+          "sourceVersion": "2.6.0_R14028417",
+          "sourceAnchor": "代理人属性!A37:AF37"
+        }
+      ],
+      "notes": [
+        "Frost/Auric use Ice/Ether damage-bonus panel fields."
+      ]
+    },
+    {
+      "id": "G12",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "buhflipexplode-zzz-da",
+          "sourceVersion": "2026-05-05T0445Z",
+          "sourceAnchor": "da/da-versions.live.json#2.7.3.versionEnemies[0]"
+        },
+        {
+          "sourceId": "buhflipexplode-zzz-da",
+          "sourceVersion": "2026-05-05T0445Z",
+          "sourceAnchor": "assets/zzz/enemies.live.json#27300"
+        }
+      ],
+      "notes": [
+        "Boss trigger-count threshold and physical 1.2x multiplier replay from core constants."
+      ]
+    },
+    {
+      "id": "G14",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "lo-user-excel",
+          "sourceVersion": "2.6.0_R14028417",
+          "sourceAnchor": "代理人属性!A37:AF37"
+        },
+        {
+          "sourceId": "lo-user-excel",
+          "sourceVersion": "2.6.0_R14028417",
+          "sourceAnchor": "代理人属性!A4:AF4"
+        }
+      ],
+      "notes": [
+        "Virtual contribution rows include Bangboo exclusion and overflow handling."
+      ]
+    },
+    {
+      "id": "G15",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "lo-user-excel",
+          "sourceVersion": "2.6.0_R14028417",
+          "sourceAnchor": "代理人属性!A37:AF37"
+        }
+      ],
+      "notes": [
+        "All seven disorder formula paths replay, including polarity disorder."
+      ]
+    },
+    {
+      "id": "G16",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "lo-user-excel",
+          "sourceVersion": "2.6.0_R14028417",
+          "sourceAnchor": "代理人属性!A37:AF37"
+        }
+      ],
+      "notes": [
+        "Disorder daze-level zone uses formula actor level 60."
+      ]
+    },
+    {
+      "id": "G17",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "buhflipexplode-zzz-da",
+          "sourceVersion": "2026-05-05T0445Z",
+          "sourceAnchor": "da/da-versions.live.json#2.7.3.versionEnemies[0]"
+        },
+        {
+          "sourceId": "buhflipexplode-zzz-da",
+          "sourceVersion": "2026-05-05T0445Z",
+          "sourceAnchor": "assets/zzz/enemies.live.json#27300"
+        }
+      ],
+      "notes": [
+        "Corrupted shield cleanse uses sourced DA boss maxHp as event base."
+      ]
+    },
+    {
+      "id": "G21",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "lo-user-excel",
+          "sourceVersion": "2.6.0_R14028417",
+          "sourceAnchor": "代理人属性!A37:AF37"
+        }
+      ],
+      "notes": [
+        "One-agent Yixuan path has no teammate modifiers and keeps sheer defense skip."
+      ]
+    },
+    {
+      "id": "G22",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "lo-user-excel",
+          "sourceVersion": "2.6.0_R14028417",
+          "sourceAnchor": "代理人核心技描述!D4:J4"
+        }
+      ],
+      "notes": [
+        "Nicole defense reduction is manually accepted by lo-user and replayed as explicit inactive/active snapshot states.",
+        "Inactive keeps the default defenseZone; active applies the 40% defense reduction from core passive level 7."
+      ]
+    },
+    {
+      "id": "G23",
+      "status": "passed",
+      "sourceRefs": [
+        {
+          "sourceId": "lo-user-excel",
+          "sourceVersion": "2.6.0_R14028417",
+          "sourceAnchor": "代理人核心技描述!D4:J4"
+        },
+        {
+          "sourceId": "lo-user-excel",
+          "sourceVersion": "2.6.0_R14028417",
+          "sourceAnchor": "代理人核心技描述!D23:J23"
+        },
+        {
+          "sourceId": "lo-user-excel",
+          "sourceVersion": "2.6.0_R14028417",
+          "sourceAnchor": "代理人技能描述!C298"
+        }
+      ],
+      "notes": [
+        "Yanagi disorder boost is manually accepted by lo-user and replayed as explicit inactive/active snapshot states.",
+        "Yanagi polarity-disorder EX Special template supports skill levels 1-16; level 12 yields 96 base-damage extra from 300 anomaly proficiency.",
+        "Three-agent virtual contribution trace includes Yixuan, Nicole, and Yanagi."
+      ]
+    },
+    {
+      "id": "G13",
+      "status": "deferred",
+      "sourceRefs": [],
+      "notes": [
+        "Deferred to V1.x by @lo-user on 2026-05-05; requires data-driven anomaly-threshold rule composition."
+      ]
+    },
+    {
+      "id": "G18",
+      "status": "deferred",
+      "sourceRefs": [],
+      "notes": [
+        "Deferred to V1.x by D-13; requires non-DA enemy / part-break data expansion."
+      ]
+    },
+    {
+      "id": "G19",
+      "status": "deferred",
+      "sourceRefs": [],
+      "notes": [
+        "Deferred to V1.x by D-13; requires non-DA enemy / part-break data expansion."
+      ]
+    },
+    {
+      "id": "G20",
+      "status": "deferred",
+      "sourceRefs": [],
+      "notes": [
+        "Deferred to V1.x by D-13; requires non-DA enemy / part-break data expansion."
+      ]
+    }
+  ]
+}

package/dist/index.d.mts

@@ -0,0 +1,173 @@
+import { a as CleanedDataKind, i as CleanedDataArtifact, n as SourceManifest, o as CleanedGameDataArtifact, r as SourceManifestEntry, t as DistributionPolicy } from "./source-manifest-pBseE3aE.mjs";
+import { GameData, SourceDocument, SourceRef } from "@randomplay/core";
+
+//#region src/sources.d.ts
+type DataSourceKind = Extract<SourceDocument["kind"], "excel" | "mihoyoWiki" | "thirdPartySite">;
+type DataSourceStatus = "awaitingFile" | "discoveryOnly" | "readyForAdapter" | "requiresReview";
+interface FetchPolicy {
+  mode: "manualUpload" | "httpGet";
+  maxRequestsPerMinute: number;
+  cacheRequired: boolean;
+  conditionalRequestsPreferred: boolean;
+  requiresUserAgent: boolean;
+}
+interface SourceComplianceNote {
+  robotsTxt: "notApplicable" | "notFound" | "found" | "notChecked";
+  termsStatus: "notApplicable" | "notFound" | "found" | "requiresHumanReview";
+  redistribution: "privateUntilReviewed" | "cleanedDataOnly" | "requiresHumanReview";
+  notes: readonly string[];
+}
+interface DataSourceDescriptor {
+  id: string;
+  kind: DataSourceKind;
+  label: string;
+  url?: string;
+  fileNameHint?: string;
+  status: DataSourceStatus;
+  formalDataReady: boolean;
+  parserTargets: readonly string[];
+  sourceVersionStrategy: string;
+  discoveredAssets?: readonly string[];
+  fetchPolicy: FetchPolicy;
+  compliance: SourceComplianceNote;
+}
+declare const dataSourceDescriptors: readonly [{
+  readonly id: "lo-user-excel";
+  readonly kind: "excel";
+  readonly label: "lo-user provided ZZZ data workbook";
+  readonly fileNameHint: "data/source/excel/data.xlsx";
+  readonly status: "readyForAdapter";
+  readonly formalDataReady: false;
+  readonly parserTargets: readonly ["agent skill multipliers", "daze multipliers", "W-Engine passives", "Drive Disc set effects", "agent enhancement / potential activation fields"];
+  readonly sourceVersionStrategy: "Use the retained workbook hash plus the workbook-provided version marker from 首页!A1.";
+  readonly discoveredAssets: readonly ["data/source/excel/data.xlsx", "data/source/excel/META.md", "data/source/excel/workbook-audit.json"];
+  readonly fetchPolicy: {
+    readonly mode: "manualUpload";
+    readonly maxRequestsPerMinute: 0;
+    readonly cacheRequired: true;
+    readonly conditionalRequestsPreferred: false;
+    readonly requiresUserAgent: false;
+  };
+  readonly compliance: {
+    readonly robotsTxt: "notApplicable";
+    readonly termsStatus: "requiresHumanReview";
+    readonly redistribution: "cleanedDataOnly";
+    readonly notes: readonly ["The workbook is retained in git under data/source/excel/ as a raw/source archive.", "The workbook and derived audit artifacts must not be published in the @randomplay/data package.", "Use workbook-audit.json for sheet/column discovery; do not infer typed modifiers from text without deterministic parser support or manual acceptance."];
+  };
+}, {
+  readonly id: "mihoyo-zzz-critical-assault";
+  readonly kind: "mihoyoWiki";
+  readonly label: "Mihoyo ZZZ wiki Critical Assault map";
+  readonly url: "https://baike.mihoyo.com/zzz/wiki/channel/map/13/108";
+  readonly status: "readyForAdapter";
+  readonly formalDataReady: false;
+  readonly parserTargets: readonly ["Deadly Assault period list", "three selectable period buffs", "three boss room detail texts and challenge targets", "official Chinese labels and descriptions", "Mihoyo/buhflipexplode zh/en source-text anchors"];
+  readonly sourceVersionStrategy: "Use the retained snapshot id plus fetch-manifest hashes for the channel and entry_page API payloads.";
+  readonly discoveredAssets: readonly ["data/source/raw/mihoyo/zzz-da/2026-05-05T0850Z/channel-108/periods.json", "data/source/raw/mihoyo/zzz-da/2026-05-05T0850Z/parsed/period-details.json", "data/source/raw/mihoyo/zzz-da/2026-05-05T0850Z/alignment/mihoyo-buhflipexplode.json", "data/source/raw/mihoyo/zzz-da/2026-05-05T0850Z/fetch-manifest.json"];
+  readonly fetchPolicy: {
+    readonly mode: "httpGet";
+    readonly maxRequestsPerMinute: 12;
+    readonly cacheRequired: true;
+    readonly conditionalRequestsPreferred: true;
+    readonly requiresUserAgent: true;
+  };
+  readonly compliance: {
+    readonly robotsTxt: "notFound";
+    readonly termsStatus: "requiresHumanReview";
+    readonly redistribution: "cleanedDataOnly";
+    readonly notes: readonly ["robots.txt returned HTTP 404 on 2026-05-05.", "The target page returned HTTP 200 with cache-control max-age=300.", "The rendered Nuxt page shell does not contain detail content; use public JSON API payloads and parse embedded rich-text HTML fragments.", "entry_page requests must include x-rpc-wiki_app: zzz to avoid cross-namespace content_id collisions.", "Do not crawl authenticated or private APIs; use public wiki responses only."];
+  };
+}, {
+  readonly id: "buhflipexplode-zzz-da";
+  readonly kind: "thirdPartySite";
+  readonly label: "buhflipexplode Deadly Assault data";
+  readonly url: "https://www.buhflipexplode.org/zzz/da/";
+  readonly status: "readyForAdapter";
+  readonly formalDataReady: false;
+  readonly parserTargets: readonly ["deadly assault version entries", "enemy HP/daze/anomaly multipliers", "boss buff metadata", "Deadly Assault score / HP display algorithm evidence", "algorithm drift manifest"];
+  readonly sourceVersionStrategy: "Use the accepted raw snapshot id plus fetch-manifest and algorithm-manifest hashes.";
+  readonly discoveredAssets: readonly ["data/source/raw/buhflipexplode/2026-05-05T0445Z/da/da-versions.live.json", "data/source/raw/buhflipexplode/2026-05-05T0445Z/assets/zzz/enemies.live.json", "data/source/raw/buhflipexplode/2026-05-05T0445Z/assets/zzz/buffs.live.json", "data/source/raw/buhflipexplode/2026-05-05T0445Z/da/da.js", "data/source/raw/buhflipexplode/2026-05-05T0445Z/algorithm-manifest.json"];
+  readonly fetchPolicy: {
+    readonly mode: "httpGet";
+    readonly maxRequestsPerMinute: 12;
+    readonly cacheRequired: true;
+    readonly conditionalRequestsPreferred: true;
+    readonly requiresUserAgent: true;
+  };
+  readonly compliance: {
+    readonly robotsTxt: "notFound";
+    readonly termsStatus: "requiresHumanReview";
+    readonly redistribution: "cleanedDataOnly";
+    readonly notes: readonly ["robots.txt returned HTTP 404 on 2026-05-05.", "The site describes itself as fan-created and non-commercial.", "The about page links source code at https://github.com/spiritfxxxx/buhflipexplode-src.", "The source repository has a GPL-3.0 LICENSE for code; do not copy GPL JS into Fairy runtime packages.", "The about page says most images/data are officially sourced from in-game and public fandoms.", "D-12 locks option B: retain GPL JS for audit only; runtime implementation must remain independent MIT code.", "Retained JSON payloads are filtered to live versions only; non-live / beta / leaks config is excluded."];
+  };
+}];
+type DataSourceId = (typeof dataSourceDescriptors)[number]["id"];
+declare function getDataSourceDescriptor(id: string): DataSourceDescriptor;
+//#endregion
+//#region src/adapters.d.ts
+interface SourceFetchContext {
+  now: string;
+  cacheDir?: string;
+  userAgent?: string;
+}
+interface RawSourceFetchResult<TPayload = unknown> {
+  sourceId: string;
+  sourceVersion: string;
+  fetchedAt: string;
+  payload: TPayload;
+  url?: string;
+  fileName?: string;
+  contentType?: string;
+}
+interface ParsedSourceRecord {
+  id: string;
+  sourceAnchor?: string;
+  dataPath?: string;
+  raw: unknown;
+}
+interface ParsedSourceBatch {
+  sourceId: string;
+  sourceVersion: string;
+  formalDataReady: boolean;
+  records: readonly ParsedSourceRecord[];
+  notes: readonly string[];
+}
+interface SourceAdapter<TPayload = unknown> {
+  sourceId: string;
+  fetch(context: SourceFetchContext): Promise<RawSourceFetchResult<TPayload>>;
+  parse(raw: RawSourceFetchResult<TPayload>, context: SourceFetchContext): Promise<ParsedSourceBatch>;
+}
+declare function createDiscoveryOnlyAdapter(descriptor: DataSourceDescriptor): SourceAdapter<never>;
+//#endregion
+//#region src/ingest.d.ts
+interface CreateEmptyGameDataOptions {
+  gameVersion: string;
+  dataVersion: string;
+  sourceVersion: string;
+  generatedAt: string;
+  sources: readonly SourceDocument[];
+  schemaVersion?: string;
+}
+declare function createEmptyGameData(options: CreateEmptyGameDataOptions): GameData;
+declare function assertDiscoveryOnlyGameData(gameData: GameData): void;
+//#endregion
+//#region src/metadata.d.ts
+declare const DATA_SOURCE_SKELETON_PARSER_VERSION = "@randomplay/data-source-skeleton-v0.1.0";
+interface BuildSourceDocumentOptions {
+  sourceVersion: string;
+  parsedAt: string;
+  fetchedAt?: string;
+  parserVersion?: string;
+  gameVersion?: string;
+  fileName?: string;
+  licenseNote?: string;
+}
+interface BuildSourceRefOptions {
+  sourceVersion?: string;
+  sourceAnchor?: string;
+  dataPath?: string;
+}
+declare function buildSourceDocument(descriptor: DataSourceDescriptor, options: BuildSourceDocumentOptions): SourceDocument;
+declare function buildSourceRef(descriptor: Pick<DataSourceDescriptor, "id">, options?: BuildSourceRefOptions): SourceRef;
+//#endregion
+export { BuildSourceDocumentOptions, BuildSourceRefOptions, CleanedDataArtifact, CleanedDataKind, CleanedGameDataArtifact, CreateEmptyGameDataOptions, DATA_SOURCE_SKELETON_PARSER_VERSION, DataSourceDescriptor, DataSourceId, DataSourceKind, DataSourceStatus, DistributionPolicy, FetchPolicy, ParsedSourceBatch, ParsedSourceRecord, RawSourceFetchResult, SourceAdapter, SourceComplianceNote, SourceFetchContext, SourceManifest, SourceManifestEntry, assertDiscoveryOnlyGameData, buildSourceDocument, buildSourceRef, createDiscoveryOnlyAdapter, createEmptyGameData, dataSourceDescriptors, getDataSourceDescriptor };