v0.1.0 - initial release (#1)

Reviewed-on: #1

examples.md

@@ -10,6 +10,10 @@ Root directory manifest (`.wp-materialize.json`):
 {
   "categories": { "content": ["Systems", "Infrastructure"], "inherit": true },
   "tags": { "content": ["automation", "wordpress"], "inherit": true },
+  "author": { "content": ["editorial"], "inherit": true },
+  "renderer": "pandoc",
+  "hard_line_breaks": true,
+  "block_html": true,
   "subdirectories": { "content": ["design", "notes"], "inherit": true },
   "files": {
     "post.md": {
@@ -18,7 +22,12 @@ Root directory manifest (`.wp-materialize.json`):
       "tags": { "content": ["extra"], "inherit": true }
     },
     "essay.md": {
-      "use_heading_as_title": { "level": 1, "strict": true }
+      "use_heading_as_title": { "level": 1, "strict": true },
+      "renderer": "py-gfm",
+      "hard_line_breaks": false,
+      "block_html": false,
+      "created_on": "2025-01-10 09:30",
+      "last_modified": "2025-02-14 16:45"
     }
   }
 }
@@ -45,6 +54,9 @@ Subdirectory manifest (`design/.wp-materialize.json`):
 {
   "wordpress_root": "/var/www/wordpress",
   "repo_storage_dir": "/home/user/wp-materialize-repos",
+  "renderer": "default",
+  "hard_line_breaks": false,
+  "block_html": false,
   "git_repositories": [],
   "directories": [
     {
@@ -62,6 +74,9 @@ Subdirectory manifest (`design/.wp-materialize.json`):
 {
   "wordpress_root": "/var/www/wordpress",
   "repo_storage_dir": "/home/user/wp-materialize-repos",
+  "renderer": "default",
+  "hard_line_breaks": false,
+  "block_html": false,
   "git_repositories": [
     {
       "name": "content-repo",
@@ -92,6 +107,9 @@ Subdirectory manifest (`design/.wp-materialize.json`):
 {
   "wordpress_root": "/var/www/wordpress",
   "repo_storage_dir": "/home/user/wp-materialize-repos",
+  "renderer": "default",
+  "hard_line_breaks": false,
+  "block_html": false,
   "git_repositories": [
     {
       "name": "content-repo",
@@ -103,3 +121,39 @@ Subdirectory manifest (`design/.wp-materialize.json`):
   "directories": []
 }
 ```
+
+## Timestamp Behavior Example
+
+- `git_repositories` entries use git commit timestamps for `created_on`/`last_modified` inference.
+- `directories` entries use filesystem timestamps even if the path is inside a git repo.
+
+## Scaffold Command Examples
+
+Create a placeholder config:
+
+```bash
+wp-materialize new --config
+wp-materialize new --config /path/to/config.json
+```
+
+Create a dummy manifest:
+
+```bash
+wp-materialize new --manifest /path/to/content
+```
+
+Add a file to a manifest:
+
+```bash
+wp-materialize add-file /path/to/content/post.md
+wp-materialize add-file /path/to/content/post.md /path/to/content
+wp-materialize add-file /path/to/content/post.md --current
+```
+
+Add a directory to a manifest:
+
+```bash
+wp-materialize add-subdir /path/to/content/notes
+wp-materialize add-subdir /path/to/content/notes /path/to/content
+wp-materialize add-subdir /path/to/content/notes --current
+```