Baselines, versions and conformance
Every save is an immutable, digest-verified version. Name baselines, overlay them on the Gantt, diff any two versions, compare against a baseline and retain contract conformance assessments.
A schedule is only as defensible as its history. In os.construction, every successful save creates an immutable version: the exact definition, a content digest, and the calculation saved with it. Baselines, comparisons, analyses, traces and reports all point at a specific version, so they still mean the same thing next year.
Versions
- A version is created only by a successful calculation. Unsaved drafts never become versions.
- Each version keeps a content digest. Before a version is used in a calculation, a comparison or a report, its digest is checked, and a stored definition that fails the check is refused rather than read.
- Saved history lists earlier versions of activities and WBS summaries, so a removed item can be restored to its exact saved state in the Planner.
Named baselines
A named baseline is a frozen reference to one saved version. It records the name, a kind (for example project), who created it and when. It doesn’t follow later saves, approve the version, change field baseline dates or publish anything. See schedule baseline.
- Save the plan you mean to baseline. You can’t baseline an unsaved draft.
- Name it in the Planner’s baselines panel. Names don’t need to be unique; each baseline has a stable ID. Retrying the same request returns the same baseline instead of creating a duplicate.
- Use it. Overlay it on the Gantt, compare the current plan with it in the Planner, or choose its version in Schedule analysis for Earned Schedule and Compare.
The baseline timeline returns each activity’s start and finish from the baseline version’s original calculation, checked against the version’s digest. That’s what the Gantt overlay draws.
Compare and diff
Two tools answer two different questions:
| Question | Tool | Returns |
|---|---|---|
| How did the calculated schedule move? | Analysis › Compare | Finish movement and why, criticality gained and lost, date and float deltas per activity |
| What did someone author differently? | Version diff | Activities added and removed, the exact fields that changed, relationships added and removed, changed project sections |
The version diff ignores ordering noise (object keys, activity order, relationship order) but still counts duplicate relationships. It treats a missing field as different from an explicit null. It’s a read: it never moves the head, runs a calculation or publishes anything. Compare shows its relationship changes beside the engine’s comparison.
Conformance assessments
A conformance assessment checks a saved version against a governing profile: a specification or jurisdiction, named contracts, elected options, contract terms, and whether the version is the baseline submission. The report lists findings, evidence requirements, a score and coverage, which shows how many of the profile’s clauses were actually assessed.
- Pick a profile and declare whether this is a baseline submission. Advanced options take contract names, elections and terms.
- Run it on a saved version, including a historical one.
- Review the findings. Filter by text or status. The report warns you if its version is no longer the current plan.
Each assessment is kept immutably with its parameters, engine revision and input digest. Running it again creates a new assessment rather than overwriting the old one.
A baseline you can defend
- The baselined version passed a health check, and any exceptions are explained.
- Its data date is the planned start or the agreed status cutoff.
- The name says what it is, for example “Contract baseline, NTP 2026-03-02”.
- A conformance assessment against the contract profile is retained with it.
Limits
- An old version can’t be restored as the head. Rebuild the change, or restore individual activities from saved history.
- Baselines can’t be deleted, and they have no approval workflow.
- Assign Baselines sets a shared project baseline and your own primary, secondary and tertiary baselines. Up to three baseline bars draw on the Gantt, with BL1, BL2 and BL3 columns. See Baselines in views and layouts.
- Conformance reports can’t be exported as PDF yet. Download the retained JSON through the API.
Keep exploring
Related across os.construction
- GlossarySchedule BaselineA preserved reference plan used to compare later progress and forecast dates against the agreed planning basis.
- DocsReports, print Gantt, scheduled emails and the schedule assistantRun twelve P6-style schedule reports to CSV, XLSX or PDF, print a tiled Gantt PDF on tabloid or A3, email any of them on a daily, weekly or monthly schedule, and, where your company has turned it on, ask the schedule assistant questions answered only from cited, saved schedule facts.
- DocsResources and costs: assignments, resource usage, cost loading, Budget reconciliation, leveling and workforce capacityWork through every resource assignment in one table, see a resource's usage over time against its limit, retain cost-loaded schedule reports, reconcile activity cost to Budget lines, review leveling proposals, map schedule resources to people, crews and equipment, and check daily workforce capacity.
- GlossaryEarned Value TechniqueThe rule that decides how much of an activity's budget counts as earned at a given point of progress, such as percent complete, 0/100 or 50/50.
- Free toolConstruction schedule (Gantt) templateFree construction schedule template for Excel.
- BlogHow to build a three-week look-ahead schedule the field will actually useThe master schedule says what has to happen. The three-week look-ahead says who does it, where, and what has to be cleared first. Here is how to pull it from the master, break it down to crew level, screen every activity for constraints, get commitments from the trades, and roll it forward each week, with a worked example.
Was this helpful?
Run it on your own project.
Start a 14-day free trial. Want a say in what ships next? Join the founding program.
14-day free trial. Pricing for paid plans isn't set yet. Talk to us. Already have an account? Sign in →