publish-specimen

Publish a Specimen to the Collection

Embody dev only (no shipped template counterpart). /specimen-authoring gets a network to the bar; this skill takes an approved one live on https://embody.tools/collection with nothing done by hand on a laptop against production. Every step below has been run end to end (tile-zoom-type, 2026-10-17); do them in order and do not skip the gates.

The pipeline in one screen

/specimen_lab/<name>  --export-->  specimens/<category>/<slug>.tdxn (+ .prompt.md, .jpg)
                                   specimens/manifest.json  (curation source of truth)
          build-specimen-data.py -> seed.sql, first-party-sync.sql, first-party-plan.sql,
                                   fixtures/specimens.json, fixtures/specimen-graphs.ts,
                                   scripts/.seed-blobs.manifest.json  (all GENERATED)
commit on dev -> PR -> merge to main -> Platform CI:
   build-and-test (astro check, build, scanner tests) -> e2e (local D1/R2 seeded from specimens/)
   -> deploy (D1 migrations, wrangler deploy = Worker with the bundled fixtures)
   -> sync-specimens (R2 blobs by sha256, first-party-sync.sql into production D1,
                      live verification of /api/specimens/<slug>/tdn and /thumbnail)

The Worker carries the cards; D1 holds the rows; R2 holds the .tdxn and the cover under their sha256. All three must land, and only sync-specimens lands the last two. Blobs are content-addressed, the sync is gated on a difference, so every stage is idempotent: re-running never harms production.

0. Gates before anything is exported

• The COMP lives at /specimen_lab/<name> with name == slug.replace('-', '_') (the save-time publisher dev/specimen_publish.py resolves it that way) and terminates in an Out TOP named out1.
• It clears the /specimen-authoring bar and the user has looked at it and said it is good. Publishing is the user's call, every time.
• get_op_errors(recurse=True) is clean; get_op_performance is acceptable.
• Every expression is a pure value expression. The community-paste sandbox (Collection/safe_import.py) neutralizes anything else to a constant, and a first-party Specimen is pasted through that same path by anyone who clicks "embody it". Allowed: parameter reads, absTime, math.*, Par.eval(), arithmetic, comparisons, ternaries, min/max/int/len/.... Not allowed: lambdas, comprehensions, op() chains with method calls, f-strings. Check before exporting:

  sc = op.Embody.op('Collection/scanner').module
  bad = [(o.name, p.name) for o in [comp] + comp.findChildren()
         for p in o.pars() if p.mode == ParMode.EXPRESSION and p.expr
         and not sc.is_pure_value_expression(p.expr)]
  

  Rewrite with helper read-only parameters until bad is empty.