@ridit/forge 0.2.6 → 0.2.8

package/README.md

@@ -1,6 +1,8 @@
 # Forge
 
-Forge is a lightweight version control system built from scratch. Designed to be simple, fast, and easy to understand — Forge gives you the core of a VCS without the complexity of Git.
+> Git, but yours.
+
+Forge is a lightweight version control system built from scratch. Designed to be simple and easy to understand — Forge gives you the core of a VCS without the complexity of Git.
 
 ## Installation
 
@@ -24,6 +26,7 @@ npm install -g @ridit/forge
 - **Status** — view modified, staged, untracked, and deleted files
 - **Checkpoints** — auto-saved snapshots when switching branches
 - **ForgeIgnore** — `.forgeignore` support to exclude files
+- **Content-addressable storage** — file content stored as hashed objects, never duplicated
 
 ## CLI Commands
 
@@ -56,16 +59,27 @@ Forge stores all data in a `.forge` folder at the root of your repository:
 
 ```
 .forge/
+├── objects/          ← content-addressable file storage (hashed)
 ├── commits/          ← global commit refs (lightweight)
 ├── branches/
 │   └── main/
 │       ├── branch.json       ← branch metadata + latest commit id
 │       ├── checkpoint.json   ← auto-snapshot saved on branch switch
-│       └── commits/          ← full commits with file blobs
+│       └── commits/          ← full commits with file hashes
 ├── repo.json         ← repo metadata + active branch
 └── tempAddedFiles.json  ← staging area
 ```
 
+## Object Storage
+
+Instead of storing full file content in every commit, Forge uses a content-addressable object store — similar to how Git works internally.
+
+- Every file is hashed with SHA-256 on `add`
+- The content is stored once in `.forge/objects/` keyed by hash
+- Commits store only file paths + hashes — not the full content
+- Same file content across 100 commits = stored **once**
+- Duplicate files across branches = stored **once**
+
 ## Branch System
 
 - Every branch stores its own commit history

package/dist/index.mjs

@@ -44217,7 +44217,10 @@ function createBranch(repo_path, branch_name) {
       }));
     }
   } catch (err) {
-    return { status: "error", error: err };
+    return {
+      status: "error",
+      error: `error while creating branch: ${String(err)}.`
+    };
   }
   return { status: "ok" };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ridit/forge",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "Git, but yours.",
   "author": "Ridit Jangra <riditjangra09@gmail.com> (https://ridit.space)",
   "license": "MIT",

package/src/utils/branch.ts

@@ -79,7 +79,10 @@ export function createBranch(
       );
     }
   } catch (err) {
-    return { status: "error", error: err as string };
+    return {
+      status: "error",
+      error: `error while creating branch: ${String(err)}.`,
+    };
   }
 
   return { status: "ok" };