Spec Studio

Waiting Specs that rest on each other share a round and report a cycle

spec:consumers.readiness-planner.cycle-shares-a-roundExample / Scenario · storyready floor ready

Packs: pack:adopter-speed-v1, pack:self-hosting-v1

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

Findings: no errors, no warnings

specs/consumers/readiness-planner.cycle-shares-a-round.sdp.md

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

Intent
outcome
Execute the cycle rule on two waiting Specs that depend on each other.
assumptions
  • The world writes a probe corpus of two story-altitude behavior Specs, each stating defined with an Intent outcome and one rule and each declaring dependsOn on the other, so both floors reach ready. The Specs carry the ids the queue names, and the world reads the queue as the dependency-order example does.
Behavior

Examples

Given a probe corpus in which {corpus: "two waiting Specs depend on each other"}
When the statement queue runs over the probe corpus
Then the queue lists {queue: "spec:probe.a, spec:probe.b"} in that order
Then round 1 holds {firstRound: "spec:probe.a, spec:probe.b"}
Then the queue reports {cycles: 1} cycles
Verification

Verifier bindings

  • test:protocol.readiness-planner.cycle-shares-a-round · anchored · test anchor binding present · test/self-hosting-readiness-planner.test.ts:236

    External run evidence from test/self-hosting-readiness-planner.test.ts

    Test anchors: test:protocol.readiness-planner.cycle-shares-a-round, test:protocol.readiness-planner.decision-first, test:protocol.readiness-planner.dependency-order, test:protocol.readiness-planner.owner-question-holds. Specs verified by those bindings: spec:consumers.readiness-planner, spec:consumers.readiness-planner.cycle-shares-a-round, spec:consumers.readiness-planner.decision-first, spec:consumers.readiness-planner.dependency-order, spec:consumers.readiness-planner.owner-question-holds.

    Run 1: external run evidence from vitest 4.1.10

    Build: CI 380 · Branch: feature/roadmap-and-slices-v0 · Commit: 34909918bf0be0e849959644401797191cae379f · Start: 2026-10-22T17:40:31.456Z · Stop: 2026-10-22T17:42:16.171Z

    NameSuiteResultDuration
    executes the bound example against a fresh worldThe Spec another rests on comes first in the queue (spec:consumers.readiness-planner.dependency-order)passed16.93 ms
    executes the bound example against a fresh worldA waiting decision comes before the Spec it shapes (spec:consumers.readiness-planner.decision-first)passed3.53 ms
    executes the bound example against a fresh worldWaiting Specs that rest on each other share a round and report a cycle (spec:consumers.readiness-planner.cycle-shares-a-round)passed2.58 ms
    executes the bound example against a fresh worldAn owner's blocking question lists the Specs it holds (spec:consumers.readiness-planner.owner-question-holds)passed2.85 ms
    diagnoses invalid decider nullstatement queue detailspassed5.3 ms
    diagnoses invalid decider falsestatement queue detailspassed2.91 ms
    diagnoses invalid decider 1statement queue detailspassed2.79 ms
    diagnoses invalid decider ""statement queue detailspassed2.7 ms
    diagnoses invalid decider "Owner"statement queue detailspassed5.63 ms
    diagnoses invalid decider "two words"statement queue detailspassed2.82 ms
    diagnoses invalid decider "with_underscore"statement queue detailspassed3 ms
    orders SCCs by longest dependency chain, ignores non-ordering and self edges, and sorts ids by code unitstatement queue detailspassed6.48 ms
    yields refines to the reverse dependsOn relationstatement queue detailspassed1.71 ms
    yields refines to the reverse constrainedBy relationstatement queue detailspassed2.39 ms
    yields refines to the reverse decidedBy relationstatement queue detailspassed1.68 ms
    chooses a shortest cycle path before breaking ties by target idstatement queue detailspassed3.3 ms
    selects every higher floor, ignores lower or equal floors, and orders only direct waiting linksstatement queue detailspassed3.23 ms
    selects questions, counts undecided ones, and holds direct typed dependents by stated rungstatement queue detailspassed4.57 ms
Design view

Requirement drawing

  • Satisfying or referencing units: no recorded binding.
Requirement drawing for spec:consumers.readiness-planner.cycle-shares-a-round
The diagram as text
  • spec:consumers.readiness-planner.cycle-shares-a-round: Waiting Specs that rest on each other share a round and report a cycle · declared Spec
  • spec:consumers.readiness-planner: The readiness planner orders the statements a person can make · declared Spec
  • test:protocol.readiness-planner.cycle-shares-a-round: test:protocol.readiness-planner.cycle-shares-a-round · anchored test binding · binding present · test/self-hosting-readiness-planner.test.ts:236
  • spec:consumers.readiness-planner.cycle-shares-a-round refines spec:consumers.readiness-planner · declared
  • spec:consumers.readiness-planner.cycle-shares-a-round verifies spec:consumers.readiness-planner · declared
  • test:protocol.readiness-planner.cycle-shares-a-round verifies spec:consumers.readiness-planner.cycle-shares-a-round · 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.readiness-planner.cycle-shares-a-round
  • E2: verifies · declared
The diagram as text
  • spec:consumers.readiness-planner: The readiness planner orders the statements a person can make
  • spec:consumers.readiness-planner.cycle-shares-a-round: Waiting Specs that rest on each other share a round and report a cycle
  • spec:consumers.readiness-planner.cycle-shares-a-round refines spec:consumers.readiness-planner · declared
  • spec:consumers.readiness-planner.cycle-shares-a-round verifies spec:consumers.readiness-planner · 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 · outgoingThe readiness planner orders the statements a person can make
spec:consumers.readiness-planner · resolves
declaredNoneNone
verifies · outgoingThe readiness planner orders the statements a person can make
spec:consumers.readiness-planner · resolves
declaredNonecycles, order

Bindings

Implementation binding: none

Design reference: none

Verifier binding: present

  • test:protocol.readiness-planner.cycle-shares-a-round · anchored · test/self-hosting-readiness-planner.test.ts:236 · 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.