@forumulate/cli 0.8.0 → 0.9.0

package/README.md

@@ -145,6 +145,14 @@ forumulate publish ./docs --org acme --space docs --prune
 forumulate publish . --only getting-started,theme             # just these
 ```
 
+**1b. Sync a folder (content as code).** `forumulate sync <folder>` is the same engine as a plan by default: `--apply` writes it, `--diff` shows what changes inside each post or page, `--prune` removes what has no file. A `forumulate.yml` maps folders to spaces: blog posts, docs pages, FAQ questions (with `short-answer:` and `related:` slots), changelog releases and blog categories (`tags:` in the manifest or `_tags.yml`: label, colour, cover, icon, parent). Matched by slug, images uploaded once by content hash, `README`/`LICENSE`/`_drafts/`/dotfiles skipped — and a second run writes nothing. See [Content as code](https://forumulate.com/guides/content-as-code).
+
+```sh
+forumulate sync .                   # the plan
+forumulate sync . --diff            # the plan, with paragraph and field diffs
+forumulate sync . --apply --prune   # do it, read it back
+```
+
 **2. Publish one page by id.**
 
 ```sh