feat(discipline): add parkinsons law task time-box compression factor calculator (#618) by Aryan9891 · Pull Request #625 · TheVicky1/Pact_OS · GitHub
Skip to content

feat(discipline): add parkinsons law task time-box compression factor calculator (#618) - #625

Merged
TheVicky1 merged 1 commit into
TheVicky1:mainfrom
Aryan9891:feat/discipline-parkinsons-law
Oct 19, 2026
Merged

TheVicky1 merged 1 commit into
TheVicky1:mainfrom
Aryan9891:feat/discipline-parkinsons-law

Conversation

@Aryan9891

Copy link
Copy Markdown
Contributor

Summary

Implements a task time-box compression calculator in src/lib/discipline/parkinsons-law.ts that combats Parkinson's Law ("work expands to fill the time allotted for its completion") by calculating structured, urgency-driven compressed sprint durations and checkpoint milestones for task execution.

Key Features

  • Complexity-Based Compression:
    • 'trivial': 0.60 factor (40% reduction)
    • 'moderate': 0.70 factor (30% reduction)
    • 'complex': 0.80 factor (20% reduction)
    • 'epic': 0.85 factor (15% reduction)
  • Urgency Modifiers:
    • 'high': Tightens compression factor by -0.05
    • 'low': Relaxes compression factor by +0.05
    • 'medium': Baseline factor (0.00 modifier)
  • Minimum Viable Focus Block Guard:
    • Never compresses below 15 minutes unless the original estimate was already under 15 minutes.
  • Sprint Format Classification:
    • <= 20m -> 'micro_sprint_15'
    • 21m - 35m -> 'pomodoro_25'
    • 36m - 70m -> 'sprint_50'
    • > 70m -> 'deep_block_90'
  • Checkpoint Milestones Generator:
    • generateSprintMilestones(compressedMinutes): Generates disciplined milestone checkpoints at 25%, 50%, 75%, and 100% of sprint time.

Verification & Test Results

  • Added tests/parkinsons-law.test.ts with 10 authoritative unit tests.
  • node scratch/run-tests.mjs parkinsons-law.test.ts -> 10 passed, 0 failed.
  • npm run typecheck -> 0 errors.

Resolves #618

@Aryan9891
Aryan9891 requested a review from TheVicky1 as a code owner October 18, 2026 20:21
@vercel

vercel Bot commented Oct 18, 2026

Copy link
Copy Markdown

@TheVicky1
TheVicky1 merged commit 9a9c0ba into TheVicky1:main Oct 19, 2026
3 of 4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Discipline] Add Parkinson's Law Task Time-Box Compression Factor Calculator in src/lib/discipline/parkinsons-law.ts

2 participants