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
| # | Slug | Model / Effort | Touches | File |
|---|---|---|---|---|
| 01 | datasets-table | DeepSeek v4 Flash (opencode) / high | cluster Postgres/ClickHouse, deployment manifests, discussion.tex (Limitations bullet) | sub-01-datasets-table.md |
| 02 | archival-doi | DeepSeek v4 Flash (opencode) / high | Zenodo, back_matter.tex, article/reproducibility/ARCHIVE_MANIFEST.md | done: 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 fromdiscussion.texLimitations; sub-02 edits onlyback_matter.tex+ARCHIVE_MANIFEST.md. The only shared file is none — butdiscussion.texLimitations 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.datasetsreturns ≥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 fromdiscussion.tex. -
back_matter.texcites a resolvable archival DOI;article/reproducibility/ARCHIVE_MANIFEST.mdreferences the same DOI. -
lualatex ×2exits 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.