{
  "code": "S35",
  "name": "Timeline",
  "shape": "sequence",
  "family": "Lists and comparisons",
  "fits": "A progression read left to right: four to six phases or measures, each with an icon, a label and a caption.",
  "use_when": "When the order or the build-up matters. The rising line carries the sense of progress; notes are captions, not paragraphs.",
  "slots": [
    {
      "name": "head",
      "holds": "the claim, top left, one italic word",
      "budget": "under 8 words"
    },
    {
      "name": "arc",
      "holds": "TDW generated rising line with an arrow head, drawn from tokens",
      "budget": "generated"
    },
    {
      "name": "nodes",
      "holds": "4-6 x (icon in a filled circle, label, note)",
      "budget": "label 3 words, note under 15 words"
    }
  ],
  "columns": 5,
  "density": "standard",
  "surface": "paper",
  "works_on": [
    "deck",
    "page"
  ],
  "library": "Hoffman",
  "dir": "S35-timeline",
  "semantic": {
    "audience_question": "Which complementary measures define success, or which explicitly ordered milestones explain the progression?",
    "intent": "Understand the chosen relationship across the nodes: parallel measurement lenses or an explicitly ordered sequence.",
    "reasoning_relation": "parallel evaluation dimensions or explicit progression; state which relationship applies",
    "message_pattern": "Assess [objective] through [distinct measures and definitions], or prepare [outcome] through [ordered milestones].",
    "required_content": [
      "Four to six complementary evaluation dimensions, or explicitly ordered milestones for the alternate use.",
      "State which relationship is intended.",
      "For measures: definition, denominator, period and method available in supporting detail. For milestones: dates/order and transition conditions."
    ],
    "narrative_positions": [
      "context",
      "explanation",
      "evidence: choose only when the page supports the surrounding argument"
    ],
    "requires_before": [
      "Define the pilot objective and what a successful outcome would need to include; disclose measurement limits. For the alternate progression use, establish the objective and why ordered learning is needed."
    ],
    "enables_after": [
      "Specify definitions, data collection and decision thresholds for the measurement framework; for progression, show owners and dependencies."
    ],
    "slot_roles": {
      "head": "Name the chosen relationship: stages over time or complementary success measures.",
      "arc": "Decorative directional cue, not a chart. Do not attach an unsupported growth claim to its slope.",
      "nodes": "Four to six category-definition pairs for complementary measures; alternatively milestones with explicit dates/order. Never infer sequence from horizontal placement alone."
    },
    "avoid_when": [
      "A numeric trend chart",
      "Automatic causal inference from sequence",
      "A detailed Gantt schedule"
    ],
    "layout_specific_contract": "A progression read left to right: four to six phases or measures, each with an icon, a label and a caption.",
    "provenance": {
      "basis": "interpretation of the existing layout and slot contracts",
      "review": "Tessel model-authored guidance; implementation approved by Nic, 2026-10-10",
      "corpus_evidence_status": "not yet established",
      "guide": "../SEMANTICS.md"
    },
    "reader_outcome": "Follow a finite trajectory through labelled phases and concise notes.",
    "matching": {
      "audience_question": "Which complementary measures define success, or which explicitly ordered milestones explain the progression?",
      "reader_outcome": "Understand the chosen relationship across the nodes: parallel measurement lenses or an explicitly ordered sequence.",
      "reasoning_relation": "parallel evaluation dimensions or explicit progression; state which relationship applies",
      "content_shape": {
        "composition": "A progression read left to right: four to six phases or measures, each with an icon, a label and a caption.",
        "selected_state": "A progression read left to right: four to six phases or measures, each with an icon, a label and a caption.",
        "density": "standard",
        "columns": 5,
        "column_note": "Base metadata only; selected option can replace the base geometry."
      },
      "required_slots": [
        {
          "name": "head",
          "reader_question": "What progression connects these milestones from left to right?",
          "semantic_role": "Name the chosen relationship: stages over time or complementary success measures.",
          "content_unit_count": {
            "min": 1,
            "max": 1,
            "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
          },
          "placeholder": "[REAL CONTENT · head · the claim, top left, one italic word]",
          "layout_budget": {
            "authored": "under 8 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "head",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              4
            ]
          }
        },
        {
          "name": "arc",
          "reader_question": "What does the arc contribute to this page’s reader outcome?",
          "semantic_role": "Decorative directional cue, not a chart. Do not attach an unsupported growth claim to its slope.",
          "content_unit_count": {
            "min": 1,
            "max": 1,
            "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
          },
          "placeholder": "[REAL CONTENT · arc · TDW generated rising line with an arrow head, drawn from tokens]",
          "layout_budget": {
            "authored": "generated",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "arc",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              0
            ]
          }
        },
        {
          "name": "nodes",
          "reader_question": "What does this distinct step, state, scenario or observation contribute?",
          "semantic_role": "Four to six category-definition pairs for complementary measures; alternatively milestones with explicit dates/order. Never infer sequence from horizontal placement alone.",
          "content_unit_count": {
            "min": 4,
            "max": 6,
            "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
          },
          "placeholder": "[REAL CONTENT · nodes · 4-6 x (icon in a filled circle, label, note)]",
          "layout_budget": {
            "authored": "label 3 words, note under 15 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "nodes",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              50
            ]
          }
        }
      ],
      "rejection_constraints": [
        "Overlapping workstreams or exact scheduling that the curved trajectory cannot encode.",
        "Arbitrary numbered lists that imply chronology or causality."
      ],
      "option_guidance": {
        "option": "default",
        "composition_delta": "A progression read left to right: four to six phases or measures, each with an icon, a label and a caption.",
        "semantic_change": "retains base content relationship; changes presentation or disclosure",
        "matching_instruction": "Select S35 default when the supplied material answers “What progression connects these milestones from left to right?” through linear progression and milestones. Respect this state: A progression read left to right: four to six phases or measures, each with an icon, a label and a caption."
      },
      "provenance": {
        "status": "inferred composition evidence",
        "author_intent": "not independently confirmed",
        "basis": [
          "retained source composition where available",
          "authored layout and slot contracts",
          "static implementation inspection"
        ],
        "source_visual_count": 1,
        "source_visual_sha256": [
          "687d69a408402d36bc47aa17c2910b787ddac045d5be981039b4060594f1eca4"
        ],
        "source_export": "private source images remain outside this draft site",
        "markup_sha256": "72b149529bf034672820ef756ff14a70128a1762da6989b6520b6ee14873dab8",
        "limits": [
          "Static parsing inventories authored nodes; it does not certify rendered visibility, responsive fit or interactive state.",
          "Budgets are authored layout guidance, not a content-writing limit or proof of fit.",
          "Matching guidance is a draft inference; it does not establish facts, endorsement, causation or source author intent."
        ]
      },
      "adaptation_rules": [
        "Choose by audience question, reasoning relation and required content before aesthetic preference.",
        "Supply every required semantic role; retain visible unknowns as labelled real-content placeholders.",
        "A number needs source, scope and units; a quotation needs faithful wording and attribution.",
        "Do not infer importance from area, colour, depth or movement unless the content explicitly defines that encoding.",
        "Keep colour token roles, structural objects, licences and source records; changing content does not authorize changing them."
      ],
      "previous_required_slots": [
        {
          "name": "head",
          "reader_question": "What progression connects these milestones from left to right?",
          "semantic_role": "the claim, top left, one italic word",
          "content_unit_count": {
            "min": 1,
            "max": 1,
            "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
          },
          "placeholder": "[REAL CONTENT · head · the claim, top left, one italic word]",
          "layout_budget": {
            "authored": "under 8 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "head",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              4
            ]
          }
        },
        {
          "name": "arc",
          "reader_question": "What does the arc contribute to this page’s reader outcome?",
          "semantic_role": "TDW generated rising line with an arrow head, drawn from tokens",
          "content_unit_count": {
            "min": 1,
            "max": 1,
            "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
          },
          "placeholder": "[REAL CONTENT · arc · TDW generated rising line with an arrow head, drawn from tokens]",
          "layout_budget": {
            "authored": "generated",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "arc",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              0
            ]
          }
        },
        {
          "name": "nodes",
          "reader_question": "What does this distinct step, state, scenario or observation contribute?",
          "semantic_role": "4-6 x (icon in a filled circle, label, note)",
          "content_unit_count": {
            "min": 4,
            "max": 6,
            "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
          },
          "placeholder": "[REAL CONTENT · nodes · 4-6 x (icon in a filled circle, label, note)]",
          "layout_budget": {
            "authored": "label 3 words, note under 15 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "nodes",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              50
            ]
          }
        }
      ],
      "contract_correction": {
        "date": "2026-10-13",
        "basis": "Actual selected HTML/CSS inspection; previous required slots retained for review.",
        "records": [
          {
            "code": "S35",
            "option": "default",
            "semantic_overrides": {
              "audience_question": "Which complementary measures define success, or which explicitly ordered milestones explain the progression?",
              "intent": "Understand the chosen relationship across the nodes: parallel measurement lenses or an explicitly ordered sequence.",
              "reasoning_relation": "parallel evaluation dimensions or explicit progression; state which relationship applies",
              "message_pattern": "Assess [objective] through [distinct measures and definitions], or prepare [outcome] through [ordered milestones]."
            },
            "reason": "Retained source capture supports parallel measurement categories; current adaptation uses chronology. Preserve both distinct uses explicitly."
          }
        ]
      }
    },
    "rejection_constraints": [
      "Overlapping workstreams or exact scheduling that the curved trajectory cannot encode.",
      "Arbitrary numbered lists that imply chronology or causality."
    ],
    "markup_inventory": {
      "file": "spread.html",
      "sha256": "72b149529bf034672820ef756ff14a70128a1762da6989b6520b6ee14873dab8",
      "method": "static lxml markup plus authored option description; no rendered-visibility claim",
      "all_markup_slot_counts": {
        "head": 1,
        "arc": 1,
        "nodes": 1
      },
      "slot_evidence": {
        "head": [
          {
            "tag": "h2",
            "classes": "head",
            "sample_word_count": 4,
            "repeated_children": 1
          }
        ],
        "arc": [
          {
            "tag": "div",
            "classes": "art",
            "sample_word_count": 0,
            "repeated_children": 1
          }
        ],
        "nodes": [
          {
            "tag": "div",
            "classes": "nodes",
            "sample_word_count": 50,
            "repeated_children": 5
          }
        ]
      },
      "option_selectors": [],
      "linked_implementation": [
        {
          "file": "../spreads.css",
          "sha256": "32da94472b0c9131e4d5dae7d5bf0498b09202a9e66294b4e4f23e6ddfbf37ba"
        },
        {
          "file": "../spread.js",
          "sha256": "3d99948b83f750bd4ae95dac08e3e50a395de7c149c90a6f1a1c0ea36a2634a4"
        }
      ]
    },
    "variations": {},
    "previous_semantic_contract": {
      "audience_question": "What progression connects these milestones from left to right?",
      "intent": "Follow a finite trajectory through labelled phases and concise notes.",
      "reasoning_relation": "linear progression and milestones",
      "message_pattern": "First [step and purpose], then [step], leading to [outcome]."
    },
    "narrative_profile": {
      "central_point": "Five complementary measurement lenses define what success would mean; the same geometry can also carry an explicitly ordered progression, as the current adaptation does.",
      "communication_job": "For the source-supported use, show which different aspects of success need assessment. For the current chronological adaptation, show groundwork in an explicit order; state which relation the content uses.",
      "audience_value": "Explanation: helps a reader locate milestones or evaluation lenses without mistaking a rising decorative line for measured improvement.",
      "reading_path": [
        "Read the title to identify the relation: complementary measures or explicit progression.",
        "For the source-supported measurement use, read every node as a separate evaluation lens and its note as the definition.",
        "Compare coverage across the set; no metric substitutes for the others and the arc has no numeric scale.",
        "For the alternate chronological use only, follow the dates/order given in the content."
      ],
      "adaptation": {
        "required_inputs": [
          "Four to six complementary evaluation dimensions, or explicitly ordered milestones for the alternate use.",
          "State which relationship is intended.",
          "For measures: definition, denominator, period and method available in supporting detail. For milestones: dates/order and transition conditions."
        ],
        "slot_guidance": {
          "head": "Name the chosen relationship: stages over time or complementary success measures.",
          "arc": "Decorative directional cue, not a chart. Do not attach an unsupported growth claim to its slope.",
          "nodes": "Four to six category-definition pairs for complementary measures; alternatively milestones with explicit dates/order. Never infer sequence from horizontal placement alone."
        },
        "can_change": [
          "Milestones or measurement dimensions, explicitly labelled.",
          "Four-to-six nodes while preserving the chosen relation."
        ],
        "must_survive": [
          "State whether nodes are sequential or parallel.",
          "Do not use slope as data.",
          "Temporal order alone does not prove causation."
        ]
      },
      "worked_example": {
        "fictional": true,
        "scenario": "A fictional repair pilot needs a balanced measurement framework. Five parallel lenses follow the source capture’s category-plus-definition reasoning; they are proposed measures, not observed results.",
        "slot_fills": {
          "head": "Judge reliability from several directions.",
          "arc": "Decorative arc only; no numeric scale, chronology or implied improvement.",
          "nodes": [
            "Arrival readiness | Share of confirmed appointments with required parts and technician ready.",
            "First-visit completion | Share of eligible repairs completed on the first confirmed visit.",
            "Repeat visits | Additional visits per job, with reasons recorded.",
            "Resident certainty | Reported confidence in the appointment, using the same question for all respondents.",
            "Checking workload | Staff minutes spent confirming readiness per booking."
          ]
        },
        "reasoning": "The lenses distinguish operational readiness, completion, rework, resident experience and cost of checking. An improvement in one does not prove improvement in all five.",
        "qualification": "Fictional proposed framework. Define denominators, eligibility, period and collection method before measuring; no pilot result or causal effect is asserted."
      },
      "narrative_fit": {
        "before": "Define the pilot objective and what a successful outcome would need to include; disclose measurement limits. For the alternate progression use, establish the objective and why ordered learning is needed.",
        "after": "Specify definitions, data collection and decision thresholds for the measurement framework; for progression, show owners and dependencies.",
        "good_uses": [
          "A high-level planned progression",
          "Complementary evaluation dimensions when explicitly labelled",
          "Historical groundwork with verified dates"
        ],
        "poor_fits": [
          "A numeric trend chart",
          "Automatic causal inference from sequence",
          "A detailed Gantt schedule"
        ]
      },
      "evidence": {
        "observations": [
          "Viewed source: five success-measurement categories under a decorative rising line; it is not a dated timeline. Current markup instead contains five capability-building milestones. The two uses share geometry but differ semantically.",
          "Current HTML and active slot contract were inspected."
        ],
        "interpretations": [
          "The guidance interprets the layout’s communication affordances; it does not assert source-author intent."
        ],
        "not_verified": [
          "Original author intent, surrounding source sequence, sample factual claims and persuasion effects are not independently verified."
        ],
        "references": [
          "02_product/spreads/S35-timeline/source.webp",
          "dist/S35-timeline/spread.html",
          "dist/S35-timeline/spread.json",
          "https://github.com/neekchan/hoffman-agency-design-system/blob/main/templates/deck/Deck.dc.html"
        ]
      },
      "review": {
        "status": "reviewed",
        "basis": "Viewed retained source capture and inspected current markup/slot contract; reviewed reasoning and example mapping. This is layout-contract review, not source-intent confirmation."
      },
      "variation_relationship": "base",
      "alternate_worked_examples": [
        {
          "fictional": true,
          "scenario": "Alternate inferred use from current HTML: an explicitly planned chronological pilot, not the source capture’s parallel measurement framework.",
          "slot_fills": {
            "head": "Prepare the service before expanding it.",
            "arc": "Retain decorative arc; no numeric scale or growth claim.",
            "nodes": [
              "Week 1 | Define readiness criteria with technicians.",
              "Week 2 | Rehearse checks using fictional test bookings.",
              "Weeks 3–4 | Run the limited pilot and log exceptions.",
              "Week 5 | Review failures, workload and resident feedback.",
              "Week 6 | Decide whether to revise, expand or stop."
            ]
          },
          "reasoning": "The ordered planned milestones establish a learning sequence; the final decision is conditional, so the upward art cannot imply inevitable success.",
          "qualification": "Fictional teaching example only. Proposed benefits and results are not verified; replace with authorised material for a real use."
        }
      ]
    }
  },
  "options": [],
  "also_seen_in": [],
  "source": {
    "ref": "Hoffman L20 Timeline",
    "url": "https://github.com/neekchan/hoffman-agency-design-system/blob/main/templates/deck/Deck.dc.html"
  }
}