Spec Studio

The stamp is written beside the page set, and a later build removes it

spec:consumers.spec-studio.sharing.stamp-written-apartExample / Scenario · storyready floor ready

Packs: pack:self-hosting-v1, pack:spec-studio-v1

Design: no design entries · no pinned declarations · no decisions

Findings: no errors, no warnings

specs/consumers/spec-studio.sharing.stamp-written-apart.sdp.md

No open questions and no blocking questions; implementation binding none, verifier binding present, and expected-outcome oracle none.

Intent
outcome
Execute the stamp step apart from the build: it touches no page, and no stamp outlives its build.
assumptions
  • The world writes a root with one Pack of two member Specs, runs the studio command, keeps the bytes of every page file, runs the stamp command, reads stamp.json and compares the page files with the kept bytes, then runs the studio command again and checks whether stamp.json exists.
Behavior

Examples

Given a page set the studio command wrote at an extraction root
When the stamp command runs with the commit {commit: "0123abc"} and the source template {source: "https://example.test/blob/0123abc/{file}#L{line}"}
Then the stamp names the corpus commit {corpusCommit: "0123abc"}
Then every page file stays byte-identical: {pagesUntouched: true}
Then a later studio run keeps the stamp: {stampSurvives: false}
Verification

Verifier bindings

  • test:protocol.studio-stamp-apart · anchored · test anchor binding present · test/studio-s4.test.ts:555

    External run evidence from test/studio-s4.test.ts

    Test anchors: test:protocol.run-absolute, test:protocol.run-external, test:protocol.run-unjoined, test:protocol.studio-graph-only, test:protocol.studio-inputs-both-given, test:protocol.studio-stamp-apart. Specs verified by those bindings: spec:consumers.spec-studio.data.inputs, spec:consumers.spec-studio.data.inputs.both-given, spec:consumers.spec-studio.data.inputs.graph-only, spec:consumers.spec-studio.runs-page, spec:consumers.spec-studio.runs-page.external-evidence, spec:consumers.spec-studio.sharing, spec:consumers.spec-studio.sharing.stamp-written-apart, spec:observation.run-evidence, spec:observation.run-evidence.absolute-path-joins, spec:observation.run-evidence.unanchored-file-unjoined.

    Run 1: external run evidence from vitest 4.1.10

    Build: CI 391 · Branch: cursor/media-plan-and-articles-09b1 · Commit: 076cd4f1f85640d8236e5cca1bffffa68ab79a33 · Start: 2026-10-31T15:32:20.471Z · Stop: 2026-10-31T15:34:02.073Z

    NameSuiteResultDuration
    recipe 45 joins normalized paths, preserves records and graph facts, and diagnoses other inputsnot recordedpassed32.43 ms
    renders external run evidence with result rows, metadata, diagnostics and conditional navigationnot recordedpassed64.35 ms
    reads repeated --runs before extraction and leaves input bytes untouchednot recordedpassed65.17 ms
    stamps apart, touches no page, refuses bad sources and removes the stamp on rebuildnot recordedpassed33.53 ms
    executes the bound example against a fresh worldA test whose reporter wrote an absolute path joins its anchored file (spec:observation.run-evidence.absolute-path-joins)passed6.06 ms
    executes the bound example against a fresh worldA test in a file with no test anchor is reported as unjoined (spec:observation.run-evidence.unanchored-file-unjoined)passed7.32 ms
    executes the bound example against a fresh worldThe runs page shows a run as external evidence from a test file (spec:consumers.spec-studio.runs-page.external-evidence)passed10.49 ms
    executes the bound example against a fresh worldWithout inputs the page set is the graph's alone (spec:consumers.spec-studio.data.inputs.graph-only)passed26.8 ms
    executes the bound example against a fresh worldBoth inputs add their pages, named, and the same inputs write the same bytes (spec:consumers.spec-studio.data.inputs.both-given)passed76.23 ms
    executes the bound example against a fresh worldThe stamp is written beside the page set, and a later build removes it (spec:consumers.spec-studio.sharing.stamp-written-apart)passed31.42 ms
    the stamp links source locations only after an HTTP stamp loads, encoding path segmentsnot recordedpassed4.11 ms
    recipe 45 picks the longest suffix and scopes through enabled examples at file grainnot recordedpassed8.33 ms
    ships a reusable preview, disabled by default, and deploys its own pull requests with runs and diffnot recordedpassed8.77 ms
    the tests lens counts file results once per Spec and names every run inputnot recordedpassed22.51 ms
    the Pack sentence keeps the graph's binding limit and positively names external evidencenot recordedpassed19.64 ms
    run metadata labels build and branch, and absent fields read not recordednot recordedpassed0.51 ms
    unjoined records escape outside names and explain both reason codes in wordsnot recordedpassed8.74 ms
    run files show the file alone, bindings and Suite, with one header per runnot recordedpassed8.99 ms
    recipe 45 does not join a suffix inside a path segmentnot recordedpassed3.02 ms
    stamp defaults to unknown and a stamped page set passes check-cleannot recordedpassed30.07 ms
    every reusable preview job's permissions fit the CI caller's grantnot recordedpassed15.2 ms
    PR checks and preview stamps name the same default merge checkoutnot recordedpassed7.86 ms
    preview download is optional and cancelled or skipped checks do not call itnot recordedpassed7.96 ms
    deploy checks the enabled Pages source before writing: gh-pagesnot recordedpassed28.99 ms
    deploy checks the enabled Pages source before writing: mainnot recordedpassed34.99 ms
    deploy checks the enabled Pages source before writing: disablednot recordedpassed11.65 ms
    deploy succeeds only once Pages publishes the pushed commit: an unrelated errored build is newestnot recordedpassed127.2 ms
    deploy succeeds only once Pages publishes the pushed commit: a retried build follows an errored onenot recordedpassed62.59 ms
    deploy succeeds only once Pages publishes the pushed commit: the build errorsnot recordedpassed40.96 ms
    deploy succeeds only once Pages publishes the pushed commit: the commit is never builtnot recordedpassed902.58 ms
    deploy succeeds only once Pages publishes the pushed commit: the answer arrives after the waitnot recordedpassed1531.29 ms
    preview still stamps and uploads rendered pages when evidence is absent and validation failsnot recordedpassed92.59 ms
    places external file rows under their verifier and renders shared files oncenot recordedpassed41.84 ms
    accepts the preview workflow's base and run flags togethernot recordedpassed22.06 ms
    formats external run durations to at most two decimals on every pagenot recordedpassed21.61 ms
Design view

Requirement drawing

  • Satisfying or referencing units: no recorded binding.
Requirement drawing for spec:consumers.spec-studio.sharing.stamp-written-apart
The diagram as text
  • spec:consumers.spec-studio.sharing.stamp-written-apart: The stamp is written beside the page set, and a later build removes it · declared Spec
  • spec:consumers.spec-studio.sharing: A Studio build is stamped and shared from a static host · declared Spec
  • test:protocol.studio-stamp-apart: test:protocol.studio-stamp-apart · anchored test binding · binding present · test/studio-s4.test.ts:555
  • spec:consumers.spec-studio.sharing.stamp-written-apart refines spec:consumers.spec-studio.sharing · declared
  • spec:consumers.spec-studio.sharing.stamp-written-apart verifies spec:consumers.spec-studio.sharing · declared
  • test:protocol.studio-stamp-apart verifies spec:consumers.spec-studio.sharing.stamp-written-apart · anchored
Mermaid source

Copyable source; the Studio draws static SVG.

Preferred and chosen syntax: requirementDiagram; exact refines, satisfies and verifies, with claim words in nodes and per-edge comments.

Decisions

No decision record named.

Runtime

No implementation neighborhood recorded.

Runtime observation: not tracked.

Evidence

Runtime observation: not tracked.

Build attestations: not tracked.

Deployments: not tracked.

Bills of materials: not tracked.

Impact
Relations of spec:consumers.spec-studio.sharing.stamp-written-apart
  • E2: verifies · declared
The diagram as text
  • spec:consumers.spec-studio.sharing: A Studio build is stamped and shared from a static host
  • spec:consumers.spec-studio.sharing.stamp-written-apart: The stamp is written beside the page set, and a later build removes it
  • spec:consumers.spec-studio.sharing.stamp-written-apart refines spec:consumers.spec-studio.sharing · declared
  • spec:consumers.spec-studio.sharing.stamp-written-apart verifies spec:consumers.spec-studio.sharing · declared
Mermaid source

Copyable source; the Studio draws static SVG.

Preferred syntax: flowchart. Chosen syntax: labelled flowchart, preserving exact relations, claims and folds.

Rests on

Rested on by

No Spec rests on this Spec.

Relations

Relation and directionOther endClaimReasonExercised keys
refines · outgoingA Studio build is stamped and shared from a static host
spec:consumers.spec-studio.sharing · resolves
declaredNoneNone
verifies · outgoingA Studio build is stamped and shared from a static host
spec:consumers.spec-studio.sharing · resolves
declaredNonebuildWritesNoStamp, stampVerb, stampLifetime

Bindings

Implementation binding: none

Design reference: none

Verifier binding: present

  • test:protocol.studio-stamp-apart · anchored · test/studio-s4.test.ts:555 · test anchor

Expected-outcome oracle: none

Runtime observation: not tracked.

Run results: not recorded in the graph.

Findings

None.

Composing (0)

Composing needs the script.