# Contributor handoff — moment/luxon

> Canonical page: https://codevetter.com/unpack/luxon/agent-handoff

# Contributor handoff — moment/luxon

Scanned commit f427515a38f6a671f8de663e6bcc040ed81f114e (2026-08-09). Generated by codevetter codevetter 1.15.0 on 2026-10-02.

Source inspection; upstream code and tests were not executed.

Begin with the public exports and actual package/test/build configuration, then follow the relevant factory through implementation helpers and its matching tests. Preserve explicit parsing, immutable transformations, half-open interval semantics, and calendar-versus-elapsed arithmetic. Tests and CI were inspected, not executed; this bounded brief supplies no passing status or exhaustive coverage guarantee. Under this task's authority, continue read-only investigation and reserve implementation or execution for a separately authorized task.
- Read src/luxon.js and package.json first to distinguish source APIs from distributed entrypoints; src/package.json and tasks/build.js explain source-module and generated-bundle boundaries. — [src/luxon.js#L1-L26](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/src/luxon.js#L1-L26) [package.json#L11-L21](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/package.json#L11-L21) [src/package.json#L1-L4](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/src/package.json#L1-L4) [tasks/build.js#L125-L174](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/tasks/build.js#L125-L174)
- Preserve the documented scope: use host-native internationalization, keep APIs explicit, avoid convenience bloat, and address module-loader compatibility in build tooling rather than runtime source. — [CONTRIBUTING.md#L7-L13](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/CONTRIBUTING.md#L7-L13) [docs/why.md#L22-L31](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/docs/why.md#L22-L31)
- For parsing work, read regexParser/tokenParser together with parseDataToDateTime and fromObject; interpretation-zone, setZone, specificOffset, missing-field defaults, and representation conflicts are separate contracts. — [src/datetime.js#L192-L205](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/src/datetime.js#L192-L205) [src/datetime.js#L804-L899](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/src/datetime.js#L804-L899) [src/impl/regexParser.js#L288-L295](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/src/impl/regexParser.js#L288-L295) [src/impl/tokenParser.js#L495-L497](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/src/impl/tokenParser.js#L495-L497)
- For arithmetic work, retain higher-order calendar adjustment before elapsed-millisecond addition and protect DST gaps/overlaps; docs/math.md and dst.test.js provide the relevant semantic examples. — [src/datetime.js#L153-L187](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/src/datetime.js#L153-L187) [docs/math.md#L17-L36](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/docs/math.md#L17-L36) [docs/math.md#L59-L74](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/docs/math.md#L59-L74) [test/datetime/dst.test.js#L14-L68](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/test/datetime/dst.test.js#L14-L68)
- Restore Settings and mocked Intl APIs around tests; helpers provide try/finally patterns, and cache resets matter when testing constructor-specific overlap choices. — [test/helpers.js#L5-L42](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/test/helpers.js#L5-L42) [test/helpers.js#L65-L73](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/test/helpers.js#L65-L73) [test/datetime/dst.test.js#L40-L67](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/test/datetime/dst.test.js#L40-L67)
- If later authorized to execute checks, start with npm run jest -- --runInBand plus the relevant test file, then use npm run test for coverage and npm run format-check; this investigation inspected those scripts and CI without executing them. — [package.json#L22-L28](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/package.json#L22-L28) [jest.config.js#L1-L10](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/jest.config.js#L1-L10) [.github/workflows/test.yml#L33-L38](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/.github/workflows/test.yml#L33-L38)
- Use manifest/CI evidence to resolve setup uncertainty: historical contributor instructions mention npm commands absent from the current scripts, while the declared Node minimum and CI matrix differ from older installation text. — [CONTRIBUTING.md#L64-L82](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/CONTRIBUTING.md#L64-L82) [package.json#L18-L33](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/package.json#L18-L33) [package.json#L67-L69](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/package.json#L67-L69) [docs/install.md#L24-L39](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/docs/install.md#L24-L39) [.github/workflows/test.yml#L20-L24](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/.github/workflows/test.yml#L20-L24)
- Keep operational boundaries explicit: release invokes npm publish, tagging, and site deployment; deploy-site sources configuration and commits/pushes, while API/site generation writes generated files under build. — [scripts/release#L1-L8](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/scripts/release#L1-L8) [scripts/deploy-site#L28-L38](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/scripts/deploy-site#L28-L38) [scripts/deploy-site#L161-L167](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/scripts/deploy-site#L161-L167) [package.json#L24-L26](https://github.com/moment/luxon/blob/f427515a38f6a671f8de663e6bcc040ed81f114e/package.json#L24-L26)

Every claim links to its cited files at the pinned commit. Citations identify source evidence; they do not establish runtime correctness. Independent CodeVetter scan — not reviewed by upstream maintainers.

## Public product links

- [CodeVetter](https://codevetter.com/)
- [Download](https://codevetter.com/download)
- [Documentation](https://codevetter.com/docs/)
- [Source](https://github.com/Codevetter/codevetter)