{"id":50851992,"url":"https://github.com/rodmena-limited/scriptplan","last_synced_at":"2026-06-14T14:04:27.359Z","repository":{"id":326490906,"uuid":"1104974596","full_name":"rodmena-limited/scriptplan","owner":"rodmena-limited","description":"Mission Critical Advanced Scheduling (ALAP/ASAP) System | Minute-level accuracy for resource allocation and dependency management.","archived":false,"fork":false,"pushed_at":"2025-12-21T04:23:20.000Z","size":2264,"stargazers_count":21,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-14T14:03:44.393Z","etag":null,"topics":["airport-management","airport-timetable","project-management","resource-allocation","resource-allocation-algorithm","resource-management","schedule","scheduler","scheduling-algorithms","taskjuggler","taskjuggler-python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rodmena-limited.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-27T00:44:05.000Z","updated_at":"2026-03-13T03:41:11.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/rodmena-limited/scriptplan","commit_stats":null,"previous_names":["rodmena-limited/scriptplan"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/rodmena-limited/scriptplan","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rodmena-limited%2Fscriptplan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rodmena-limited%2Fscriptplan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rodmena-limited%2Fscriptplan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rodmena-limited%2Fscriptplan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rodmena-limited","download_url":"https://codeload.github.com/rodmena-limited/scriptplan/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rodmena-limited%2Fscriptplan/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34324004,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["airport-management","airport-timetable","project-management","resource-allocation","resource-allocation-algorithm","resource-management","schedule","scheduler","scheduling-algorithms","taskjuggler","taskjuggler-python"],"created_at":"2026-06-14T14:04:26.688Z","updated_at":"2026-06-14T14:04:27.354Z","avatar_url":"https://github.com/rodmena-limited.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/rodmena-limited/scriptplan/main/icons/logo.svg\" alt=\"ScriptPlan\" width=\"400\"/\u003e\n\u003c/p\u003e\n\n# ScriptPlan\n\n![Logic Certified](https://img.shields.io/badge/Logic-Certified_Airport--Grade-success?style=for-the-badge\u0026logo=github)\n![Tests Passed](https://img.shields.io/badge/Stress_Tests-24%2F24_Passed-success?style=for-the-badge)\n![Temporal Physics](https://img.shields.io/badge/Temporal_Physics-Verified-blue?style=for-the-badge)\n![Scheduling](https://img.shields.io/badge/Scheduling-ALAP_%7C_JIT_%7C_Priority-blueviolet?style=for-the-badge)\n![Constraints](https://img.shields.io/badge/Constraints-Hard_Limits_%7C_Quotas-orange?style=for-the-badge)\n\nA precise project scheduling engine with minute-level accuracy for resource allocation and dependency management. The syntax is compatible with TaskJuggler (.tjp files).\n\n## Installation\n\n```bash\npip install scriptplan\n```\n\n## Quick Start\n\n### Report Generation (Unix-style)\n\n```bash\n# Generate JSON report to stdout\nplan report project.tjp\n\n# Generate CSV report\nplan report --csv project.tjp\n\n# Save to file\nplan report project.tjp \u003e output.json\nplan report --csv project.tjp \u003e output.csv\n\n# Read from stdin\ncat project.tjp | plan report\nplan report - \u003c project.tjp\n\n# Pipe to other tools\nplan report project.tjp | jq '.data[0]'\nplan report --csv project.tjp | csvkit\n\n# Process multiple files\nfor f in projects/*.tjp; do\n  plan report \"$f\" | jq -r '.report_id'\ndone\n```\n\n**Output Format** (JSON):\n```json\n{\n  \"data\": [\n    {\n      \"id\": \"project.task1\",\n      \"start\": \"2024-01-01-09:00\",\n      \"end\": \"2024-01-05-17:00\"\n    }\n  ],\n  \"columns\": [\"id\", \"start\", \"end\"],\n  \"report_id\": \"ea3f901dd6426dfa58288d945819c75485fd9ff1875db59def350f219e2d62ca\"\n}\n```\n\n**Features**:\n- Output to stdout (Unix philosophy)\n- Messages to stderr\n- SHA256 report_id (content-based hash)\n- Lowercase column names\n- No HTML metadata\n- No file pollution (uses temp directories)\n- Safe for concurrent execution (100+ instances)\n\n### Python API\n\n```python\nfrom scriptplan.parser.tjp_parser import ProjectFileParser\n\nparser = ProjectFileParser()\nproject = parser.parse(open('project.tjp').read())\n\n# Access scheduled tasks\nfor task in project.tasks:\n    if task.leaf():\n        start = task.get('start', 0)\n        end = task.get('end', 0)\n        print(f\"{task.id}: {start} -\u003e {end}\")\n```\n\n## System Certified\n\n**Certification Level**: Airport-Grade / Mission Critical\n\n**Capabilities Verified**:\n\n- **Temporal Physics**: Floating point precision, Timezones, DST awareness, Date Line crossing.\n\n- **Resource Constraints**: Daily/Weekly limits, Hierarchical quotas, Shift intersections.\n\n- **Advanced Scheduling**: ALAP (Backward pass), Priority preemption, Smart Resource Selection (Failover).\n\n- **Workflow Logic**: Atomicity (Contiguous), Perishability (Max Gap), Zero-Buffer Synchronization.\n\n## Features\n\n- Minute-level scheduling precision\n- ASAP and ALAP scheduling modes\n- Resource allocation with contention handling\n- Working hours and shift definitions\n- Dependency chains with gap constraints\n- Leap year and timezone handling\n\n## Accuracy\n\nScriptPlan uses integer arithmetic for all time calculations, avoiding floating-point drift. The scheduler correctly handles:\n\n- Non-standard shift boundaries (e.g., 08:13 - 11:59, 13:07 - 17:47)\n- Prime-number effort durations with prime-number gaps\n- Resource contention across multi-day tasks\n- Calendar gaps (weekends, holidays) vs working time gaps\n\nExample: A chain of 500 tasks, each with 73-minute effort and 29-minute gaps, scheduled across leap year boundaries with non-standard shifts, produces exact minute-aligned results.\n\n## Example Project\n\n```\nproject \"Manufacturing\" 2025-07-01 +1m {\n  timezone \"Etc/UTC\"\n  timeformat \"%Y-%m-%d %H:%M\"\n  scheduling alap\n}\n\nshift factory_hours \"Factory Hours\" {\n  workinghours mon - fri 08:00 - 16:00\n}\n\nresource machine \"Press\" {\n  workinghours factory_hours\n}\n\ntask delivery \"Product Launch\" {\n  end 2025-07-18-16:00\n\n  task pack \"Packaging\" {\n    effort 8h\n    allocate machine\n  }\n\n  task assemble_b \"Body Assembly\" {\n    effort 16h\n    allocate machine\n    depends !!pack { onstart }\n  }\n\n  task assemble_a \"Engine Assembly\" {\n    effort 16h\n    allocate machine\n  }\n}\n\ntask connection_setup \"Logic\" {\n  task set_deps \"Apply\" {\n    depends !delivery.assemble_a, !delivery.assemble_b\n    precedes !delivery.pack\n  }\n}\n\ntaskreport output \"output\" {\n  formats csv\n  columns id, start, end\n  timeformat \"%Y-%m-%d-%H:%M\"\n}\n```\n\nThis project schedules backward from the delivery deadline (ALAP mode). The scheduler:\n\n1. Anchors packaging to end at 16:00 on July 18\n2. Schedules both assembly tasks to complete before packaging starts\n3. Resolves resource contention (single machine) by sequencing assemblies back-to-back\n4. Respects weekend boundaries (Mon-Fri working hours)\n\nResult:\n```\ndelivery.pack:       2025-07-18-08:00 -\u003e 2025-07-18-16:00\ndelivery.assemble_a: 2025-07-14-08:00 -\u003e 2025-07-15-16:00\ndelivery.assemble_b: 2025-07-16-08:00 -\u003e 2025-07-17-16:00\n```\n\n## License\n\nApache-2.0\n\n## Acknowledgments\n\nScriptPlan references [TaskJuggler](https://taskjuggler.org/) solely for **file format compatibility**. We have not used, modified, or copied any TaskJuggler source code. ScriptPlan is an independent, clean-room implementation.\n\n- The `.tjp` file format is documented publicly and widely used in the project management community\n- All scheduling algorithms, parser, and report generation in ScriptPlan are original implementations\n- TaskJuggler is mentioned only to indicate that ScriptPlan can read the same project file format\n\nIf you're looking for the original TaskJuggler with its full feature set including interactive HTML reports and GUI tools, please visit [taskjuggler.org](https://taskjuggler.org/).\n\n## Why ScriptPlan?\n\nThis scheduler is part of Highway Workflow Engine's worker capacity management system. I decided to open-source it for the community to benefit from its precise scheduling capabilities. Thanks to TaskJuggler's established syntax, users can easily adopt ScriptPlan without learning a new format.\n\nYours,\nFarshid.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frodmena-limited%2Fscriptplan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frodmena-limited%2Fscriptplan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frodmena-limited%2Fscriptplan/lists"}