Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Phase 02 — Clear the submission blockers (deployment + DOI)

Goal

The two external-facing submission blockers are cleared: (1) the syndb.datasets table is populated on the production cluster and serves DOI/licence/owner/canonical-name from the database, and (2) a real archival DOI for the reproducibility bundle replaces the placeholder in the back matter. After this phase the manuscript makes no claim that depends on out-of-band manifests or an unminted DOI.

Why this matters now

discussion.tex admits the syndb.datasets table is “empty cluster-wide … sourced from out-of-band manifests held in the deployment repository rather than served from the database itself”, and back_matter.tex:8 says the archival DOI “will be added before final journal submission”. Both are concrete, doable, and block submission. They are independent of all the figure/data work.

Sub-layer table

#SlugModel / EffortTouchesFile
01datasets-tableDeepSeek v4 Flash (opencode) / highcluster Postgres/ClickHouse, deployment manifests, discussion.tex (Limitations bullet)sub-01-datasets-table.md
02archival-doiDeepSeek v4 Flash (opencode) / highZenodo, back_matter.tex, article/reproducibility/ARCHIVE_MANIFEST.mddone: DOI 10.5281/zenodo.20692792 reserved and wired into both files; publication (which makes it resolvable) is tracked as MS-09 in outstanding work

These are disjoint (database deployment vs DOI minting); fan out freely.

Merge plan

  • Sub-01 removes the syndb.datasets “empty cluster-wide” bullet from discussion.tex Limitations; sub-02 edits only back_matter.tex + ARCHIVE_MANIFEST.md. The only shared file is none — but discussion.tex Limitations is also touched by Phase 05, so land sub-01’s Limitations edit and coordinate with Phase 05 (land 02 before 05 per the README serialization table).
  • Single combined commit per sub-layer; then one build gate.

Acceptance criteria (phase-level)

  • syndb.datasets returns ≥1 row per ingested dataset with non-null DOI, licence, owner, canonical_name, queried through the production API (not a manifest file).
  • The syndb.datasets-empty Limitations bullet is removed from discussion.tex.
  • back_matter.tex cites a resolvable archival DOI; article/reproducibility/ARCHIVE_MANIFEST.md references the same DOI.
  • lualatex ×2 exits 0, 0 undefined refs.

Reference

  • Gap inventory items 13 (datasets table) and 14 (archival DOI).
  • documentation/CONTRIBUTING.md §“Cluster operator notes”.
  • Memory: RoleBinding SA namespace / image-has-no-shell constraints for any cluster job.