@diagrammo/dgmo 0.47.0 → 0.48.0

package/src/pert/share-normalize.ts

@@ -1,62 +0,0 @@
-// ============================================================
-// PERT — share-link source normalization
-// ============================================================
-//
-// `start-date now` resolves to the host's local date at parse time,
-// but a share-link is meant to capture authoring intent — the
-// recipient should see the dates the author saw, not "today, wherever
-// you are."
-//
-// This module performs a textual substitution on the DGMO source
-// BEFORE compression: any line of the form `start-date now` (with
-// optional leading whitespace and trailing comment) becomes
-// `start-date <today's local YYYY-MM-DD>`. Other lines pass through
-// unchanged.
-//
-// The substitution lives here, not in `dgmo/src/sharing.ts`, because
-// `sharing.ts` is DSL-agnostic by design (compresses any string).
-
-import { formatLocalISODate } from './internal';
-
-const START_DATE_NOW_RE = /^(\s*start-date\s+)now(\s*)$/i;
-
-/**
- * Strip a trailing line-leading-whitespace comment, mirroring
- * parser.ts's `stripTrailingComment`. Used so we can match `now` even
- * when the author wrote `start-date now  # use today's plan`, while
- * preserving the original line shape (including the comment) on
- * substitution.
- */
-function splitTrailingComment(line: string): { code: string; comment: string } {
-  const m = line.match(/^(.*?)(\s+#.*)$/);
-  if (!m) return { code: line, comment: '' };
-  // In-bounds by regex match: groups 1 and 2 are guaranteed present.
-  return { code: m[1]!, comment: m[2]! };
-}
-
-/**
- * Substitute `start-date now` with the host-local resolved date.
- * Pass the result to `encodeDiagramUrl` so the share-link captures
- * the resolved date, not the literal token.
- *
- * Lines without `start-date now` (explicit-date lines, comments,
- * other directives, activity lines containing the word "now") pass
- * through verbatim.
- */
-export function normalizePertSourceForShare(dsl: string): string {
-  const today = formatLocalISODate(new Date());
-  const lines = dsl.split('\n');
-  const out: string[] = [];
-
-  for (const line of lines) {
-    const { code, comment } = splitTrailingComment(line);
-    const m = code.match(START_DATE_NOW_RE);
-    if (m) {
-      out.push(`${m[1]}${today}${m[2]}${comment}`);
-    } else {
-      out.push(line);
-    }
-  }
-
-  return out.join('\n');
-}

package/src/pert/types.ts

@@ -1,604 +0,0 @@
-// ============================================================
-// PERT Diagram — public types
-// ============================================================
-//
-// Activity-on-Node project network with three-point estimates.
-// See `docs/dgmo-language-spec.md` § PERT for the grammar; see
-// `_bmad-output/implementation-artifacts/tech-spec-pert.md` for the
-// design decisions captured here.
-
-import type { DgmoError } from '../diagnostics';
-import type { Duration } from '../gantt/types';
-import type { TagGroup } from '../utils/tag-groups';
-import type { DurationEstimate } from './internal';
-
-// ── Directives ──────────────────────────────────────────────
-
-/** Layout direction. `LR` is the default; `TB` for tall chains. */
-export type PertDirection = 'LR' | 'TB';
-
-/** `node-detail` directive value. */
-export type NodeDetail = 'compact' | 'full';
-
-/**
- * Project schedule anchor. Mutually-exclusive at parse time:
- *   - `forward`  — `start-date YYYY-MM-DD` anchors source-activity ES.
- *   - `backward` — `end-date YYYY-MM-DD` anchors sink-activity LF.
- *   - `null`     — no anchor; ES/EF/LS/LF render as numeric offsets.
- */
-export type Anchor =
-  | { kind: 'forward'; date: string }
-  | { kind: 'backward'; date: string }
-  | null;
-
-/**
- * One row of the project-stats caption. Replaces the previous
- * `\n`-joined `summaryText` string with a structured shape so the
- * renderer doesn't have to recover bullet structure by splitting on
- * `\n` / `. ` and tests can assert on `isPast` directly instead of
- * matching the trailing `(latest-safe start has passed)` suffix.
- */
-export interface CaptionRow {
-  /** Pre-formatted caption text for this row (no leading bullet glyph). */
-  text: string;
-  /** 0 = top-level row; 1 = sub-row (indented under the previous level-0 row). */
-  level: 0 | 1;
-  /** When true, renderer paints the text italic. */
-  italic?: boolean;
-  /**
-   * Backward-mode flag — true when the row reports a latest-safe-start
-   * date that precedes `options.today`. The text already carries a
-   * `(latest-safe start has passed)` suffix; the flag is for downstream
-   * styling/test assertions.
-   */
-  isPast?: boolean;
-}
-
-/** Diagram-level options collected by the parser. */
-export interface PertOptions {
-  /** Time unit for μ/σ/ES/EF formatting and M-only heuristics. */
-  timeUnit: Duration['unit'];
-  /** `direction` directive. Defaults to `LR`. */
-  direction: PertDirection;
-  /** `node-detail` directive. Defaults to `compact`. */
-  nodeDetail: NodeDetail;
-  /**
-   * Global confidence used to fill O/P from M-only durations.
-   * Stored verbatim — analyzer applies `resolveConfidence()` to expand
-   * named levels (`high`/`medium`/`low`) or `O/P` factor pairs.
-   */
-  confidence: string;
-  /** Monte-Carlo trials for the canonical run (default 10000). */
-  trials: number;
-  /** Monte-Carlo seed; deterministic across machines via mulberry32. */
-  seed: number;
-  /** Fast-MC trials for the live duration scrubber (default 300, floor 100). */
-  scrubberTrials: number;
-  /**
-   * Date anchor — discriminated union enforces mutual exclusion.
-   * `null` when no `start-date`/`end-date` directive was authored.
-   */
-  anchor: Anchor;
-  /** When true, the renderer suppresses the diagram banner title. */
-  noTitle?: boolean;
-  /**
-   * `solid-fill` directive — render node/group card fills at full intent
-   * saturation instead of the canonical 25% tint (via `shapeFill`).
-   */
-  solidFill?: boolean;
-  /**
-   * `no-analysis` directive — suppresses the analysis layer (tornado +
-   * S-curve). The layer renders by default whenever Monte Carlo ran;
-   * this bare flag turns it off (mirrors `no-title`). An explicit
-   * `viewState.an` (desktop-app toggle / share link) overrides it.
-   */
-  noAnalysis?: boolean;
-  /**
-   * `active-tag <name>` directive — selects which declared tag group
-   * drives node fill via `resolveTagColor()`. `'none'` (case-insensitive)
-   * suppresses tag coloring; `undefined` lets `resolveActiveTagGroup()`
-   * auto-activate the first declared group.
-   */
-  activeTag?: string;
-  /**
-   * Sprint mode (mirrors Gantt's surface). Activated automatically when
-   * `time-unit s` is set, or explicitly when any `sprint-*` directive
-   * appears. Schedule cells render as `S<n>` instead of numeric offsets
-   * or ISO dates.
-   */
-  sprintLength: Duration | null; // default { amount: 2, unit: 'w' } when sprint mode active
-  sprintNumber: number | null; // which sprint the chart starts at (default 1)
-  sprintStart: string | null; // YYYY-MM-DD — date that sprintNumber begins (optional)
-  sprintMode: 'auto' | 'explicit' | null; // auto = activated by `s` unit, explicit = sprint-* directive present
-  /**
-   * "Today" baked in at parse time (ISO YYYY-MM-DD). Same source as
-   * `start-date now`, captured for every parse regardless of whether
-   * `now` was authored. Analyzer reads this to flag past latest-safe
-   * starts in backward mode; renderer surfaces it in the
-   * `(as of YYYY-MM-DD)` anchor annotation. Empty string when the
-   * parser was given no `now` and no `start-date now` directive (legacy
-   * fixtures pre-dating this field) — consumers treat empty as
-   * "no today known" and skip past-flagging.
-   */
-  today: string;
-}
-
-// ── Parsed elements ─────────────────────────────────────────
-
-/**
- * A PERT activity (node). Activities have either a three-point estimate,
- * an M-only estimate (parser fills O/P from confidence factors), or no
- * estimate at all (TBD — analyzer null-poisons descendants).
- */
-export interface PertActivity {
-  /** Stable id — alias if `as` was given, otherwise normalized name. */
-  readonly id: string;
-  /** Human-readable label as written in source. */
-  readonly name: string;
-  /** Optional alias from `<name> <durs> as <id>`. */
-  readonly alias?: string;
-  /**
-   * Activity duration estimate.
-   * - `null` → TBD (no estimate); analyzer poisons descendants with `null`.
-   */
-  readonly duration: DurationEstimate | null;
-  /**
-   * Per-activity confidence override from pipe metadata (`| confidence: low`).
-   * When unset, analyzer uses `options.confidence`.
-   */
-  readonly confidence?: string;
-  /** Group id this activity belongs to (post-resolve). */
-  readonly groupId?: string;
-  /** Source line of the declaration site (1-based). */
-  readonly lineNumber: number;
-  /** True for `milestone <name>` primitives (zero-duration, diamond shape). */
-  readonly isMilestone: boolean;
-  /**
-   * Resolved tag-group metadata from pipe-metadata aliases. Keys are
-   * lowercased tag-group names (e.g. `priority`, `team`); values are the
-   * authored tag entry names. Drives node fill via `resolveTagColor()`
-   * when an `active-tag` group is set. Empty when no tag groups are
-   * declared or the activity carried no tag metadata.
-   */
-  readonly tags?: Readonly<Record<string, string>>;
-}
-
-/**
- * Forward-style milestone shorthand. Stored as a `PertActivity` with
- * `isMilestone: true` and a zero-duration estimate, but kept here as a
- * distinct exported alias for callers that want to filter by kind.
- */
-export type PertMilestone = PertActivity & { isMilestone: true };
-
-/**
- * Dependency type — defaults to FS (Finish-to-Start), the dominant case.
- * - FS: `B.ES ≥ A.EF + lag` (most edges)
- * - SS: `B.ES ≥ A.ES + lag` (parallel start)
- * - FF: `B.EF ≥ A.EF + lag` (synchronized finish)
- * - SF: `B.EF ≥ A.ES + lag` (rare; included for completeness)
- */
-export type EdgeType = 'FS' | 'SS' | 'FF' | 'SF';
-
-/**
- * Directed dependency edge from `source` activity to `target`.
- * `type` defaults to FS, `lag` to null (zero offset). Lag amount may be
- * negative (a lead — predecessor and successor overlap).
- */
-export interface PertEdge {
-  readonly source: string;
-  readonly target: string;
-  readonly lineNumber: number;
-  readonly type: EdgeType;
-  readonly lag: Duration | null;
-}
-
-/** Group declared via `[group-name] | metadata`. */
-export interface PertGroup {
-  readonly id: string;
-  readonly name: string;
-  /** Activity ids belonging to this group, populated in Pass 2. */
-  readonly activityIds: readonly string[];
-  /** Whether the user authored `| collapsed: true`. */
-  readonly collapsed: boolean;
-  /** Source line of the `[group-name]` header (1-based). */
-  readonly lineNumber: number;
-  /**
-   * Resolved tag-group metadata for the cluster header — same shape as
-   * `PertActivity.tags`. Currently informational; default-tag injection
-   * skips groups (containers) so they appear "untagged" unless the user
-   * authors an explicit value via pipe metadata.
-   */
-  readonly tags?: Readonly<Record<string, string>>;
-  /**
-   * Auto-detected group topology (Pass 2 result).
-   * - `hammock`: single entry + single exit — collapses to a super-edge.
-   * - `cluster`: multi-entry or multi-exit — collapses to a bounding rect.
-   */
-  readonly classification?: 'hammock' | 'cluster';
-}
-
-/** Output of `parsePert(content)`. */
-export interface ParsedPert {
-  /** Optional title parsed from `pert <title>`. */
-  readonly title: string | null;
-  readonly options: PertOptions;
-  readonly activities: readonly PertActivity[];
-  readonly edges: readonly PertEdge[];
-  readonly groups: readonly PertGroup[];
-  /**
-   * Tag groups declared at the top of the diagram (`tag Priority as p
-   * High red, Low green`). Drive node fill via `resolveTagColor()`.
-   * Empty when no `tag` blocks are declared.
-   */
-  readonly tagGroups: readonly TagGroup[];
-  /**
-   * Map alias-or-name → canonical activity id. Useful for the analyzer
-   * and for editor autocomplete; also populated in Pass 2.
-   */
-  readonly idMap: Readonly<Record<string, string>>;
-  readonly diagnostics: readonly DgmoError[];
-  /** First fatal error message; `null` when parse succeeded. */
-  readonly error: string | null;
-}
-
-// ── Resolved (post-analyzer) ────────────────────────────────
-
-/**
- * Fully-resolved per-activity analysis output. ES/EF/LS/LF/slack are
- * `null` for any activity downstream of a TBD (poison-propagation per
- * AC2.3).
- */
-export interface ResolvedActivity {
-  activity: PertActivity;
-  /** Earliest start (forward pass). `null` if upstream TBD. */
-  es: number | null;
-  /** Earliest finish. */
-  ef: number | null;
-  /** Latest start (backward pass). */
-  ls: number | null;
-  /** Latest finish. */
-  lf: number | null;
-  /** Slack = LS − ES (or LF − EF). 0 = on critical path. `null` if poisoned. */
-  slack: number | null;
-  /** True iff the M-world critical path passes through this activity. */
-  isCriticalPath: boolean;
-  /** Resolved μ in `options.timeUnit` (numeric mean of o/m/p). */
-  mu: number | null;
-  /** Resolved σ in `options.timeUnit` (Beta-PERT std dev). */
-  sigma: number | null;
-  /**
-   * Criticality index from Monte Carlo (0–1). `null` when MC is off or
-   * when this activity is downstream of a TBD.
-   */
-  criticality: number | null;
-  /**
-   * True iff the source declared an explicit O/M/P triple. M-only,
-   * TBD, and milestone activities all report `false`.
-   */
-  isAuthored: boolean;
-}
-
-/** Resolved hammock/cluster group. */
-export interface ResolvedGroup {
-  group: PertGroup;
-  /** Aggregate μ/σ along the group's internal critical path. */
-  rolledMu: number | null;
-  rolledSigma: number | null;
-  /** Group entry/exit ids derived in Pass 2. */
-  entries: string[];
-  exits: string[];
-  /**
-   * Rolled-up schedule envelope across member activities.
-   *   ES = min member.es
-   *   EF = max member.ef
-   *   LS = min member.ls
-   *   LF = max member.lf
-   *   slack = LS − ES
-   *   criticality = max member.criticality (when MC is on)
-   * Each is `null` when no member has a non-null value (e.g. all-TBD group).
-   */
-  es: number | null;
-  ef: number | null;
-  ls: number | null;
-  lf: number | null;
-  slack: number | null;
-  criticality: number | null;
-}
-
-/**
- * Bare shape for a Monte-Carlo simulation result; Phase 2 fills it.
- * Keeping the shape exported in v1 means analyzer consumers don't break
- * when MC support lands.
- */
-export interface MonteCarloResult {
-  /** Trials run (canonical or fast). */
-  trials: number;
-  /** Seed used for deterministic reproduction. */
-  seed: number;
-  /** Project-completion percentiles. */
-  p50: number;
-  p80: number;
-  p95: number;
-  /**
-   * Central ~68% band — empirical equivalent of a ±1σ window. Used by
-   * the S-curve to draw a "where the project most likely lands" shaded
-   * region without assuming the finish-time distribution is normal.
-   */
-  p16: number;
-  p84: number;
-  /**
-   * Empirical lower bound — minimum trial duration in canonical days.
-   * Used by the S-curve to anchor its x-axis at the actually-observed
-   * span rather than an analytical extrapolation. Backward-mode reads
-   * this through `end_date − max` to land the left edge of the
-   * candidate-start axis.
-   */
-  minDurationDays: number;
-  /**
-   * Empirical upper bound — maximum trial duration in canonical days.
-   * Symmetric counterpart to `minDurationDays`. Backward-mode reads
-   * this as the latest candidate start that still has a chance of
-   * hitting the deadline.
-   */
-  maxDurationDays: number;
-  /** Per-activity criticality index, keyed by activity id. */
-  criticalityByActivity: Record<string, number>;
-  /** Modal-longest-path tuple (activity ids). */
-  modalCriticalPath: string[];
-  /**
-   * Per-activity tornado swings — how much the project end-date
-   * moves when this activity comes in at its optimistic (O) or
-   * pessimistic (P) extreme while every other activity stays at
-   * its mean (μ). Sorted descending by total swing.
-   *
-   * `lowSwing` and `highSwing` are in canonical days (≥ 0).
-   * Renderer converts to display unit.
-   */
-  tornadoSwings: TornadoSwing[];
-}
-
-/**
- * One row of a true two-sided tornado: the project end-date moves
- * lowSwing days earlier when the activity is at its optimistic
- * extreme, and highSwing days later when at its pessimistic extreme.
- * All other activities held at their μ.
- */
-export interface TornadoSwing {
-  id: string;
-  name: string;
-  /** Days the project finishes EARLIER when this activity ≈ O. */
-  lowSwing: number;
-  /** Days the project finishes LATER when this activity ≈ P. */
-  highSwing: number;
-  /** Per-activity MC criticality index, used by the renderer for bar color. */
-  criticality: number | null;
-}
-
-/**
- * Per-activity (O, M, P) in canonical days — the analyzer's
- * expanded-estimate cache, populated for every activity that has an
- * estimate (TBDs are omitted). Workers re-running Monte Carlo on an
- * already-resolved PERT can read this directly instead of re-parsing
- * + re-expanding from source.
- */
-export interface PertExpandedActivity {
-  id: string;
-  o: number;
-  m: number;
-  p: number;
-}
-
-export interface ResolvedPert {
-  options: PertOptions;
-  activities: ResolvedActivity[];
-  edges: PertEdge[];
-  groups: ResolvedGroup[];
-  /**
-   * Tag groups copied from the parsed source. The renderer reads this
-   * + `options.activeTag` to drive node fill via `resolveTagColor()`
-   * and to render the legend.
-   */
-  tagGroups: TagGroup[];
-  /**
-   * Analysis mode auto-derived from data: `monte-carlo` when at least
-   * one non-milestone activity carries an O/M/P triple AND `trials >= 100`,
-   * otherwise `analytical`.
-   */
-  mode: 'monte-carlo' | 'analytical';
-  /**
-   * Project-stats caption rows. Each row is one bullet in the rendered
-   * caption box; level-1 rows render indented under the preceding
-   * level-0 row. Null only when analysis bails out before producing
-   * any output (e.g. cycle detection); non-null in every successful
-   * analyze() run.
-   */
-  summaryRows: CaptionRow[] | null;
-  /**
-   * One-line project summary rendered as a subtitle under the diagram title.
-   * Shape per mode (see §13A.7):
-   *   - Forward:    `Expected finish: <date> · ≈ <μ> <unit> of work (± <σ>)`
-   *   - Backward:   `Expected start: <date> · ≈ <μ> <unit> lead time (± <σ>)`
-   *   - Unanchored: `≈ <μ> <unit> (± <σ>)`
-   * Null when analysis bails out before producing any output.
-   */
-  projectSubtitle: string | null;
-  /** μ along the M-world critical path (max EF over all activities). */
-  projectMu: number | null;
-  /** σ along the M-world critical path (sqrt of variance sum). */
-  projectSigma: number | null;
-  /** Critical-path activity ids in topological order. */
-  criticalPath: string[];
-  /**
-   * Anchored mode: the date all four schedule labels (ES/EF/LS/LF) are
-   * computed off. Forward = start-date; backward = end-date − projectMu;
-   * null otherwise (no anchor, or backward + TBD upstream).
-   */
-  projectStart: string | null;
-  /** Populated when `mode === 'monte-carlo'`. */
-  monteCarloResult: MonteCarloResult | null;
-  /**
-   * Per-activity (O, M, P) in canonical days. Always populated; used
-   * by Phase 3b Worker / scrubber so the simulator can re-run on a
-   * postMessage-cloned ResolvedPert without needing the original
-   * ParsedPert or analyzer state.
-   */
-  expandedActivities: PertExpandedActivity[];
-  diagnostics: DgmoError[];
-  error: string | null;
-}
-
-// ── Layout result ───────────────────────────────────────────
-
-export interface PertLayoutNode {
-  readonly id: string;
-  readonly x: number;
-  readonly y: number;
-  readonly width: number;
-  readonly height: number;
-}
-
-export interface PertLayoutEdge {
-  readonly source: string;
-  readonly target: string;
-  readonly points: ReadonlyArray<{ readonly x: number; readonly y: number }>;
-}
-
-export interface PertLayoutGroup {
-  readonly id: string;
-  readonly x: number;
-  readonly y: number;
-  readonly width: number;
-  readonly height: number;
-  readonly classification: 'hammock' | 'cluster';
-  /**
-   * True when the group is currently collapsed. Layout sized this rect
-   * as a single rolled-up node and hid the group's member activities
-   * from `nodes` / re-routed external edges to land on this rect.
-   */
-  readonly collapsed?: boolean;
-}
-
-export interface LayoutResult {
-  readonly nodes: readonly PertLayoutNode[];
-  readonly edges: readonly PertLayoutEdge[];
-  readonly groups: readonly PertLayoutGroup[];
-  readonly width: number;
-  readonly height: number;
-}
-
-// ── S-curve (completion-probability widget) ─────────────────
-
-/**
- * One reference line drawn on the S-curve plot — a colored vertical
- * dropped at a percentile's mode-appropriate x-coordinate. Forward
- * mode places lines at P50/P80/P95 finishes; backward mode places
- * them at P50/P80/P95 latest-safe starts. `isPast` flips to `true`
- * when the resolved date precedes `options.today` (backward-only);
- * the renderer paints those lines dashed and the label carries a
- * trailing `" (past)"`.
- */
-export interface ScurveReferenceLine {
-  /**
-   * X-coordinate in canonical x-axis days. Forward: the percentile
-   * duration. Backward: candidate-start canonical days
-   * (= `deadlineDays − duration_PX`), so the vertical lands at the
-   * latest-safe-start date when projected through the renderer's
-   * `xScale`.
-   */
-  x: number;
-  /** Cumulative probability at the percentile (0.50 / 0.80 / 0.95). */
-  y: number;
-  /**
-   * Original duration in canonical days. Backward mode keeps this for
-   * the secondary "≈ Nw of work" sub-label below each percentile dot;
-   * forward mode mirrors `x`.
-   */
-  durationDays: number;
-  /** Label text (already past-suffixed by `buildScurveData` when applicable). */
-  label: string;
-  /** True in backward mode when the date precedes `options.today`. */
-  isPast: boolean;
-}
-
-/**
- * Data backing the S-curve widget. `buildScurveData` populates this
- * once per render; `renderScurveBlock` reads it directly. The
- * structure is mode-discriminated so renderer code stays mode-blind
- * outside of the dashed-line / past-suffix decision (Path B per
- * tech-spec §13A.12).
- */
-export interface ScurveData {
-  /** Forward mode = finish-date axis; backward mode = candidate-start axis. */
-  mode: 'forward' | 'backward';
-  /** Mode-appropriate y-axis title. */
-  yAxisLabel: string;
-  /**
-   * Curve points ready to plot, ordered ascending by `x`. Forward mode
-   * rises 0.05 → 0.95; backward mode falls 0.95 → 0.05. `x` is in
-   * canonical x-axis days (matches `xScale`), `y` is cumulative
-   * probability. Pre-projecting here lets the renderer stay
-   * mode-blind for curve construction.
-   */
-  curvePoints: { x: number; y: number }[];
-  /**
-   * Sorted-ascending sample x-coordinates in canonical days. Forward:
-   * empirical duration samples. Backward: `deadlineDays − duration`
-   * for the same trials, so samples[0] is the leftmost candidate-start
-   * x. Retained for callers that want raw samples; the renderer reads
-   * `curvePoints` for plotting.
-   */
-  samples: number[];
-  /**
-   * Central 68% band edges in canonical x-axis days (left/right of the
-   * shaded region). Forward: `[duration_p16, duration_p84]`. Backward:
-   * `[deadlineDays − duration_p84, deadlineDays − duration_p16]` so
-   * `p16Days ≤ p84Days` always holds.
-   */
-  p16Days: number;
-  p84Days: number;
-  /**
-   * Percentile *plotting positions* in canonical x-axis days. Forward:
-   * the duration value. Backward: `deadlineDays − duration_PX`, so
-   * each dot lands on its candidate-start-date column.
-   */
-  p50Days: number;
-  p80Days: number;
-  p95Days: number;
-  /**
-   * X-axis bounds in canonical x-axis days. Forward:
-   * `[minDurationDays, maxDurationDays]` — the empirical duration
-   * span. Backward: `[deadlineDays − maxDurationDays, deadlineDays]`
-   * — the candidate-start span, with the right edge at the deadline
-   * (= `projectMu` canonical days from `projectStart`). May be
-   * negative when the longest trial exceeds the M-world span.
-   */
-  xMinDays: number;
-  xMaxDays: number;
-  /**
-   * Three percentile reference lines (P50, P80, P95). Order is
-   * preserved; `isPast` is meaningful only in backward mode.
-   */
-  referenceLines: ScurveReferenceLine[];
-  /**
-   * Optional contextual framing line — currently the anchor annotation
-   * (e.g. "Backward-anchored from end-date YYYY-MM-DD (as of YYYY-MM-DD)").
-   * Rendered as the S-curve subline when present.
-   */
-  framingNote: string | null;
-  /**
-   * Project start date (ISO yyyy-mm-dd) when the diagram is anchored.
-   * Lets the x-axis display calendar dates (in addition to durations).
-   * Backward mode also fills this (with the implied start = end − μ)
-   * so the renderer's existing date-axis code stays mode-blind.
-   */
-  anchorDate: string | null;
-  /**
-   * Hard deadline (canonical days from projectStart) when the diagram
-   * is end-date-anchored. Drawn as a vertical line on the plot so
-   * readers can see at a glance how close the percentile finishes
-   * land to the constraint. Null for forward-anchored or unanchored.
-   */
-  deadlineDays: number | null;
-  /** Deadline date as ISO yyyy-mm-dd, used for the on-chart label. */
-  deadlineDate: string | null;
-}