From fa26e2005e3ef58f66edac89872d7ec99d301998 Mon Sep 17 00:00:00 2001
From: Vibby Febriyan Sakti <vibbyfs@gmail.com>
Date: Thu, 28 Aug 2025 12:26:32 +0700
Subject: [PATCH] chore(release): v0.1.0 (marker)

---
 .github/pull_request_template.md     |  6 ++++
 .github/workflows/linear-history.yml | 22 +++++++++++++++
 CHANGELOG.md                         |  6 ++++
 VERSION                              |  1 +
 docs/branching.md                    | 21 ++++++++++++++
 scripts/release/mark-main.sh         | 41 ++++++++++++++++++++++++++++
 scripts/release/release-from-dev.sh  | 22 +++++++++++++++
 scripts/release/setup-repo.sh        | 14 ++++++++++
 8 files changed, 133 insertions(+)
 create mode 100644 .github/pull_request_template.md
 create mode 100644 .github/workflows/linear-history.yml
 create mode 100644 CHANGELOG.md
 create mode 100644 VERSION
 create mode 100644 docs/branching.md
 create mode 100755 scripts/release/mark-main.sh
 create mode 100755 scripts/release/release-from-dev.sh
 create mode 100755 scripts/release/setup-repo.sh

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
new file mode 100644
index 0000000..07bb7d2
--- /dev/null
+++ b/.github/pull_request_template.md
@@ -0,0 +1,6 @@
+# Pull Request
+
+## Checklist
+- [ ] Target branch is correct (`development` for features, `main` only for releases)
+- [ ] For PRs targeting `main`, choose **Rebase and merge** or **Squash and merge**
+- [ ] No merge commits are present in this PR
diff --git a/.github/workflows/linear-history.yml b/.github/workflows/linear-history.yml
new file mode 100644
index 0000000..bddb7e1
--- /dev/null
+++ b/.github/workflows/linear-history.yml
@@ -0,0 +1,22 @@
+name: Enforce Linear History
+
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      - name: Ensure no merge commits
+        run: |
+          git fetch origin main
+          if [ -n "$(git rev-list --merges origin/main..HEAD)" ]; then
+            echo "Merge commits detected. Use Rebase/Squash.";
+            exit 1;
+          fi
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..1105e95
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,6 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## v0.1.0
+- release marker
diff --git a/VERSION b/VERSION
new file mode 100644
index 0000000..6e8bf73
--- /dev/null
+++ b/VERSION
@@ -0,0 +1 @@
+0.1.0
diff --git a/docs/branching.md b/docs/branching.md
new file mode 100644
index 0000000..b98dac9
--- /dev/null
+++ b/docs/branching.md
@@ -0,0 +1,21 @@
+# Branching and Release Workflow
+
+Default branch for this repository is `development`.
+All feature branches should open Pull Requests into `development` and be merged using **Squash and merge**.
+
+## Release process
+1. Create a Pull Request from `development` to `main`.
+2. On GitHub choose **Rebase and merge** or **Squash and merge**. Do **not** use merge commits and do not fast-forward from the CLI.
+3. After merging, run `scripts/release/mark-main.sh` on `main` to add a version marker commit.
+
+## Keeping history visible
+After a release do **not** reset or fast-forward `development` to `main`.
+If `development` needs the latest changes from `main`, merge `main` into `development` so the network graph shows the branching clearly.
+
+## Manual fallback
+If automation fails, create the release PR manually via the GitHub UI:
+- Base: `main`
+- Compare: `development`
+- Merge using **Rebase and merge** or **Squash and merge**
+
+This strategy keeps `main` linear and ensures every release is visible in the network graph.
diff --git a/scripts/release/mark-main.sh b/scripts/release/mark-main.sh
new file mode 100755
index 0000000..b95ca23
--- /dev/null
+++ b/scripts/release/mark-main.sh
@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+branch=$(git rev-parse --abbrev-ref HEAD)
+if [[ "$branch" != "main" ]]; then
+  echo "This script must run on main. Current: $branch" >&2
+  exit 1
+fi
+
+bump=""
+if [[ "${1:-}" == "--bump" ]]; then
+  bump="${2:-}"
+fi
+
+version=$(cat VERSION)
+IFS='.' read -r major minor patch <<<"$version"
+case "$bump" in
+  major)
+    ((major++)); minor=0; patch=0;;
+  minor)
+    ((minor++)); patch=0;;
+  patch)
+    ((patch++));;
+  "")
+    ;;
+  *)
+    echo "Unknown bump level: $bump" >&2
+    exit 1;
+    ;;
+esac
+new_version="${major}.${minor}.${patch}"
+echo "$new_version" > VERSION
+
+{
+  echo ""
+  echo "## v$new_version"
+  echo "- release marker"
+} >> CHANGELOG.md
+
+git add VERSION CHANGELOG.md
+git commit -m "chore(release): v$new_version (marker)"
diff --git a/scripts/release/release-from-dev.sh b/scripts/release/release-from-dev.sh
new file mode 100755
index 0000000..d697868
--- /dev/null
+++ b/scripts/release/release-from-dev.sh
@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ -n "$(git status --porcelain)" ]]; then
+  echo "Working tree is dirty." >&2
+  exit 1
+fi
+
+# Ensure local development branch is up to date
+git fetch origin development
+git checkout development
+git pull origin development
+
+gh pr create --base main --head development --fill
+
+gh pr merge --${MERGE_MODE:-rebase} --admin
+
+git checkout main
+git pull origin main
+"$(dirname "$0")/mark-main.sh"
+
+echo "Release complete."
diff --git a/scripts/release/setup-repo.sh b/scripts/release/setup-repo.sh
new file mode 100755
index 0000000..465e9d9
--- /dev/null
+++ b/scripts/release/setup-repo.sh
@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Configure merge options
+gh repo edit --allow-merge-commit=false --allow-rebase-merge=true --allow-squash-merge=true
+
+# Enable branch protection with linear history (requires admin token)
+read -r owner repo <<<"$(gh repo view --json owner,name -q '.owner.login + " " + .name')"
+
+gh api -X PUT repos/${owner}/${repo}/branches/main/protection --input - <<'JSON'
+{
+  "required_linear_history": true
+}
+JSON