{"abstract":"With WKST=SU a Sunday in the first week is miscounted and the end date shifts by a week.","category":"Calendar recurrence rules","checks":7,"contract":"For FREQ=WEEKLY;INTERVAL;BYDAY;WKST;COUNT starting at dtstart (weeks begin on wkst, days of the first week before dtstart are skipped, active weeks every interval weeks from the dtstart week), compute the date of the final instance arithmetically, without expanding. count < 1 returns None. The result must equal the last element of the full expansion.","evaluation_group":"w2-calendar-recurrence-rules-weekly-last-occurrence-closed-form","failed_approach":"The partial repair `(w - wkst) % 7 > (start.weekday() - wkst) % 7` uses a strict comparison and so excludes dtstart itself from the first week.","family":"w2-calendar-recurrence-rules-weekly-last-occurrence-closed-form-first-week-filter","id":"FA-77276","implementations":{"attempt":{"sha256":"25781d33abd10afc77ca323236add14e46c9d80516dfbe34af5c9ff7a211c96e","source":"\"\"\"Failure Map reference implementation. Python standard library only.\"\"\"\nimport json\nimport datetime as dt\nimport calendar\nN = 1\nobservations = []\ndef solve(dtstart, interval, byday, wkst, count):\n    start = dt.date.fromisoformat(dtstart)\n    if count < 1:\n        return None\n    days = sorted(set(byday), key=lambda w: (w - wkst) % 7)\n    week0 = start - dt.timedelta(days=(start.weekday() - wkst) % 7)\n    first_week = [w for w in days if (w - wkst) % 7 > (start.weekday() - wkst) % 7]\n    if count <= len(first_week):\n        w = first_week[count - 1]\n        weeks = 0\n    else:\n        rest = count - len(first_week)\n        weeks = (rest - 1) // len(days) + 1\n        w = days[(rest - 1) % len(days)]\n    last = week0 + dt.timedelta(days=weeks * interval * 7 + (w - wkst) % 7)\n    return last.isoformat()\ndef check(label, actual, expected):\n    observations.append({\"check\": label, \"actual\": actual, \"expected\": expected, \"passed\": actual == expected})\nfixtures = [[('regression: WKST=SU interval 2 TU,SU', ['1997-08-05', 2, [1, 6], 6, 4], '1997-08-31'),\n  ('WKST=MO interval 2 TU,SU', ['1997-08-05', 2, [1, 6], 0, 4], '1997-08-24'),\n  ('multiple of weekday count', ['2024-01-01', 1, [0, 2, 4], 0, 6], '2024-01-12'),\n  ('partial first week', ['2024-01-04', 1, [0, 2, 4], 0, 5], '2024-01-15'),\n  ('interval 3 single day', ['2024-05-06', 3, [4], 0, 3], '2024-06-21'),\n  ('count zero', ['2024-01-01', 1, [0], 0, 0], None),\n  ('count negative', ['2024-01-01', 2, [0, 3], 0, -1], None)],\n [('multiple of weekday count', ['2024-01-01', 1, [0, 2, 4], 0, 6], '2024-01-12'),\n  ('partial first week', ['2024-01-04', 1, [0, 2, 4], 0, 5], '2024-01-15'),\n  ('interval 3 single day', ['2024-05-06', 3, [4], 0, 3], '2024-06-21'),\n  ('count zero', ['2024-01-01', 1, [0], 0, 0], None),\n  ('count negative', ['2024-01-01', 2, [0, 3], 0, -1], None),\n  ('within first week', ['2024-01-01', 2, [0, 1, 2], 0, 2], '2024-01-02'),\n  ('WKST=SU weekend', ['2024-03-09', 1, [5, 6], 6, 5], '2024-03-23')],\n [('interval 3 single day', ['2024-05-06', 3, [4], 0, 3], '2024-06-21'),\n  ('count zero', ['2024-01-01', 1, [0], 0, 0], None),\n  ('count negative', ['2024-01-01', 2, [0, 3], 0, -1], None),\n  ('within first week', ['2024-01-01', 2, [0, 1, 2], 0, 2], '2024-01-02'),\n  ('WKST=SU weekend', ['2024-03-09', 1, [5, 6], 6, 5], '2024-03-23'),\n  ('WKST=WE interval 2', ['2024-06-04', 2, [0, 3], 2, 7], '2024-07-25'),\n  ('dtstart after all first-week days', ['2024-01-06', 2, [0, 1], 0, 5], '2024-02-12')],\n [('count negative', ['2024-01-01', 2, [0, 3], 0, -1], None),\n  ('within first week', ['2024-01-01', 2, [0, 1, 2], 0, 2], '2024-01-02'),\n  ('WKST=SU weekend', ['2024-03-09', 1, [5, 6], 6, 5], '2024-03-23'),\n  ('WKST=WE interval 2', ['2024-06-04', 2, [0, 3], 2, 7], '2024-07-25'),\n  ('dtstart after all first-week days', ['2024-01-06', 2, [0, 1], 0, 5], '2024-02-12'),\n  ('long series', ['2025-02-03', 2, [1, 3, 5], 0, 11], '2025-03-20'),\n  ('regression: WKST=SU interval 2 TU,SU', ['1997-08-05', 2, [1, 6], 6, 4], '1997-08-31')],\n [('WKST=SU weekend', ['2024-03-09', 1, [5, 6], 6, 5], '2024-03-23'),\n  ('WKST=WE interval 2', ['2024-06-04', 2, [0, 3], 2, 7], '2024-07-25'),\n  ('dtstart after all first-week days', ['2024-01-06', 2, [0, 1], 0, 5], '2024-02-12'),\n  ('long series', ['2025-02-03', 2, [1, 3, 5], 0, 11], '2025-03-20'),\n  ('regression: WKST=SU interval 2 TU,SU', ['1997-08-05', 2, [1, 6], 6, 4], '1997-08-31'),\n  ('WKST=MO interval 2 TU,SU', ['1997-08-05', 2, [1, 6], 0, 4], '1997-08-24'),\n  ('multiple of weekday count', ['2024-01-01', 1, [0, 2, 4], 0, 6], '2024-01-12')]]\nfor label, args, expected in fixtures[N-1]:\n    check(label, solve(*args), expected)\nprint(json.dumps({\"observations\": observations, \"passed\": all(x[\"passed\"] for x in observations)}, ensure_ascii=False))\nraise SystemExit(0 if all(x[\"passed\"] for x in observations) else 1)\n"},"broken":{"sha256":"3cefd099f8a300f835e35078b9b773e4224923f00d0ecc4c9fa72df337601978","source":"\"\"\"Failure Map reference implementation. Python standard library only.\"\"\"\nimport json\nimport datetime as dt\nimport calendar\nN = 1\nobservations = []\ndef solve(dtstart, interval, byday, wkst, count):\n    start = dt.date.fromisoformat(dtstart)\n    if count < 1:\n        return None\n    days = sorted(set(byday), key=lambda w: (w - wkst) % 7)\n    week0 = start - dt.timedelta(days=(start.weekday() - wkst) % 7)\n    first_week = [w for w in days if w >= start.weekday()]\n    if count <= len(first_week):\n        w = first_week[count - 1]\n        weeks = 0\n    else:\n        rest = count - len(first_week)\n        weeks = (rest - 1) // len(days) + 1\n        w = days[(rest - 1) % len(days)]\n    last = week0 + dt.timedelta(days=weeks * interval * 7 + (w - wkst) % 7)\n    return last.isoformat()\ndef check(label, actual, expected):\n    observations.append({\"check\": label, \"actual\": actual, \"expected\": expected, \"passed\": actual == expected})\nfixtures = [[('regression: WKST=SU interval 2 TU,SU', ['1997-08-05', 2, [1, 6], 6, 4], '1997-08-31'),\n  ('WKST=MO interval 2 TU,SU', ['1997-08-05', 2, [1, 6], 0, 4], '1997-08-24'),\n  ('multiple of weekday count', ['2024-01-01', 1, [0, 2, 4], 0, 6], '2024-01-12'),\n  ('partial first week', ['2024-01-04', 1, [0, 2, 4], 0, 5], '2024-01-15'),\n  ('interval 3 single day', ['2024-05-06', 3, [4], 0, 3], '2024-06-21'),\n  ('count zero', ['2024-01-01', 1, [0], 0, 0], None),\n  ('count negative', ['2024-01-01', 2, [0, 3], 0, -1], None)],\n [('multiple of weekday count', ['2024-01-01', 1, [0, 2, 4], 0, 6], '2024-01-12'),\n  ('partial first week', ['2024-01-04', 1, [0, 2, 4], 0, 5], '2024-01-15'),\n  ('interval 3 single day', ['2024-05-06', 3, [4], 0, 3], '2024-06-21'),\n  ('count zero', ['2024-01-01', 1, [0], 0, 0], None),\n  ('count negative', ['2024-01-01', 2, [0, 3], 0, -1], None),\n  ('within first week', ['2024-01-01', 2, [0, 1, 2], 0, 2], '2024-01-02'),\n  ('WKST=SU weekend', ['2024-03-09', 1, [5, 6], 6, 5], '2024-03-23')],\n [('interval 3 single day', ['2024-05-06', 3, [4], 0, 3], '2024-06-21'),\n  ('count zero', ['2024-01-01', 1, [0], 0, 0], None),\n  ('count negative', ['2024-01-01', 2, [0, 3], 0, -1], None),\n  ('within first week', ['2024-01-01', 2, [0, 1, 2], 0, 2], '2024-01-02'),\n  ('WKST=SU weekend', ['2024-03-09', 1, [5, 6], 6, 5], '2024-03-23'),\n  ('WKST=WE interval 2', ['2024-06-04', 2, [0, 3], 2, 7], '2024-07-25'),\n  ('dtstart after all first-week days', ['2024-01-06', 2, [0, 1], 0, 5], '2024-02-12')],\n [('count negative', ['2024-01-01', 2, [0, 3], 0, -1], None),\n  ('within first week', ['2024-01-01', 2, [0, 1, 2], 0, 2], '2024-01-02'),\n  ('WKST=SU weekend', ['2024-03-09', 1, [5, 6], 6, 5], '2024-03-23'),\n  ('WKST=WE interval 2', ['2024-06-04', 2, [0, 3], 2, 7], '2024-07-25'),\n  ('dtstart after all first-week days', ['2024-01-06', 2, [0, 1], 0, 5], '2024-02-12'),\n  ('long series', ['2025-02-03', 2, [1, 3, 5], 0, 11], '2025-03-20'),\n  ('regression: WKST=SU interval 2 TU,SU', ['1997-08-05', 2, [1, 6], 6, 4], '1997-08-31')],\n [('WKST=SU weekend', ['2024-03-09', 1, [5, 6], 6, 5], '2024-03-23'),\n  ('WKST=WE interval 2', ['2024-06-04', 2, [0, 3], 2, 7], '2024-07-25'),\n  ('dtstart after all first-week days', ['2024-01-06', 2, [0, 1], 0, 5], '2024-02-12'),\n  ('long series', ['2025-02-03', 2, [1, 3, 5], 0, 11], '2025-03-20'),\n  ('regression: WKST=SU interval 2 TU,SU', ['1997-08-05', 2, [1, 6], 6, 4], '1997-08-31'),\n  ('WKST=MO interval 2 TU,SU', ['1997-08-05', 2, [1, 6], 0, 4], '1997-08-24'),\n  ('multiple of weekday count', ['2024-01-01', 1, [0, 2, 4], 0, 6], '2024-01-12')]]\nfor label, args, expected in fixtures[N-1]:\n    check(label, solve(*args), expected)\nprint(json.dumps({\"observations\": observations, \"passed\": all(x[\"passed\"] for x in observations)}, ensure_ascii=False))\nraise SystemExit(0 if all(x[\"passed\"] for x in observations) else 1)\n"},"fixed":{"sha256":"5e3cc88b9e616003c941ed28c01fecfbe205d3c262a210332f6a838bda8f05bc","source":"\"\"\"Failure Map reference implementation. Python standard library only.\"\"\"\nimport json\nimport datetime as dt\nimport calendar\nN = 1\nobservations = []\ndef solve(dtstart, interval, byday, wkst, count):\n    start = dt.date.fromisoformat(dtstart)\n    if count < 1:\n        return None\n    days = sorted(set(byday), key=lambda w: (w - wkst) % 7)\n    week0 = start - dt.timedelta(days=(start.weekday() - wkst) % 7)\n    first_week = [w for w in days if (w - wkst) % 7 >= (start.weekday() - wkst) % 7]\n    if count <= len(first_week):\n        w = first_week[count - 1]\n        weeks = 0\n    else:\n        rest = count - len(first_week)\n        weeks = (rest - 1) // len(days) + 1\n        w = days[(rest - 1) % len(days)]\n    last = week0 + dt.timedelta(days=weeks * interval * 7 + (w - wkst) % 7)\n    return last.isoformat()\ndef check(label, actual, expected):\n    observations.append({\"check\": label, \"actual\": actual, \"expected\": expected, \"passed\": actual == expected})\nfixtures = [[('regression: WKST=SU interval 2 TU,SU', ['1997-08-05', 2, [1, 6], 6, 4], '1997-08-31'),\n  ('WKST=MO interval 2 TU,SU', ['1997-08-05', 2, [1, 6], 0, 4], '1997-08-24'),\n  ('multiple of weekday count', ['2024-01-01', 1, [0, 2, 4], 0, 6], '2024-01-12'),\n  ('partial first week', ['2024-01-04', 1, [0, 2, 4], 0, 5], '2024-01-15'),\n  ('interval 3 single day', ['2024-05-06', 3, [4], 0, 3], '2024-06-21'),\n  ('count zero', ['2024-01-01', 1, [0], 0, 0], None),\n  ('count negative', ['2024-01-01', 2, [0, 3], 0, -1], None)],\n [('multiple of weekday count', ['2024-01-01', 1, [0, 2, 4], 0, 6], '2024-01-12'),\n  ('partial first week', ['2024-01-04', 1, [0, 2, 4], 0, 5], '2024-01-15'),\n  ('interval 3 single day', ['2024-05-06', 3, [4], 0, 3], '2024-06-21'),\n  ('count zero', ['2024-01-01', 1, [0], 0, 0], None),\n  ('count negative', ['2024-01-01', 2, [0, 3], 0, -1], None),\n  ('within first week', ['2024-01-01', 2, [0, 1, 2], 0, 2], '2024-01-02'),\n  ('WKST=SU weekend', ['2024-03-09', 1, [5, 6], 6, 5], '2024-03-23')],\n [('interval 3 single day', ['2024-05-06', 3, [4], 0, 3], '2024-06-21'),\n  ('count zero', ['2024-01-01', 1, [0], 0, 0], None),\n  ('count negative', ['2024-01-01', 2, [0, 3], 0, -1], None),\n  ('within first week', ['2024-01-01', 2, [0, 1, 2], 0, 2], '2024-01-02'),\n  ('WKST=SU weekend', ['2024-03-09', 1, [5, 6], 6, 5], '2024-03-23'),\n  ('WKST=WE interval 2', ['2024-06-04', 2, [0, 3], 2, 7], '2024-07-25'),\n  ('dtstart after all first-week days', ['2024-01-06', 2, [0, 1], 0, 5], '2024-02-12')],\n [('count negative', ['2024-01-01', 2, [0, 3], 0, -1], None),\n  ('within first week', ['2024-01-01', 2, [0, 1, 2], 0, 2], '2024-01-02'),\n  ('WKST=SU weekend', ['2024-03-09', 1, [5, 6], 6, 5], '2024-03-23'),\n  ('WKST=WE interval 2', ['2024-06-04', 2, [0, 3], 2, 7], '2024-07-25'),\n  ('dtstart after all first-week days', ['2024-01-06', 2, [0, 1], 0, 5], '2024-02-12'),\n  ('long series', ['2025-02-03', 2, [1, 3, 5], 0, 11], '2025-03-20'),\n  ('regression: WKST=SU interval 2 TU,SU', ['1997-08-05', 2, [1, 6], 6, 4], '1997-08-31')],\n [('WKST=SU weekend', ['2024-03-09', 1, [5, 6], 6, 5], '2024-03-23'),\n  ('WKST=WE interval 2', ['2024-06-04', 2, [0, 3], 2, 7], '2024-07-25'),\n  ('dtstart after all first-week days', ['2024-01-06', 2, [0, 1], 0, 5], '2024-02-12'),\n  ('long series', ['2025-02-03', 2, [1, 3, 5], 0, 11], '2025-03-20'),\n  ('regression: WKST=SU interval 2 TU,SU', ['1997-08-05', 2, [1, 6], 6, 4], '1997-08-31'),\n  ('WKST=MO interval 2 TU,SU', ['1997-08-05', 2, [1, 6], 0, 4], '1997-08-24'),\n  ('multiple of weekday count', ['2024-01-01', 1, [0, 2, 4], 0, 6], '2024-01-12')]]\nfor label, args, expected in fixtures[N-1]:\n    check(label, solve(*args), expected)\nprint(json.dumps({\"observations\": observations, \"passed\": all(x[\"passed\"] for x in observations)}, ensure_ascii=False))\nraise SystemExit(0 if all(x[\"passed\"] for x in observations) else 1)\n"}},"limitations":"Stipulated, bounded recurrence-expansion model evaluated offline on explicit fixtures; it is not a complete iCalendar implementation and makes no claim of standards conformance. This reproducer isolates one failure mechanism. Results cover the supplied fixtures. Variants within a family share a test contract and should remain grouped when constructing evaluation splits. Related mechanisms with a shared evaluation_group must also remain together; these controlled models are not independent production incidents.","method":"Deterministic executable model with adversarial boundary fixtures.","provenance":{"created_by":"Failure Map","dependencies":"Python standard library","family":"w2-calendar-recurrence-rules-weekly-last-occurrence-closed-form-first-week-filter","generated_at":"2026-09-29T14:49:23.953508+00:00","license":"CC0-1.0","python":"3.12.14","seed":1,"split":"open-access"},"relevance":"Recurring calendar series are expanded into concrete instances for display, reminders and conflict checks.","repair":"At the first week filter decision use `(w - wkst) % 7 >= (start.weekday() - wkst) % 7`, leaving the other decision sites of the model unchanged.","root_cause":"The partial first week is computed with Monday-based weekday numbers.","sha256":"fdb18f5e27fe881b7137f9afc542760ab1c5878a1d57489fa03a1bf3bc5eae14","title":"Closed-form final date of a COUNT-limited weekly BYDAY series: first week filter · case 01","variant":1,"variant_policy":"Five numbered records share a model and may reuse boundary fixtures.","verification":{"attempt":{"elapsed_ms":42.755,"exit_code":1,"observations":[{"actual":"1997-09-02","check":"regression: WKST=SU interval 2 TU,SU","expected":"1997-08-31","passed":false},{"actual":"1997-09-02","check":"WKST=MO interval 2 TU,SU","expected":"1997-08-24","passed":false},{"actual":"2024-01-15","check":"multiple of weekday count","expected":"2024-01-12","passed":false},{"actual":"2024-01-15","check":"partial first week","expected":"2024-01-15","passed":true},{"actual":"2024-06-21","check":"interval 3 single day","expected":"2024-06-21","passed":true},{"actual":null,"check":"count zero","expected":null,"passed":true},{"actual":null,"check":"count negative","expected":null,"passed":true}],"passed":false,"stderr":"","stdout":"{\"observations\": [{\"check\": \"regression: WKST=SU interval 2 TU,SU\", \"actual\": \"1997-09-02\", \"expected\": \"1997-08-31\", \"passed\": false}, {\"check\": \"WKST=MO interval 2 TU,SU\", \"actual\": \"1997-09-02\", \"expected\": \"1997-08-24\", \"passed\": false}, {\"check\": \"multiple of weekday count\", \"actual\": \"2024-01-15\", \"expected\": \"2024-01-12\", \"passed\": false}, {\"check\": \"partial first week\", \"actual\": \"2024-01-15\", \"expected\": \"2024-01-15\", \"passed\": true}, {\"check\": \"interval 3 single day\", \"actual\": \"2024-06-21\", \"expected\": \"2024-06-21\", \"passed\": true}, {\"check\": \"count zero\", \"actual\": null, \"expected\": null, \"passed\": true}, {\"check\": \"count negative\", \"actual\": null, \"expected\": null, \"passed\": true}], \"passed\": false}\n"},"broken":{"elapsed_ms":39.65,"exit_code":1,"observations":[{"actual":"1997-08-19","check":"regression: WKST=SU interval 2 TU,SU","expected":"1997-08-31","passed":false},{"actual":"1997-08-24","check":"WKST=MO interval 2 TU,SU","expected":"1997-08-24","passed":true},{"actual":"2024-01-12","check":"multiple of weekday count","expected":"2024-01-12","passed":true},{"actual":"2024-01-15","check":"partial first week","expected":"2024-01-15","passed":true},{"actual":"2024-06-21","check":"interval 3 single day","expected":"2024-06-21","passed":true},{"actual":null,"check":"count zero","expected":null,"passed":true},{"actual":null,"check":"count negative","expected":null,"passed":true}],"passed":false,"stderr":"","stdout":"{\"observations\": [{\"check\": \"regression: WKST=SU interval 2 TU,SU\", \"actual\": \"1997-08-19\", \"expected\": \"1997-08-31\", \"passed\": false}, {\"check\": \"WKST=MO interval 2 TU,SU\", \"actual\": \"1997-08-24\", \"expected\": \"1997-08-24\", \"passed\": true}, {\"check\": \"multiple of weekday count\", \"actual\": \"2024-01-12\", \"expected\": \"2024-01-12\", \"passed\": true}, {\"check\": \"partial first week\", \"actual\": \"2024-01-15\", \"expected\": \"2024-01-15\", \"passed\": true}, {\"check\": \"interval 3 single day\", \"actual\": \"2024-06-21\", \"expected\": \"2024-06-21\", \"passed\": true}, {\"check\": \"count zero\", \"actual\": null, \"expected\": null, \"passed\": true}, {\"check\": \"count negative\", \"actual\": null, \"expected\": null, \"passed\": true}], \"passed\": false}\n"},"fixed":{"elapsed_ms":40.13,"exit_code":0,"observations":[{"actual":"1997-08-31","check":"regression: WKST=SU interval 2 TU,SU","expected":"1997-08-31","passed":true},{"actual":"1997-08-24","check":"WKST=MO interval 2 TU,SU","expected":"1997-08-24","passed":true},{"actual":"2024-01-12","check":"multiple of weekday count","expected":"2024-01-12","passed":true},{"actual":"2024-01-15","check":"partial first week","expected":"2024-01-15","passed":true},{"actual":"2024-06-21","check":"interval 3 single day","expected":"2024-06-21","passed":true},{"actual":null,"check":"count zero","expected":null,"passed":true},{"actual":null,"check":"count negative","expected":null,"passed":true}],"passed":true,"stderr":"","stdout":"{\"observations\": [{\"check\": \"regression: WKST=SU interval 2 TU,SU\", \"actual\": \"1997-08-31\", \"expected\": \"1997-08-31\", \"passed\": true}, {\"check\": \"WKST=MO interval 2 TU,SU\", \"actual\": \"1997-08-24\", \"expected\": \"1997-08-24\", \"passed\": true}, {\"check\": \"multiple of weekday count\", \"actual\": \"2024-01-12\", \"expected\": \"2024-01-12\", \"passed\": true}, {\"check\": \"partial first week\", \"actual\": \"2024-01-15\", \"expected\": \"2024-01-15\", \"passed\": true}, {\"check\": \"interval 3 single day\", \"actual\": \"2024-06-21\", \"expected\": \"2024-06-21\", \"passed\": true}, {\"check\": \"count zero\", \"actual\": null, \"expected\": null, \"passed\": true}, {\"check\": \"count negative\", \"actual\": null, \"expected\": null, \"passed\": true}], \"passed\": true}\n"}},"verified":true,"visibility":"public"}