Scripts
Operational shell scripts in the scripts/ directory supporting development, CI, and repository management.
Build and Quality
| Script | Purpose |
|---|
scripts/quality-checks-parallel.sh | Parallel typecheck + lint + test (used by Makefile Commands) |
scripts/check-changelog.sh | Validate bilingual changelog fragments (see Git Workflow) |
scripts/compile-changelog.sh | Build release changelog from fragments |
scripts/check-migration-consistency.sh | Validate migration ordering and integrity |
scripts/check-english-identifiers.sh | Enforce English naming in code (see Coding Guidelines) |
scripts/validate-localized-text.sh | Validate LocalizedText patterns in schema |
Git Hooks
Located in scripts/git-hooks/:
| Hook | Phase | Checks |
|---|
pre-commit | Before commit (~5s) | Format, lint staged files, i18n parity, LocalizedText, migration consistency, block main |
pre-push | Before push (thorough) | Conflict check, changelog fragments, full typecheck, affected tests |
post-checkout | After checkout | Dependency sync reminders |
post-merge | After merge | Dependency sync reminders |
Installed via scripts/setup-git-hooks.sh. See Git Workflow for the two-tier hook strategy.
Repository Management
| Script | Purpose |
|---|
scripts/cleanup-merged-worktrees.sh | Clean stale worktrees (--dry-run to preview, --auto for no-prompt) |
scripts/guard-root-dir.sh | Protect root repo from accidental commits |
scripts/verify-root-clean.sh | Verify clean working directory |
scripts/allocate-dev-ports.sh | Deterministic port allocation per worktree (range 10000-19999, see Docker Setup) |
scripts/issue-to-worktree.sh | Quick start: issue number → worktree + branch + make dev-init |
Infrastructure
| Script | Purpose |
|---|
scripts/manage-entra-redirect-uri.sh | Azure Entra ID SSO redirect URI management (see Authentication) |
Project Management
| Script | Purpose |
|---|
scripts/linear/linear-api.sh | Linear API operations |
scripts/linear/batch-wsjf-score.sh | Batch WSJF scoring for Linear issues |
scripts/linear/update-deployment-status.sh | Update Linear deployment status |
scripts/jira-import.ts | Import data from Jira |
Usage Examples
# Create worktree from issue
./scripts/issue-to-worktree.sh 123 "add-payment-flow"
# Preview worktree cleanup
./scripts/cleanup-merged-worktrees.sh --dry-run
# Auto-cleanup without prompts
./scripts/cleanup-merged-worktrees.sh --auto
# Install git hooks
./scripts/setup-git-hooks.sh
Key Directories
scripts/ — top-level operational scriptsscripts/git-hooks/ — git hook implementationsscripts/linear/ — Linear project management integration
See Also