Added document update command

Author: pawelniewie

README.md

@@ -269,6 +269,76 @@ funcli documents create z2zK66AaEF my-document.md
 # Creates "API Documentation" as child of def456
 ```
 
+#### Update a document
+
+```bash
+funcli documents update <document-npi> [file]
+```
+
+Updates an existing document with new markdown content from a file or stdin. This creates a new version of the document while preserving its history.
+
+**Arguments:**
+- `<document-npi>` - NPI of the document to update
+- `[file]` - Path to markdown file (optional, reads from stdin if omitted)
+
+**Frontmatter Support:**
+
+The update command supports YAML frontmatter for tags, just like the create command:
+
+```markdown
+---
+tags:
+  - updated/tag1
+  - updated/tag2
+---
+
+# Updated content starts here
+```
+
+**Note:** Tags from frontmatter will replace any existing tags on the document.
+
+**Examples:**
+
+```bash
+# Update from file
+funcli documents update abc123 updated-content.md
+
+# Update from stdin
+echo "# Updated Content\n\nNew text here" | funcli documents update abc123
+
+# Update from stdin (multiline)
+cat updated-document.md | funcli documents update abc123
+
+# Update with tags from frontmatter
+funcli documents update abc123 document-with-tags.md
+```
+
+**Example with frontmatter:**
+
+```bash
+# updated-content.md
+---
+tags:
+  - version/2.0
+  - status/reviewed
+---
+
+# Updated API Documentation
+
+This document has been updated with new information...
+```
+
+```bash
+funcli documents update abc123 updated-content.md
+# Updates document abc123 and replaces tags with "version/2.0" and "status/reviewed"
+```
+
+**Notes:**
+- Creates a new version of the document (preserves history)
+- Updates the document's sync state for real-time collaboration
+- Tags from frontmatter replace existing tags
+- Does not change document title or hierarchy position
+
 #### Import documents from directory
 
 ```bash
@@ -358,6 +428,12 @@ echo "# My Notes\n\nSome content" | funcli documents create z2zK66AaEF --title "
 # Import an existing markdown file
 funcli documents create z2zK66AaEF README.md
 
+# Update an existing document
+funcli documents update abc123 updated-content.md
+
+# Update from stdin
+cat changes.md | funcli documents update abc123
+
 # Create a nested document hierarchy
 funcli documents create z2zK66AaEF parent.md
 # Note the NPI of the created document, then:

src/cli.js

@@ -225,6 +225,29 @@ documentsCommand
     }
   }));
 
+documentsCommand
+  .command("update <npi>")
+  .description("Update a document from markdown file or stdin")
+  .argument("[file]", "Markdown file (omit to read from stdin)")
+  .action(withClient(async (client, npi, file) => {
+    // Read content from file or stdin
+    let content;
+    if (file) {
+      content = fs.readFileSync(file, "utf8");
+    } else {
+      // Read from stdin
+      content = await readStdin();
+    }
+
+    // Update document
+    const document = await client.updateDocument(npi, {
+      markdown: content
+    });
+
+    console.log(chalk.green("✓") + " Document updated successfully!");
+    console.log(chalk.bold(document.title) + chalk.gray(` (${document.npi})`));
+  }));
+
 function printDocumentTree(documents, level) {
   const indent = "  ".repeat(level);
 

src/client.js

@@ -65,4 +65,13 @@ export class FundamentoClient {
     });
     return response.data;
   }
+
+  async updateDocument(npi, { markdown }) {
+    const response = await this.axios.patch(`/api/v1/documents/${npi}`, {
+      document: {
+        markdown
+      }
+    });
+    return response.data;
+  }
 }

test/client.test.js

@@ -98,3 +98,34 @@ test("FundamentoClient createSpace should format request correctly", () => {
   // Restore original post
   client.axios.post = originalPost;
 });
+
+test("FundamentoClient updateDocument should format request correctly", () => {
+  const config = new Config({ apiKey: "test-key" });
+  const client = new FundamentoClient(config);
+
+  // Mock axios patch
+  const originalPatch = client.axios.patch;
+  let capturedUrl, capturedData;
+
+  client.axios.patch = async (url, data) => {
+    capturedUrl = url;
+    capturedData = data;
+    return { data: { npi: "doc123", title: "Updated Document" } };
+  };
+
+  // Call updateDocument
+  client.updateDocument("doc123", {
+    markdown: "# Updated Content"
+  });
+
+  // Verify the request format
+  assert.strictEqual(capturedUrl, "/api/v1/documents/doc123");
+  assert.deepStrictEqual(capturedData, {
+    document: {
+      markdown: "# Updated Content"
+    }
+  });
+
+  // Restore original patch
+  client.axios.patch = originalPatch;
+});