প্রথম Git repository — init, add, commit আর তিনটি এলাকা

১ · git init — একটি সাধারণ ফোল্ডার থেকে repository

পর্ব ০৭-এ (version control আর Git setup) আপনি Git install করেছেন আর নিজের নাম-email সেট করেছেন। এবার আসল কাজ। এই পর্বে আমরা একটি কাল্পনিক অনলাইন বাজার অ্যাপের ছোট একটি project শুরু করব — নাম bazar. শুরুতে এটি একটি সাধারণ ফোল্ডার। Git জানেই না এর অস্তিত্ব আছে।

একটি ফোল্ডারকে Git-এর repository বানানোর command একটিই: git init. Repository মানে সেই জায়গা, যেখানে project-এর সব file আর তাদের পুরো পরিবর্তনের ইতিহাস জমা থাকে। নিচের সব আউটপুট এই পর্বের জন্য একটি খালি scratch ফোল্ডারে আসল Git ২.৫৩ চালিয়ে নেওয়া; লম্বা path আমরা … দিয়ে ছোট করেছি।

$ git init -b main bazar
Initialized empty Git repository in …/bazar/.git/
$ cd bazar
$ git config user.name "Rahim"
$ git config user.email "rahim@example.com"
$ git config core.autocrlf false
$ ls -A
.git
$ ls .git
HEAD
config
description
hooks
info
objects
refs
$ git status
On branch main

No commits yet

nothing to commit (create/copy files and use "git add" to track)

তিনটি জিনিস খেয়াল করুন। এক, git init-এর পরে ফোল্ডারে দৃশ্যমান কিছুই বদলায়নি; শুধু একটি লুকানো .git ফোল্ডার এসেছে (Linux ও macOS-এ নাম ডট দিয়ে শুরু হলে সেটি লুকানো থাকে, তাই ls -A লাগল)। দুই, git status বলছে No commits yet — repository আছে, কিন্তু ইতিহাস এখনো শূন্য। তিন, আমরা user.name আর user.email শুধু এই repository-র জন্য সেট করেছি; নিজের কম্পিউটারে সাধারণত পর্ব ০৭-এর মতো --global দিয়ে একবারই সেট করা হয়। শেষ লাইনের core.autocrlf false শুধু এই উদাহরণের জন্য — Windows আর Linux-এ line ending-এর সতর্কবার্তা যাতে আলাদা না দেখায় (বিস্তারিত পর্ব ১০-এ)।

.git ফোল্ডারে কী থাকে — মোটা দাগে

.git ফোল্ডারটিই আসল repository. আপনার project ফোল্ডারের বাকি সবকিছু শুধু “এখন যে কপিতে কাজ চলছে”। ভেতরের নামগুলোর মোটামুটি অর্থ:

-b main কেন — প্রথম branch-এর নাম

প্রতিটি repository একটি branch দিয়ে শুরু হয় — branch মানে কাজের একটি ধারা, যার বিস্তারিত পর্ব ১২-এ (branch আর HEAD). কোনো সেটিং না থাকলে Git ২.৫৩ প্রথম branch-এর নাম রাখে master, আর সাথে একটি লম্বা পরামর্শ দেখায়:

$ git init demo-plain
hint: Using 'master' as the name for the initial branch. This default branch name
hint: will change to "main" in Git 3.0. To configure the initial branch name
hint: to use in all of your new repositories, which will suppress this warning,
hint: call:
hint:
hint: 	git config --global init.defaultBranch <name>
…
Initialized empty Git repository in …/demo-plain/.git/

বার্তাটি নিজেই বলছে, Git ৩.০-তে এই default branch-এর নাম main হবে। বড় hosting platform-গুলোও লেখার সময়ে নতুন repository-তে main ব্যবহার করে। দুই উপায়ে আগেই main বেছে নিতে পারেন: প্রতিবার git init -b main (পুরো রূপ --initial-branch=main), অথবা একবার git config --global init.defaultBranch main. দুটোই Git ২.২৮ (২০২০) থেকে আছে; এর আগের Git-এ init-এর পরে git branch -m main দিয়ে নাম বদলাতে হতো। নামটি শুধু একটি লেবেল — master নামেও Git একই রকম কাজ করে।

২ · তিনটি এলাকা — খসড়া খাতা, বাছাই করা পাতা আর ফেয়ার কপি

Git শেখার সবচেয়ে গুরুত্বপূর্ণ ধারণা এটিই। এটি বুঝলে পরের সব command — diff, restore, reset — অনেক সহজ হয়ে যায়।

• Working tree (খসড়া খাতা): আপনার project ফোল্ডারের সাধারণ file — editor-এ যেগুলো খোলেন আর বদলান। Git এগুলো দেখে, কিন্তু নিজে থেকে কিছু জমা রাখে না।
• Staging area বা index (বাছাই করা পাতা): পরের commit-টি ঠিক কেমন হবে, তার একটি প্রস্তুত তালিকা — প্রতিটি file-এর কোন version যাবে। এটি .git/index নামের একটি file.
• Repository (জমা দেওয়া খাতা): .git-এর ভেতরে সব commit. HEAD দেখায় এখন কোন commit-এর ওপর আপনি দাঁড়িয়ে আছেন — সাধারণত বর্তমান branch-এর শেষ commit.

কথাটি কোডে দেখা যাক। নিচের ছোট মডেলে তিনটি file-এর জন্য তিনটি এলাকা রাখা আছে — W (working tree), I (index), H (HEAD commit). add ফোল্ডার থেকে index-এ কপি করে, commit পুরো index কপি করে। প্রতি ধাপে প্রতিটি file-এর পাশে git status -s-এর মতো দুই অক্ষরের সংকেত ছাপা হয় (প্রথম অক্ষর index বনাম HEAD, দ্বিতীয় অক্ষর ফোল্ডার বনাম index). এটি Git-এর আসল কোড নয়, শুধু ধারণাটির মডেল।

// Three areas: working tree (W), staging area / index (I), last commit HEAD (H).
const work = {}, index = {}; let head = {};
function state(f) {                       // the two letters of "git status -s"
  if (!(f in index)) return "?? untracked";
  const x = !(f in head) ? "A" : index[f] !== head[f] ? "M" : " ";
  const y = !(f in work) ? "D" : work[f] !== index[f] ? "M" : " ";
  const name = { "A ": "new, staged", "AM": "new, staged + edited again",
    "M ": "modified, staged", " M": "modified, not staged",
    "MM": "staged + edited again", "  ": "unmodified" }[x + y];
  return x + y + " " + name;
}
function show(cmd) {
  console.log("$ " + cmd);
  for (const f of Object.keys(work).sort())
    console.log(`  ${f}  W=${work[f]}  I=${index[f] ?? "--"}  H=${head[f] ?? "--"}  ${state(f)}`);
}
const add = (...fs) => fs.forEach(f => { index[f] = work[f]; });
const commit = () => { head = { ...index }; };   // commit copies the index, not W

for (const f of ["a.txt", "b.txt", "c.txt"]) work[f] = "v1";
show("create a.txt b.txt c.txt");
add("a.txt", "b.txt");      show("git add a.txt b.txt");
work["b.txt"] = "v2";       show("edit b.txt");
commit();                   show('git commit -m "first"');
add("b.txt", "c.txt");      show("git add b.txt c.txt");
commit();                   show('git commit -m "second"');
work["a.txt"] = "v2";       show("edit a.txt");

$ create a.txt b.txt c.txt
  a.txt  W=v1  I=--  H=--  ?? untracked
  b.txt  W=v1  I=--  H=--  ?? untracked
  c.txt  W=v1  I=--  H=--  ?? untracked
$ git add a.txt b.txt
  a.txt  W=v1  I=v1  H=--  A  new, staged
  b.txt  W=v1  I=v1  H=--  A  new, staged
  c.txt  W=v1  I=--  H=--  ?? untracked
$ edit b.txt
  a.txt  W=v1  I=v1  H=--  A  new, staged
  b.txt  W=v2  I=v1  H=--  AM new, staged + edited again
  c.txt  W=v1  I=--  H=--  ?? untracked
$ git commit -m "first"
  a.txt  W=v1  I=v1  H=v1     unmodified
  b.txt  W=v2  I=v1  H=v1   M modified, not staged
  c.txt  W=v1  I=--  H=--  ?? untracked
$ git add b.txt c.txt
  a.txt  W=v1  I=v1  H=v1     unmodified
  b.txt  W=v2  I=v2  H=v1  M  modified, staged
  c.txt  W=v1  I=v1  H=--  A  new, staged
$ git commit -m "second"
  a.txt  W=v1  I=v1  H=v1     unmodified
  b.txt  W=v2  I=v2  H=v2     unmodified
  c.txt  W=v1  I=v1  H=v1     unmodified
$ edit a.txt
  a.txt  W=v2  I=v1  H=v1   M modified, not staged
  b.txt  W=v2  I=v2  H=v2     unmodified
  c.txt  W=v1  I=v1  H=v1     unmodified

৩ · File-এর চার অবস্থা আর git status

Git-এর চোখে project ফোল্ডারের প্রতিটি file হয় untracked, নয়তো tracked. Tracked মানে file-টি শেষ commit-এ আছে, বা অন্তত index-এ তোলা হয়েছে। Tracked file আবার তিন রকম হতে পারে:

এক file একসাথে staged আর modified দুটোই হতে পারে — MM বা AM; তখন index-এ এক version, ফোল্ডারে আরেক। এবার আসল Git-এ দেখি। ফোল্ডারে তিনটি file লিখলাম — README.md, index.html আর app.js:

$ git status
On branch main

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	README.md
	app.js
	index.html

nothing added to commit but untracked files present (use "git add" to track)
$ git status -s
?? README.md
?? app.js
?? index.html

লম্বা রূপে git status প্রতিটি অংশের নিচে বন্ধনীতে পরের সম্ভাব্য command-ও বলে দেয় — নতুনদের জন্য এটি দারুণ সহায়ক। ছোট রূপ git status -s (--short) প্রতি file-এ এক লাইন। এবার দুটি file add করি, তৃতীয়টি নয়:

$ git add README.md app.js
$ git status
On branch main

No commits yet

Changes to be committed:
  (use "git rm --cached <file>..." to unstage)
	new file:   README.md
	new file:   app.js

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	index.html

এখন app.js-এ একটি নতুন জিনিস ("tel") যোগ করলাম, কিন্তু আবার add করিনি:

$ git status
On branch main

No commits yet

Changes to be committed:
  (use "git rm --cached <file>..." to unstage)
	new file:   README.md
	new file:   app.js

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
	modified:   app.js

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	index.html
$ git status -s
A  README.md
AM app.js
?? index.html

app.js এখন দুই জায়গায়: “Changes to be committed”-এ (index-এ পুরোনো version) আর “Changes not staged”-এ (ফোল্ডারে নতুন version). ছোট রূপে AM: প্রথম অক্ষর A — index-এ নতুন যোগ হয়েছে; দ্বিতীয় অক্ষর M — ফোল্ডারে তার পরে আবার বদলেছে। একটি ছোট খুঁটিনাটি: প্রথম commit-এর আগে unstage করার পরামর্শ git rm --cached, প্রথম commit-এর পরে সেটি হয়ে যায় git restore --staged — কারণ তখন ফেরার মতো একটি commit আছে।

নিচের stepper-এ একটি file-এর পুরো জীবনচক্র ধাপে ধাপে দেখুন। প্রতি ধাপে তিন এলাকায় app.js-এর কোন version আছে, আর git status -s কী দেখাবে:

৪ · git add — কোন file, কোন অংশ, কোন ফোল্ডার

git add-এর নাম একটু বিভ্রান্তিকর। এটি শুধু “নতুন file যোগ” নয়; এর আসল অর্থ হলো এই file-এর এখনকার বিষয়বস্তু পরের commit-এর জন্য index-এ তোলা। নতুন file, বদলানো file — দুটোতেই একই command. কয়েকটি রূপ:

git add . বনাম git add -A

পুরোনো টিউটোরিয়ালে প্রায়ই লেখা থাকে, “add . মুছে ফেলা file নেয় না, তাই -A দিন।” কথাটি Git ১.x-এর জন্য সত্যি ছিল। Git ২.০ (২০১৪) থেকে git add . মুছে ফেলা file-ও নেয়। এখন দুটির পার্থক্য শুধু পরিধিতে: . মানে “এই ফোল্ডার আর তার নিচে”, আর -A মানে “পুরো project”. Project-এর মূল ফোল্ডারে দাঁড়িয়ে দুটো একই কাজ করে। নিচে আগে README.md-এ একটি লাইন যোগ করা হয়েছে, নতুন file css/style.css আর discount.js লেখা হয়েছে; তারপর css ফোল্ডারের ভেতর থেকে add .:

$ cd css
$ git add .
$ git status -s
 M ../README.md
A  style.css
?? ../discount.js
$ cd ..
$ git add -A
$ git status -s
M  README.md
A  css/style.css
A  discount.js
$ git commit -m "Add stylesheet, discount and run note"
[main 5903454] Add stylesheet, discount and run note
 3 files changed, 5 insertions(+)
 create mode 100644 css/style.css
 create mode 100644 discount.js

css-এর ভেতর থেকে add . শুধু style.css তুলেছে (git status -s path-ও বর্তমান ফোল্ডার থেকে দেখায়, তাই ../README.md). মূল ফোল্ডারে ফিরে -A সব তুলেছে। সতর্কতা: add . বা add -A চোখ বন্ধ করে দিলে log file, password-এর file, বিশাল build ফাইল — সব উঠে যেতে পারে। তাই আগে git status দেখুন, আর যা কখনো track করবেন না তা .gitignore-এ লিখুন — পর্ব ১০ (.gitignore আর git config).

git add -p — একই file-এর অংশবিশেষ তোলা

ধরুন prices.js file-এ আপনি একসাথে দুটি আলাদা কাজ করেছেন: চালের দাম ৭০ থেকে ৭৫ টাকা করেছেন (আসল কাজ), আর একটি debug লাইন বসিয়েছেন (সাময়িক, commit-এ যাওয়ার কথা নয়)। git add prices.js দিলে দুটোই উঠবে। git add -p (--patch) file-এর বদলকে hunk-এ ভাগ করে — hunk মানে পাশাপাশি বদলানো লাইনের একটি টুকরো — আর প্রতিটির জন্য জিজ্ঞেস করে, “এটি তুলব?” নিচের stepper-এ আসল Git-এর আউটপুট দেখুন:

@@ -1,6 +1,6 @@
 // prices.js - price list for the bazar
 const prices = {
-  chal: 70,
+  chal: 75,
   dal: 120,
   tel: 180,
 };
@@ -14,6 +14,7 @@ function total(cart) {
 }

 function format(amount) {
+  console.log("debug", amount);
   return amount + " taka";
 }

@@ -1,6 +1,6 @@
 // prices.js - price list for the bazar
 const prices = {
-  chal: 70,
+  chal: 75,
   dal: 120,
   tel: 180,
 };
(1/2) Stage this hunk [y,n,q,a,d,k,K,j,J,g,/,e,p,P,?]? y

@@ -14,6 +14,7 @@ function total(cart) {
 }

 function format(amount) {
+  console.log("debug", amount);
   return amount + " taka";
 }

(2/2) Stage this hunk [y,n,q,a,d,K,J,g,/,e,p,P,?]? n

$ git status -s
MM prices.js
$ git diff --cached
…
@@ -1,6 +1,6 @@
 // prices.js - price list for the bazar
 const prices = {
-  chal: 70,
+  chal: 75,
   dal: 120,
   tel: 180,
 };

$ git commit -m "Raise rice price to 75 taka"
[main 37c2b34] Raise rice price to 75 taka
 1 file changed, 1 insertion(+), 1 deletion(-)
$ git status -s
 M prices.js
$ git restore prices.js
$ git status -s
(কিছু নেই — debug লাইন ফোল্ডার থেকেও মুছে গেছে)

add -p-এর মূল্য বোঝা যায় যখন একটি file-এ একসাথে একটি bug fix আর একটি নতুন feature-এর কাজ মিশে যায়। দুটোকে দুটি আলাদা commit-এ রাখলে পরে একটিকে ফেরানো (revert, পর্ব ১১) বা review করা (পর্ব ৪৪) অনেক সহজ। VS Code-সহ অনেক editor-এ একই কাজ হয় লাইন বেছে “Stage Selected Ranges” জাতীয় বাটনে — নাম tool-ভেদে আলাদা।

৫ · git commit — একটি commit কী কী মনে রাখে

আমাদের bazar project-এ ফিরি। app.js আর index.html-ও add করে প্রথম commit:

$ git add app.js index.html
$ git status -s
A  README.md
A  app.js
A  index.html
$ git commit -m "Add product list page"
[main (root-commit) 8bfb77a] Add product list page
 3 files changed, 7 insertions(+)
 create mode 100644 README.md
 create mode 100644 app.js
 create mode 100644 index.html
$ git status
On branch main
nothing to commit, working tree clean
$ git log --oneline
8bfb77a Add product list page

Commit-এর আউটপুটের প্রথম লাইনটি পড়তে শিখুন: [main (root-commit) 8bfb77a] মানে branch main-এ, এটি root commit (প্রথম commit, যার আগে কিছু নেই), আর তার ID-র ছোট রূপ 8bfb77a. তারপর বার্তা, কয়টি file আর কয়টি লাইন বদলেছে। create mode 100644 মানে নতুন একটি সাধারণ file (চালানো যায় এমন file হলে 100755). এরপর git status বলছে working tree clean — তিন এলাকা মিলে গেছে।

একটি commit-এর ভেতরে উঁকি

git cat-file -p একটি Git object-এর ভেতরের লেখা হুবহু দেখায় (internals-এর বিস্তারিত পর্ব ৫২-এ, আজ শুধু উঁকি):

$ git cat-file -p HEAD
tree 9bb98eca3b3ee398a745f766c1639c8698cf6305
author Rahim <rahim@example.com> 1768449660 +0600
committer Rahim <rahim@example.com> 1768449660 +0600

Add product list page
$ git rev-parse HEAD
8bfb77a54601e9294b83f3f19c4519d36a524183
$ git rev-parse --short HEAD
8bfb77a

একটি commit আসলে এটুকুই — একটি ছোট লেখা:

• tree: project-এর পুরো snapshot-এর ID — সেই মুহূর্তে index-এ থাকা সব file আর ফোল্ডারের তালিকা। শুধু পার্থক্য নয়, পুরো ছবি।
• parent: আগের commit-এর ID. প্রথম commit-এ এই লাইনই নেই — উপরে দেখুন। Merge commit-এ (পর্ব ১৩) একাধিক parent থাকে।
• author: যিনি পরিবর্তনটি মূলত লিখেছেন, সাথে সময় (1768449660 হলো ১৯৭০ থেকে গোনা সেকেন্ড, এখানে ১৫ জানুয়ারি ২০২৬, সকাল ১০টা ১ মিনিট, ঢাকার সময়) আর সময় অঞ্চল +0600.
• committer: যিনি commit-টি repository-তে বসিয়েছেন। সাধারণত author-ই; আলাদা হয় যখন কেউ অন্যের পাঠানো patch বসান, বা পরে commit নতুন করে সাজানো হয় (rebase, পর্ব ১৫)।
• বার্তা: একটি ফাঁকা লাইনের পরে commit message.

এই পুরো লেখাটিকে Git একটি hash function-এ দেয় — ঐতিহ্যগতভাবে SHA-1, আরও সঠিকভাবে বললে "commit <size>\0" শিরোনাম জুড়ে তার ওপর। ফল ৪০ অক্ষরের hexadecimal সংখ্যা, এটিই commit hash বা commit ID: 8bfb77a…. দৈনন্দিন কাজে প্রথম কয়েকটি অক্ষরই যথেষ্ট — Git সাধারণত অন্তত ৭টি দেখায়, আর repository বড় হলে দরকারমতো বেশি, যাতে দুটি commit-এর ছোট রূপ মিলে না যায়। নতুন Git-এ চাইলে git init --object-format=sha256 দিয়ে SHA-256 repository-ও বানানো যায় (তখন ID ৬৪ অক্ষরের); তবে লেখার সময়ে বেশিরভাগ repository SHA-1-এই চলে।

Author আর committer যেহেতু commit-এর লেখার অংশ, তাই আমরা এই পর্বের প্রতিটি commit-এর আগে সময় নির্দিষ্ট করে দিয়েছি (GIT_AUTHOR_DATE আর GIT_COMMITTER_DATE, প্রতিবার এক মিনিট এগিয়ে)। একই নাম, email, সময়, বার্তা আর file দিয়ে আপনি নিজে চালালে হুবহু একই hash পাবেন। সময় নির্দিষ্ট না করলে আপনার hash আলাদা আসবে — সেটাই স্বাভাবিক।

লম্বা বার্তা — editor দিয়ে commit

-m ছাড়া শুধু git commit দিলে Git আপনার editor খোলে (পর্ব ০৭-এ যেটি সেট করেছেন; না করলে প্রায়ই Vim). তাতে একটি খসড়া থাকে:

# Please enter the commit message for your changes. Lines starting
# with '#' will be ignored, and an empty message aborts the commit.
#
# On branch main
# Changes to be committed:
#	modified:   app.js
#

# দিয়ে শুরু হওয়া লাইন বাদ যায়; বার্তা ফাঁকা রেখে বন্ধ করলে commit বাতিল হয়। প্রথম লাইনে একটি ছোট সারাংশ, তারপর একটি ফাঁকা লাইন, তারপর “কেন” — এই কাঠামোয় লিখে save করে বন্ধ করলাম (terminal-এ editor খোলা থাকার সময় Git একটি “Waiting for your editor…” ধরনের বার্তা দেখাতে পারে):

$ git add app.js
$ git commit
[main be72ad5] Print each item on its own line
 1 file changed, 1 insertion(+), 1 deletion(-)

$ git cat-file -p HEAD
tree 9c161ecf00137cb88feb9387296a968878d635a7
parent 8bfb77a54601e9294b83f3f19c4519d36a524183
author Rahim <rahim@example.com> 1768449720 +0600
committer Rahim <rahim@example.com> 1768449720 +0600

Print each item on its own line

The list was printed as one array, which is hard to read
on a phone screen. Print one item per line instead.
$ git log -1 --format=fuller
commit be72ad5af3400d3a74cea4f824820bde9ad28056
Author:     Rahim <rahim@example.com>
AuthorDate: Thu Jan 15 10:02:00 2026 +0600
Commit:     Rahim <rahim@example.com>
CommitDate: Thu Jan 15 10:02:00 2026 +0600

    Print each item on its own line

    The list was printed as one array, which is hard to read
    on a phone screen. Print one item per line instead.

এবার parent 8bfb77a… লাইন এসেছে — দ্বিতীয় commit প্রথমটির দিকে নির্দেশ করছে। --format=fuller author আর committer আলাদা করে দেখায়। -m দুবার দিলেও (git commit -m "সারাংশ" -m "বিস্তারিত") Git দুটি অনুচ্ছেদ বানায়, কিন্তু লম্বা বার্তার জন্য editor-ই সুবিধাজনক। ভালো বার্তার প্রচলিত নিয়ম (৫০ অক্ষরের মধ্যে সারাংশ, আদেশসূচক ক্রিয়া, Conventional Commits) পর্ব ১৮-এ।

নিচের stepper-এ দুটি commit পাশাপাশি দেখুন — কোনটিতে কী আছে:

Commit ID কেন এত “স্পর্শকাতর”

Commit-এর লেখায় parent-এর ID থাকে, আর সেই লেখার hash-ই commit-এর ID. তাহলে পুরোনো একটি commit-এর একটি byte বদলালে কী হয়? নিচের মডেলে commit বানানো হয়েছে {tree, parent, author, committer, message} দিয়ে; ID হিসেবে আমরা ছোট একটি 32-bit hash, FNV-1a, ব্যবহার করেছি — এটি শুধু Git-এর SHA-1 বা SHA-256-এর জায়গায় দাঁড়ানো একটি সহজ বিকল্প, নিরাপত্তার জন্য নয়। আসল Git hash করে "commit <size>\0" আর তারপর commit-এর লেখা।

// Commit objects: {tree snapshot, parent, author, message} -> an ID from the text.
// FNV-1a 32-bit stands in for Git's SHA-1 (or SHA-256) over "commit <size>\0" + text.
function fnv1a(s) {
  let h = 0x811c9dc5;
  for (let i = 0; i < s.length; i++) { h ^= s.charCodeAt(i); h = Math.imul(h, 0x01000193) >>> 0; }
  return h.toString(16).padStart(8, "0");
}
function treeId(files) {                  // canonical text: sorted "name content" lines
  return fnv1a(Object.keys(files).sort().map(f => f + " " + files[f]).join("\n"));
}
function makeCommit(files, parent, msg, time) {
  const text = "tree " + treeId(files) + "\n" + (parent ? "parent " + parent + "\n" : "") +
    "author Rahim <rahim@example.com> " + time + " +0600\n" +
    "committer Rahim <rahim@example.com> " + time + " +0600\n\n" + msg + "\n";
  return { id: fnv1a(text), text };
}
function history(firstAppJs) {
  const s1 = { "app.js": firstAppJs, "README.md": "# Bazar" };
  const s2 = { ...s1, "app.js": 'items = ["chal","dal","tel"]' };
  const s3 = { ...s2, "prices.js": "chal: 70" };
  const c1 = makeCommit(s1, null, "Add product list", 1768449660);
  const c2 = makeCommit(s2, c1.id, "Add oil to list", 1768449720);
  const c3 = makeCommit(s3, c2.id, "Add price list", 1768449780);
  return [c1, c2, c3];
}
const A = history('items = ["chal","dal"]');
console.log("--- first commit object (no parent line) ---\n" + A[0].text);
console.log("--- second commit object ---\n" + A[1].text);
const B = history('items = ["chal","dal"] ');       // one extra space in commit 1
for (let i = 0; i < 3; i++)
  console.log(`commit ${i + 1}: original ${A[i].id}   one-byte change ${B[i].id}`);

--- first commit object (no parent line) ---
tree dc80d4b1
author Rahim <rahim@example.com> 1768449660 +0600
committer Rahim <rahim@example.com> 1768449660 +0600

Add product list

--- second commit object ---
tree 38ba9274
parent 2934e7c2
author Rahim <rahim@example.com> 1768449720 +0600
committer Rahim <rahim@example.com> 1768449720 +0600

Add oil to list

commit 1: original 2934e7c2   one-byte change bc213395
commit 2: original f04a6621   one-byte change abfc9356
commit 3: original 140993bc   one-byte change b544020f

৬ · git commit -a — সুবিধা আর তার ফাঁদ

git commit -a (--all) মানে commit-এর আগে সব tracked file-এর বদল আর মুছে ফেলা নিজে থেকে stage করে নেওয়া। ছোট কাজে এটি সময় বাঁচায় — আলাদা git add লাগে না। কিন্তু ফাঁদটি নামেই লুকানো: “all” মানে সব tracked file, নতুন (untracked) file নয়। নিচে app.js-এ লবণ ("lobon") যোগ করা হয়েছে, আর একটি নতুন file discount.js লেখা হয়েছে; ডেভেলপার ভাবছেন দুটোই commit হবে:

$ git status -s
 M app.js
?? discount.js
$ git commit -a -m "Add discount and salt"
[main 26d4771] Add discount and salt
 1 file changed, 1 insertion(+), 1 deletion(-)
$ git status -s
?? discount.js
$ git show --stat --oneline HEAD
26d4771 Add discount and salt
 app.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

বার্তায় লেখা “Add discount”, কিন্তু commit-এ আছে শুধু app.js (1 file changed). discount.js এখনো ??. দলের অন্য কেউ এই commit নিলে app.js হয়তো discount.js-কে খুঁজবে আর পাবে না — “আমার কম্পিউটারে তো চলছিল!” সমস্যার একটি ক্লাসিক উৎস। এরপর আমরা অংশ ৪-এর git add -A দিয়ে file-টি পরের commit-এ তুলেছিলাম।

নিচের মডেলে একটি seed-যুক্ত PRNG (mulberry32) সাতটি file-এর একটি এলোমেলো-দেখতে কিন্তু প্রতিবার একই অবস্থা বানায়, তারপর দেখায় commit -a আর “add -A, তারপর commit” — কোনটি কোন file নেয়:

// The "git commit -a" trap: which files really go into the commit?
// A seeded PRNG (mulberry32) builds a random-looking but repeatable folder.
function mulberry32(a) { return () => { a = (a + 0x6D2B79F5) | 0; let t = Math.imul(a ^ (a >>> 15), 1 | a);
  t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t; return ((t ^ (t >>> 14)) >>> 0) / 4294967296; }; }
const rnd = mulberry32(8);
const kinds = ["untracked (new)", "tracked, modified", "tracked, unchanged", "tracked, deleted"];
const names = ["cart.js", "login.js", "notes.md", "offer.js", "pay.js", "logo.svg", "faq.md"];
const files = names.map(name => ({ name, kind: kinds[Math.floor(rnd() * 4)] }));

// commit -a = "stage every change to files Git ALREADY tracks", then commit.
const inCommitA = f => f.kind === "tracked, modified" || f.kind === "tracked, deleted";
// add -A (or add .) first = also stage new files.
const inAddAll = f => f.kind !== "tracked, unchanged";

console.log("file        state                commit -a   add -A + commit");
for (const f of files)
  console.log(f.name.padEnd(12) + f.kind.padEnd(21) +
    (inCommitA(f) ? "yes" : "no").padEnd(12) + (inAddAll(f) ? "yes" : "no"));
const lost = files.filter(f => inAddAll(f) && !inCommitA(f)).map(f => f.name);
console.log("\nleft behind by commit -a: " + (lost.join(", ") || "none"));
console.log("still shown as ?? after commit -a: " + lost.length + " file(s)");

file        state                commit -a   add -A + commit
cart.js     untracked (new)      no          yes
login.js    tracked, unchanged   no          no
notes.md    tracked, modified    yes         yes
offer.js    tracked, unchanged   no          no
pay.js      tracked, unchanged   no          no
logo.svg    tracked, modified    yes         yes
faq.md      tracked, deleted     yes         yes

left behind by commit -a: cart.js
still shown as ?? after commit -a: 1 file(s)

৭ · মুছে ফেলা, নাম বদল আর খালি ফোল্ডার

git rm — ফোল্ডার আর index দুই জায়গা থেকে

একটি tracked file সাধারণ rm বা File Explorer দিয়ে মুছলে Git সেটিকে “deleted, not staged” (" D") দেখায়; তারপর git add বা git rm দিয়ে মোছাটা stage করতে হয়। git rm দুটি কাজ একসাথে করে — ফোল্ডার থেকে file মোছে আর মোছাটা stage করে:

$ git rm discount.js
rm 'discount.js'
$ git status -s
D  discount.js
$ ls
README.md
app.js
css
index.html
prices.js
$ git commit -m "Remove discount until prices are final"
[main 9610b7c] Remove discount until prices are final
 1 file changed, 3 deletions(-)
 delete mode 100644 discount.js

File-টি শেষ commit থেকে বাদ গেছে, কিন্তু ইতিহাস থেকে নয় — আগের commit 5903454-এ discount.js এখনো আছে, দরকার হলে ফেরানো যাবে (পর্ব ১১)।

git rm --cached — Git থেকে বাদ, ফোল্ডারে থাকুক

ভুল করে একটি log file commit করে ফেলেছেন। File-টি নিজের কম্পিউটারে রাখতে চান, শুধু Git যেন আর track না করে। তখন --cached: শুধু index থেকে সরায়, ফোল্ডারে হাত দেয় না।

$ git add debug.log
$ git commit -m "Add debug log by mistake"
…
$ git rm --cached debug.log
rm 'debug.log'
$ git status
On branch main
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
	deleted:    debug.log

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	debug.log
$ ls
README.md
app.js
css
debug.log
home.html
images
price-list.js
$ git commit -m "Stop tracking debug.log"
[main 8732561] Stop tracking debug.log
 1 file changed, 1 deletion(-)
 delete mode 100644 debug.log
$ git status -s
?? debug.log

একই file দুই তালিকায় — index থেকে “deleted” আর ফোল্ডারে “untracked”. ls দেখাচ্ছে file ফোল্ডারেই আছে। কিন্তু ?? হয়ে থাকলে কেউ আবার git add . দিয়ে তুলে ফেলতে পারেন; তাই সাথে সাথে debug.log বা *.log .gitignore-এ লেখা উচিত — পর্ব ১০।

git mv আর rename detection

$ git mv index.html home.html
$ git status
On branch main
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
	renamed:    index.html -> home.html
$ git commit -m "Rename index.html to home.html"
[main 14ebbe2] Rename index.html to home.html
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename index.html => home.html (100%)

মজার তথ্য: Git কোথাও “নাম বদল” লিখে রাখে না। Commit-এ থাকে শুধু snapshot — আগের snapshot-এ index.html, নতুনটিতে home.html, বিষয়বস্তু একই। git status, diff বা log দুটি snapshot তুলনা করে বলে, “একটি file গেছে, প্রায় একই রকম একটি এসেছে — নিশ্চয়ই নাম বদল।” একে বলে rename detection; ডিফল্টে বিষয়বস্তু অন্তত ৫০% মিললে Git নাম বদল ধরে ((100%) মানে হুবহু একই)। তাই git mv আসলে শুধু একটি সুবিধা — mv আর git add-এর যোগফল। সাধারণ mv করে পরে add করলেও ফল একই:

$ mv prices.js price-list.js
$ git status -s
 D prices.js
?? price-list.js
$ git add -A
$ git status -s
R  prices.js -> price-list.js
$ git commit -m "Rename prices.js to price-list.js"
[main ad94308] Rename prices.js to price-list.js
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename prices.js => price-list.js (100%)

add-এর আগে Git দেখাচ্ছে একটি file মুছে গেছে (" D") আর একটি নতুন এসেছে (??)। দুটিই stage হতেই সে মিলিয়ে R (renamed) বলল। একটি পরামর্শ: নাম বদল আর বিষয়বস্তুর বড় পরিবর্তন একই commit-এ না করাই ভালো — মিল ৫০%-এর নিচে নামলে Git একে “একটি মুছে আরেকটি নতুন” দেখাবে, আর পরে file-এর ইতিহাস খোঁজা কঠিন হবে।

খালি ফোল্ডার Git দেখে না — .gitkeep

Git শুধু file track করে; ফোল্ডার আসে file-এর path থেকে। তাই খালি ফোল্ডারের কোনো অস্তিত্বই Git-এর কাছে নেই:

$ mkdir images
$ git status
On branch main
nothing to commit, working tree clean
$ touch images/.gitkeep
$ git status -s
?? images/
$ git add images
$ git commit -m "Add empty images folder"
[main 809cc53] Add empty images folder
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 images/.gitkeep

mkdir images-এর পরেও working tree clean. ভেতরে একটি ফাঁকা file রাখতেই ফোল্ডারটি দেখা দিল। এই file-এর প্রচলিত নাম .gitkeep — কিন্তু এটি শুধু একটি প্রথা, Git-এর কোনো বিশেষ নিয়ম নয়; যেকোনো নামেই কাজ হয়। অনেক দল ফাঁকা file-এর বদলে ছোট একটি README বা ফোল্ডারের ভেতরের সব কিছু উপেক্ষা করার একটি .gitignore রাখেন।

৮ · ছোট, এক-উদ্দেশ্যের commit — আর git log-এ এক নজর

এই পর্বের পুরো কাজের ইতিহাস এখন এরকম:

$ git log --oneline
8732561 Stop tracking debug.log
99f2ccd Add debug log by mistake
809cc53 Add empty images folder
ad94308 Rename prices.js to price-list.js
14ebbe2 Rename index.html to home.html
9610b7c Remove discount until prices are final
5903454 Add stylesheet, discount and run note
26d4771 Add discount and salt
37c2b34 Raise rice price to 75 taka
bb4928a Add price list and total
be72ad5 Print each item on its own line
8bfb77a Add product list page

git log --oneline প্রতিটি commit-কে এক লাইনে দেখায়: ছোট ID আর বার্তার প্রথম লাইন, নতুন commit সবার ওপরে। ১২টি commit, প্রতিটির একটি কাজ — দাম বাড়ানো, নাম বদল, একটি ভুল শোধরানো। log-এর অসংখ্য বিকল্প (--graph, -p, --stat, তারিখ দিয়ে খোঁজা) পর্ব ০৯-এ (status, diff, log আর show).

একটি খারাপ ইতিহাস কল্পনা করুন: সপ্তাহের শেষে একটিমাত্র commit, বার্তা update, তাতে ৪০টি file আর দাম বদল, নতুন page, debug লাইন আর একটি bug fix — সব একসাথে। এখন দুটি বিপদ:

• ফেরানো: দাম বদলটি ভুল ছিল। ফেরাতে গেলে পুরো সপ্তাহের কাজ ফেরাতে হবে, নয়তো হাতে বেছে বেছে খুঁজতে হবে। ছোট commit হলে শুধু 37c2b34-কে revert করলেই হতো (পর্ব ১১)।
• খোঁজা: কোন পরিবর্তনে bug এসেছে, Git-এর bisect commit ধরে ধরে binary search করে বের করতে পারে (পর্ব ৫৫)। কিন্তু উত্তর যদি হয় “৪০ file-এর ওই বিশাল commit”, তাতে প্রায় কিছুই জানা হলো না।
• Review: ২০০ লাইনের এক-উদ্দেশ্যের পরিবর্তন একজন reviewer মন দিয়ে পড়তে পারেন; ২০০০ লাইনের মিশ্র পরিবর্তন সাধারণত চোখ বুলিয়ে “ঠিক আছে” পায় (code review, পর্ব ৪৪)।

তবে উল্টো দিকেও বাড়াবাড়ি আছে। প্রতিটি টাইপো-র জন্য আলাদা commit, “wip”, “wip2”, “fix again” — এমন ইতিহাসও পড়া কঠিন। এর সমাধান হলো নিজের branch-এ ইচ্ছেমতো ছোট commit করা, আর অন্যদের সাথে ভাগ করার আগে interactive rebase (পর্ব ১৫) দিয়ে গুছিয়ে নেওয়া, বা pull request-এ squash করা (পর্ব ১৬)। Linux kernel-এর patch জমা দেওয়ার নির্দেশিকাতেও “প্রতিটি যুক্তিসংগত পরিবর্তন আলাদা patch-এ” রাখার কথা বলা আছে — বড় open-source project-এ এটি পুরোনো অভ্যাস।

৯ · AI-এর যুগে — Git command-এ AI-কে যাচাই

“আমার file commit হচ্ছে না” — এমন প্রশ্নে AI সাধারণত কয়েক সেকেন্ডে কয়েকটি command দিয়ে দেয়। বেশিরভাগ সময় কাজও হয়। কিন্তু এই পর্বের বিষয়ে AI-এর কয়েকটি পরিচিত ভুল আছে, আর তার কয়েকটি আপনার কাজ মুছে দিতে পারে:

AI-এর দেওয়া Git command চালানোর আগে — চেকলিস্ট

• চালানোর আগে git status দেখেছি, আর জানি কোন file কোন এলাকায় আছে
• অপরিচিত command বা flag আগে একটি throwaway repository-তে (git init করা একটি খালি ফোল্ডারে) চালিয়ে দেখেছি
• git help <command> বা অফিসিয়াল documentation-এ flag-টি আছে কি না মিলিয়েছি
• Commit-এর আগে git diff --cached পড়েছি — ঠিক যা চাই, তা-ই যাচ্ছে
• reset --hard, restore, clean, push --force দেখলে থেমেছি, আর না-তোলা কাজের একটি কপি রেখেছি
• Prompt-এ কোনো password, token বা .env-এর লেখা পেস্ট করিনি