v0.2.0 — Calendars decode in both slot orders; working-day arithmetic, the writer and the summary are corrected

The first release since v0.1.0. Calendar decoding, working-day arithmetic, the XER writer and the schedule summary are corrected, a blank activity calendar id resolves to the project calendar, and the two validation entry points run from a plain clone.

Output changes

None of the public function signatures changed, but several results did, each from wrong to right:

• Finding check_ids are XER-* (XER-PROJECT-MISSING, XER-CALENDAR-MISSING, XER-NO-TASKPRED and the rest), no longer AACE-31R-03-*.
• Working-day counts and steps move on a finish-first calendar, on a worked exception day, for datetimes whose clock times differ, for half-day values, and for a zero-day step from a non-working day.
• generate_summary: loe_count no longer counts WBS summary rows, critical_activities is the complete list, and critical_path has no note key.
• validate_schedule raises the new activity-calendar findings.

Fixed

• Calendar time slots decode in either field order. P6 writes a slot as (s|08:00|f|16:00) or (f|16:00|s|08:00), per calendar. Finish-first calendars decoded to no working days and were counted as Mon-Fri, and their worked exception days were filed as holidays. With it:

  • worked exceptions separated from their date by P6's line markers are no longer holidays;
  • exception dates from 1970 to 2099 are kept (the window was 1990-2050);
  • a day carrying work hours is never also a holiday.

• Working-day arithmetic (get_work_days_between, add_work_days, subtract_work_days):

  • worked exception days (special_workdays) count;
  • both dates are read on their calendar day, so Friday 17:00 to Monday 08:00 counts both days, and a date compares with a datetime;
  • a span over 100 years returns None;
  • half-days round half-up;
  • a zero-day step snaps off a non-working day, as cpp-cpm-engine does.

  The add_work_days docstring now states the gap contract: EF = add_work_days(ES, D - 1).

• generate_xer collapses tabs and line breaks inside values, so a value can no longer shift or split its row.

• parse_xer keeps cells beyond a row's header under __extra_<column> keys.

• TABLE_ORDER writes the resource-code assignment table as RSRCRCAT, the header P6 writes, and drops a phantom RISKTYPES.

• generate_summary counts LOE and WBS summary rows separately (new wbs_count), adds a work-only completion (work_task_count, complete_work, percent_complete_work), and lists every critical activity.

• validate_schedule and aace_31r_compliance run from a plain clone.

Added

• Activity calendars:
  • resolve_task_calendars, with_resolved_calendars and calendar_resolution_block read a blank TASK.clndr_id as the project calendar, then the default calendar;
  • validate_schedule raises BLOCK XER-TASK-CALENDAR-UNRESOLVED and INFO XER-TASK-CALENDAR-FALLBACK;
  • generate_summary converts float on the resolved calendar;
  • get_calendar_map entries carry default_flag.

Changed

• README:
  • a Scope section states what this package does not include: a date-field gate, a calendar-decode warning channel, and working-day arithmetic beyond get_work_days_between / duration_hours_to_days;
  • the XER generation rules give the measured field counts (PROJECT 71, SCHEDOPTIONS 25, PROJWBS 26, TASK 61, TASKPRED 11 at P6 23.10 to 24.12) in place of 72/26/27/62/12;
  • the live test badge and a version badge replace the static "stable" badge.
• Validation findings cite the documents that govern them (AACE 29R-03, 38R-06, DCMA 14-Point #1), and seven finding messages are worded as sentences.
• references/table-reference.md documents both time-slot orders again.
• SECURITY.md supports 0.2.x.

Testing

• Tests: 100 across 10 files, all on synthetic data (15 across 2 files at v0.1.0).
• Engine parity: one test compares 6,490 add_work_days / subtract_work_days calls with cpp-cpm-engine v2.9.49. It runs when the engine's python_reference directory is on sys.path and skips otherwise.
• CI: 9/9 green on Linux, macOS and Windows with Python 3.10 to 3.12.

Full details: CHANGELOG.md.