Skip to content

docs: WHEEL_DEBUG_METADATA_{JSON,XML} overwrite behavior - #130

Merged
so5 merged 2 commits into
mainfrom
docs/hpciss-metadata-dump-overwrite
Sep 10, 2026
Merged

so5 merged 2 commits into
mainfrom
docs/hpciss-metadata-dump-overwrite

Conversation

@so5

@so5 so5 commented Sep 3, 2026

Copy link
Copy Markdown
Collaborator

Documents what happens to the WHEEL_DEBUG_METADATA_JSON / WHEEL_DEBUG_METADATA_XML
dump files when a project has more than one HPCI-SS metadata write.

Behavior (unchanged, just now written down):

  • The dump path is the fixed env-var value — no component name or sequence suffix — and is written with node:fs/promises writeFile (flag w, truncate).
  • Multiple inputFiles in one HPCI-SS / HPCISS-tar component → one dump. gatherComponentMetadata / componentMetadataToXml are called once per _hpcissHandler run; extra inputFiles only add wheel.workflow xattr targets.
  • 2+ HPCI-SS components, or one component re-run inside a loop → each run overwrites the same path; only the last survives. Each dump is a whole-project snapshot taken at that moment.

Changes:

  • documentMD/design/gfarm.md — new "上書き挙動" subsection under "デバッグ用メタデータ書き出し".
  • documentMD/design/configuration.md §4 — adds the two vars to the WHEEL_* env-var list with a pointer to gfarm.md (they were previously only documented in gfarm.md).

No code change.

🤖 Generated with Claude Code

so5 and others added 2 commits September 3, 2026 11:28
The dump path is fixed (the env-var value, no component name / suffix) and
written with node:fs/promises writeFile (flag 'w', truncate):

- multiple inputFiles in one HPCI-SS / HPCISS-tar component => a single dump
  (gatherComponentMetadata / componentMetadataToXml run once per
  _hpcissHandler call; extra inputFiles only add wheel.workflow xattr targets).
- 2+ HPCI-SS components, or one component re-run in a loop => each run
  overwrites the same path; only the last survives. Each dump is a
  whole-project snapshot.

Documented in gfarm.md's "デバッグ用メタデータ書き出し" section with a new
"上書き挙動" subsection, plus a discoverability pointer from
configuration.md section 4 (WHEEL_* env var list).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017xw6DdyQhrdTZMjYbKvFZi
@so5
so5 merged commit 61cbcf8 into main Sep 10, 2026
@so5
so5 deleted the docs/hpciss-metadata-dump-overwrite branch September 10, 2026 01:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants