{"id":26553956,"url":"https://github.com/hacknlove/timecop","last_synced_at":"2025-07-30T19:39:05.115Z","repository":{"id":282411714,"uuid":"948503788","full_name":"hacknlove/timecop","owner":"hacknlove","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-14T13:32:10.000Z","size":136,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-14T14:23:09.797Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hacknlove.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-14T13:02:50.000Z","updated_at":"2025-03-14T13:32:14.000Z","dependencies_parsed_at":"2025-03-14T14:23:14.478Z","dependency_job_id":"51715ba0-50c7-4c03-a2cd-bff5195958c3","html_url":"https://github.com/hacknlove/timecop","commit_stats":null,"previous_names":["hacknlove/timecop"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hacknlove%2Ftimecop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hacknlove%2Ftimecop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hacknlove%2Ftimecop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hacknlove%2Ftimecop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hacknlove","download_url":"https://codeload.github.com/hacknlove/timecop/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244937747,"owners_count":20535124,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2025-03-22T09:36:28.288Z","updated_at":"2025-07-30T19:39:05.093Z","avatar_url":"https://github.com/hacknlove.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TimeCop\n\nA GitHub Action that enforces PR merge requirements based on dependencies and dates. It prevents PRs from being merged until:\n\n- All dependent PRs are merged\n- The specified release date/time has been reached\n\n## Quick Start\n\n```yaml\n# .github/workflows/timecop.yml\nname: TimeCop Check\non:\n  pull_request:\n    types: [opened, reopened, edited, labeled, unlabeled, synchronize]\n\njobs:\n  check-requirements:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: hacknlove/timecop@v1\n      with:\n        # Optional: GitHub token for higher rate limits and private repo access\n        github-token: ${{ secrets.GITHUB_TOKEN }}\n```\n\n## Authentication\n\nTimeCop can work with or without a GitHub token:\n\n- **Without Token**: Works for public repositories with lower rate limits (60 requests/hour)\n- **With Token**: Higher rate limits (5,000 requests/hour) and access to private repositories\n\nWe recommend using a token in production for better reliability.\n\n## Setting Requirements\n\nRequirements can be specified in three ways (in order of priority):\n\n### 1. Labels (Highest Priority)\n\n```\nafter: 2024-01-15\nmerged: https://github.com/org/repo/pull/123\n```\n\n### 2. PR Description\n\n```\n## MERGE REQUIREMENTS:\n* after: 2024-01-15\n* after: https://github.com/org/repo/pull/123\n* after: https://github.com/org/repo/pull/456\n```\n\nYou can also use tags in the description:\n```\n[after: 2024-01-15]\n[after: https://github.com/org/repo/pull/123]\n```\n\n### 3. Commit Messages (Lowest Priority)\n\n```\nfeat: implement new feature\n\n## MERGE REQUIREMENTS:\n* after: 2024-01-15\n* after: https://github.com/org/repo/pull/123\n```\n\nYou can also use tags in commit messages:\n```\nfeat: implement new feature [after: 2024-01-15] [after: https://github.com/org/repo/pull/123]\n```\n\n## Requirements Format\n\n### Date Requirements\n\n- Format: `after: YYYY-MM-DD` or `after: YYYY-MM-DD HH:MM`\n- Times are in UTC if not specified\n- Only the highest priority date is used\n- Earlier dates from lower priority sources are ignored\n\n### Dependency Requirements\n\n- Format: `merged: \u003cPR_URL\u003e`\n- Must be a valid GitHub PR URL\n- All dependencies are combined from all sources\n- PRs must be accessible to the action\n\n## Behavior\n\n- 🔄 Checks all sources for requirements\n- 📅 Blocks merging until date requirements are met\n- 🔗 Ensures all dependent PRs are merged\n- ❌ Fails with clear error messages when requirements aren't met\n\n## Examples\n\n### Release Date Only\n\n```\n## MERGE REQUIREMENTS:\n* after: 2024-01-15 14:30\n```\n\n### Dependencies Only\n\n```\n## MERGE REQUIREMENTS:\n* merged: https://github.com/org/repo/pull/123\n* merged: https://github.com/org/repo/pull/456\n```\n\n### Combined Requirements\n\n```\n## MERGE REQUIREMENTS:\n* after: 2024-01-15\n* merged: https://github.com/org/repo/pull/123\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhacknlove%2Ftimecop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhacknlove%2Ftimecop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhacknlove%2Ftimecop/lists"}