feat: sync template with assignments

Readme.md

@@ -41,6 +41,21 @@ This repository contains solutions for Node.js Fundamentals assignment. The assi
 - `npm run fs:restore` - Restore directory structure from snapshot
 - `npm run fs:findByExt` - Find files by extension in workspace
 - `npm run fs:merge` - Merge .txt files from workspace/parts
+- `npm run fs:merge -- --files a.txt,b.txt,c.txt` - Merge specific files from workspace/parts in provided order
+
+Snapshot format reminder:
+
+```json
+{
+  "rootPath": "/absolute/path/to/workspace",
+  "entries": [
+    { "path": "file1.txt", "type": "file", "size": 1024, "content": "base64" },
+    { "path": "nested", "type": "directory" }
+  ]
+}
+```
+
+`entries[].path` values must be relative to `workspace`.
 
 ### CLI (src/cli)
 

src/fs/merge.js

@@ -1,6 +1,7 @@
 const merge = async () => {
   // Write your code here
-  // Read all .txt files from workspace/parts in alphabetical order
+  // Default: read all .txt files from workspace/parts in alphabetical order
+  // Optional: support --files filename1,filename2,... to merge specific files in provided order
   // Concatenate content and write to workspace/merged.txt
 };
 

src/fs/restore.js

@@ -1,6 +1,7 @@
 const restore = async () => {
   // Write your code here
   // Read snapshot.json
+  // Treat snapshot.rootPath as metadata only
   // Recreate directory/file structure in workspace_restored
 };
 

src/fs/snapshot.js

@@ -1,7 +1,9 @@
 const snapshot = async () => {
   // Write your code here
   // Recursively scan workspace directory
-  // Write snapshot.json with flat array of all entries
+  // Write snapshot.json with:
+  // - rootPath: absolute path to workspace
+  // - entries: flat array of relative paths and metadata
 };
 
 await snapshot();